Идея простая: открыть Claude или ChatGPT и спросить «как дела с продажами в июле», «кто из клиентов давно не выходил на связь», «что не так с обработкой заявок» — и получить ответ по своим данным из amoCRM. Без выгрузок в Excel и без сборки дашборда.
Первое, что находят по запросу «amoCRM API», — документация для разработчиков. Из неё складывается впечатление, что задача сводится к паре запросов. На деле развилка тут проходит раньше: либо вы пишете собственную интеграцию поверх amoCRM API, либо подключаете готовый MCP-сервер по подписке.
MCP — открытый протокол, по которому ИИ-приложения подключают внешние источники данных. Именно он превращает amoCRM API в то, чем ассистент умеет пользоваться.
Разберу оба пути по-честному: что придётся сделать в первом случае и за что вы платите во втором.
Почему одного amoCRM API мало: при чём тут MCP
Сам по себе amoCRM API — это набор HTTP-эндпоинтов. Ассистент не знает ни про них, ни про то, какой запрос отправить и что делать с ответом. Нужен посредник: сходить в amoCRM за данными и вернуть их в формате, понятном модели.
MCP как раз описывает этот контракт. Сервер объявляет набор инструментов — например «дай статистику продаж за период», — а ассистент вызывает их, когда решает, что для ответа нужны цифры. Протокол поддерживают Claude, ChatGPT, Cursor и другие клиенты, так что один сервер работает со всеми.
Спецификация и SDK лежат в открытом доступе:
- modelcontextprotocol.io — спецификация протокола;
- github.com/modelcontextprotocol/servers — референсные серверы, полезно посмотреть, как устроен код;
- SDK для Python и TypeScript.
Написать «hello world»-сервер по этим SDK можно за вечер. Проблема не в протоколе.
Путь 1. Своя интеграция на amoCRM API
Здесь вы получаете полный контроль: любые инструменты, любая логика, данные никуда не уходят. Дальше — из чего складывается работа.
Авторизация в amoCRM API: OAuth и токены
amoCRM использует OAuth 2.0. Нужно зарегистрировать интеграцию, получить пару ключей, провести пользователя через окно доступа, обменять код на токены. Access-токен живёт сутки, refresh-токен — три месяца, и обновлять их надо самому. Пропустили окно — интеграция отвалилась, и пользователю придётся заново проходить авторизацию.
Всё описано в документации amoCRM по OAuth. Работы примерно на день, плюс хранилище для токенов и логика обновления по расписанию.
Что отдаёт amoCRM API — и чего в нём нет
API-справочник amoCRM — большой документ. Чтобы отвечать на вопросы про продажи, придётся разобраться с сущностями сделок, контактов, компаний, задач, событий, звонков, воронок и этапов, пользовательских полей и тегов.
И почти сразу вы упрётесь в детали, которых в документации нет:
- Пагинация и лимиты. API отдаёт данные страницами и ограничивает частоту запросов. Собрать статистику за квартал — это десятки, иногда сотни запросов с ретраями и бэкоффом.
- Пользовательские поля. У каждого аккаунта свой набор: «Бюджет», «Источник», «Дата отгрузки» приходят как поля с числовыми идентификаторами. Их надо сопоставлять с человеческими названиями, и в каждом аккаунте — заново.
- История этапов. Чтобы посчитать время в этапе или цикл сделки, нужны события перехода. Это отдельная сущность со своей логикой выборки.
- Переписки. Чтения чатов в публичном API amoCRM нет вообще. Если хотите, чтобы ассистент читал диалоги с клиентами и давал советы по ним, — этот путь закрыт.
Методология: где ломается большинство самописных решений
Данные вы достанете. Дальше начинается то, что отличает рабочий отчёт от красивого:
- Конверсия. Если считать её как «выиграно ÷ закрыто за период», цифра будет скакать без связи с работой отдела. Честный вариант — по когорте лидов, созданных в периоде, с пометкой, что свежие когорты ещё дозреют.
- Цикл сделки. Среднее арифметическое ломают старые хвосты: одна сделка, висевшая год, сдвинет весь показатель. Нужна медиана.
- Скорость ответа. Без учёта рабочих часов лид, пришедший в пятницу вечером и обработанный в понедельник утром, выглядит как двое суток простоя.
- Причины отказа. Спам и нецелевые обращения надо отсеивать, иначе процент отказов не сравнить между месяцами.
Каждый пункт — это разговор с руководителем отдела, а не строчка кода. И к нему вы вернётесь ещё не раз, когда цифры в отчёте разойдутся с ощущениями.
Отдельная засада: размер ответа
Наивный сервер отдаёт ассистенту сырые данные — тысячу сделок в JSON. Модель захлебнётся: контекст переполнится, ответ придёт медленно и дорого, а на второй вопрос в том же диалоге места уже не останется.
Правильно — считать агрегаты на своей стороне и возвращать компактный результат. Это переписывание всей логики инструментов после того, как первая версия уже заработала.
Эксплуатация
Сервер надо где-то держать, мониторить и обновлять. amoCRM меняет API, MCP развивается, клиенты выпускают новые версии. Плюс безопасность: у вас на руках токены доступа к клиентской базе.
Сколько это в деньгах. Нам на разработку хватило нескольких недель — но мы работаем с amoCRM с 2014 года и не выясняли по ходу дела, как она устроена. Команде, которая знакомится с системой по документации, до версии, которой доверяют цифры, идти несколько месяцев. Даже по нижней границе рынка это сотни тысяч рублей — и дальше расходы не заканчиваются, потому что сопровождать сервер придётся постоянно.
Когда свой сервер оправдан
Такое бывает, и мы честно скажем об этом на консультации:
- у вас есть штатная разработка, и внутренние сервисы вы и так пишете сами;
- слова «сервер», «деплой», «скрипт», «переменные окружения» вас не пугают — вы сами поднимете виртуалку, положите туда код и разберётесь по логам, почему он упал ночью;
- служба безопасности требует, чтобы данные не покидали контур;
- нужна логика, завязанная на ваши внутренние системы: склад, производство, 1С.
Если ни один пункт не про вас — переходите к следующему разделу.
Путь 2. Готовый MCP-сервер для amoCRM по подписке
Мы прошли путь из первого раздела до конца и упаковали результат в виджет для amoCRM. Подключение выглядит так:
- Установить виджет amoBridge в своём аккаунте amoCRM. Доступ только на чтение: виджет ничего не меняет и не удаляет.
- Скопировать строку подключения, которую показывает виджет, и вставить её в настройки Claude, ChatGPT или Cursor. Три клика.
- Задать вопрос человеческим языком.
С этого момента ассистенту доступны 22 инструмента: статистика продаж, когортная конверсия, срез воронки, зависшие сделки, скорость ответа по рабочим часам, звонки, причины отказа, время в этапе и другие. Методология уже внутри — медиана вместо среднего, когорты по дате создания, отсев мусорных причин.
Советы по работе с клиентами
Четыре инструмента делают то, чего публичный API amoCRM не умеет, и именно они дают ассистенту материал для советов, а не только для цифр:
get_chat— полный текст переписки по сделке из WhatsApp или Telegram, с разметкой, где клиент, где менеджер, а где робот. Ассистент читает диалог и говорит, где менеджер потерял клиента.stale_customers— клиенты без реального касания, с учётом и звонков, и переписок. Готовый список, кому позвонить на этой неделе.repeat_customers— повторные покупатели с фильтрацией по вашим полям.response_time_statsс рабочими часами — честная скорость реакции без выходных в знаменателе.
Пример вопроса, который отрабатывает целиком:
Отчёты можно отправлять прямо в рабочие чаты — в Telegram и MAX. Как развести сводку по продажам и по производству в разные чаты, разобрал в отдельной статье.
Стоимость — 1 990 ₽ в месяц за аккаунт amoCRM, без ограничений по числу вопросов. Расписание отчётов настраивается в вашем ИИ-приложении и отдельно не оплачивается.
amoCRM API или готовый MCP-сервер: сводная таблица
| Своя интеграция на amoCRM API | Готовый MCP-сервер amoBridge | |
|---|---|---|
| Время до первого отчёта | Месяцы | Вечер |
| Стоимость старта | Сотни тысяч ₽ на разработку | 0 ₽ |
| Стоимость владения | Зарплата разработчика | 1 990 ₽/мес за аккаунт |
| Методология метрик | Разрабатываете сами | Внутри: когорты, медиана, рабочие часы |
| Чтение переписок | Недоступно через публичное API | get_chat |
| Экономия контекста | Оптимизируете сами | Готовые агрегаты |
| Обновления при изменении API | На вас | На нас |
| Хостинг и мониторинг | На вас | Не нужны |
| Данные в своём контуре | Да | Нет, мы транспорт и ничего не храним |
| Кастомная логика под 1С и склад | Любая | Только готовые инструменты |
Что выбрать предпринимателю
Если у вас нет отдела разработки, ответ известен заранее. Посчитайте не деньги, а своё время.
Свой сервер — это найти подрядчика, написать техзадание, принять работу, разобраться, почему конверсия в отчёте не сходится с ощущениями, и вернуться к подрядчику. Через полгода у вас будет инструмент, который считает то же самое, что готовый, — и который надо продолжать содержать.
Собственный MCP-сервер имеет смысл, когда он даёт вам преимущество перед конкурентами. Отчёт по продажам преимущества не даёт: он даёт понимание, что происходит в отделе. А это понимание нужно вам в понедельник, а не в феврале.
Мы не против самостоятельной разработки — сами через неё прошли. Просто разработка окупается там, где вы делаете что-то своё. Транспорт между amoCRM и ассистентом своим не бывает: он либо работает, либо нет.
Итог
Оба пути ведут к одному результату: вы спрашиваете про продажи словами и получаете ответ по своим данным. Разница — в том, кто тратит месяцы на дорогу.
Свой сервер берите, если данные не должны покидать контур или нужна логика под ваши внутренние системы. Во всех остальных случаях подписка закрывает задачу за вечер.
Подключить amoBridge можно прямо сейчас: первые два месяца бесплатно, дальше 1 990 ₽ в месяц. Доступ только для чтения через официальный виджет amoCRM.