FAQ
MCP-серверы

MCP для amoCRM: как подключить ИИ-агента к сделкам и контактам

Есть ли MCP-сервер у amoCRM, что умеет шаблон в MCP Hub Яндекса, какие открытые серверы лежат на GitHub, как подключить Claude или Cursor по долгосрочному токену и какие лимиты API учитывать.

· · 7 мин чтения
MCP для amoCRM: как подключить ИИ-агента к сделкам и контактам

Короткий ответ: своего сервера у amoCRM не нашли, но подключить можно

MCP-сервер — это программа-посредник: она переводит просьбу ИИ-агента («покажи сделки на этапе переговоров») в запрос к API системы и возвращает ответ. Подробнее — в материале что такое MCP-сервер.

На 3 октября 2026 в разделе для разработчиков на amocrm.ru мы не нашли ни MCP-сервера, ни упоминаний протокола. Там описан обычный API с авторизацией по OAuth 2.0. Зато есть три рабочих пути вокруг:

  1. Шаблон amoCRM в MCP Hub Яндекс AI Studio — готовый сервер от партнёра Yandex Cloud, для агентов, которых вы собираете в AI Studio.
  2. Открытые серверы на GitHub — небольшие проекты, которые ставятся на ваш компьютер и подключаются к Claude Desktop, Cursor и другим клиентам.
  3. Платный сервер от интегратора — доступ по запросу, под конкретный аккаунт.

Все три работают поверх одного и того же API amoCRM, поэтому ограничения у них общие. О них — ниже.

Шаблон amoCRM в MCP Hub Яндекса: что умеет и что просит

В документации Yandex AI Studio шаблон описан так: сервер позволяет агентам получать в CRM сведения о компаниях, лидах и контактах, создавать и редактировать данные, создавать заметки, просматривать пайплайны (воронки) и задачи. То есть это и чтение, и запись.

Для доступа агент передаёт серверу два заголовка:

  • токен доступа — в заголовке X-Auth-Token;
  • имя аккаунта — в заголовке X-Account-Name.

За токеном документация Яндекса отправляет к инструкции самой amoCRM. Сервер создаётся в интерфейсе AI Studio: раздел Agent Atelier, пункт «MCP-серверы», кнопка «Создать MCP-сервер», выбор шаблона. Адрес, транспорт и тип авторизации в шаблоне заданы заранее и не меняются. После подключения вы отмечаете, какие инструменты из шаблона попадут в сервер. Это удобный способ оставить агенту только чтение: инструменты записи просто не добавлять.

Из прав на стороне Яндекса понадобятся роль serverless.mcpGateways.invoker и, для серверов из шаблона, serverless.mcpGateways.anonymousInvoker. Остальное про хаб — в разборе MCP-серверов Яндекса.

Оговорка: шаблон обозначен как сервер «от внешних партнёров Yandex Cloud». Кто именно его разработал и поддерживает, на странице не сказано. Полного списка инструментов в документации тоже нет — он виден только в интерфейсе после подключения.

Открытые серверы на GitHub: что есть на 3 октября 2026

Поиск по GitHub выдаёт больше десятка репозиториев с названием вроде amocrm-mcp. У большинства ноль-две звезды и один автор. Ниже те, чьи README мы прочитали целиком.

РепозиторийЗвёздыПоследний коммитЛицензияИнструменты
grabarnick/amocrm-mcp-server12октябрь 2025не указана7: сделки, контакты, заметки, обмен кода OAuth
DocAtWork2026/amocrm-mcp425 февраля 2026MIT17: сделки, контакты, компании, задачи, воронки, пользователи, заметки
cAIborg-ai/amocrm-mcp219 февраля 2026MIT36, включая пакетное создание и «Неразобранное»
theYahia/amocrm-mcp0архив, код переехал в theYahia/WWmcp (32 звезды, папка servers/amocrm обновлялась 5 сентября 2026)MIT19: сделки, контакты, компании, воронки, задачи, поиск, события

Что из этого следует. Это не продукты с поддержкой, а личные проекты: ни у одного нет заметной аудитории, три из четырёх не обновлялись с февраля 2026 или дольше. У grabarnick/amocrm-mcp-server лицензии в репозитории нет — формально это значит, что права на использование кода автор не давал. Перед установкой прочитайте исходники: у DocAtWork2026/amocrm-mcp весь сервер — один файл server.py.

Сервер от theYahia — единственный, который ставится одной командой из npm, без клонирования:

npx -y @theyahia/amocrm-mcp

Отдельно есть платный вариант: интегратор api-master.ru предлагает удалённый сервер с готовой аналитикой (дубли, эффективность менеджеров, источники продаж). Доступ выдают по запросу, цен на странице нет.

Как подключить Claude или Cursor к amoCRM

Порядок такой: получить токен в amoCRM, поставить сервер, прописать его в конфигурации клиента.

Токен. С февраля 2024 года amoCRM выдаёт долгосрочные токены для внешних и приватных интеграций. По документации: в разделе «амоМаркет» создаёте интеграцию (нужны права администратора), на вкладке «Ключи» нажимаете «Сгенерировать токен» и выбираете срок — от 1 дня до 5 лет. Токен показывается один раз. Обновлять его не нужно, отозвать можно кнопкой «Отозвать доступ».

ОсторожноВ документации amoCRM сказано: при подключении приватной интеграции на аккаунте, который не является техническим, клиент заполняет заявление на отказ от технической поддержки по ошибкам системы, и отозвать его потом нельзя. Уточните у поддержки amoCRM, касается ли это вашего случая, до создания интеграции.

Конфигурация. Для сервера DocAtWork2026/amocrm-mcp установка из README:

git clone https://github.com/DocAtWork2026/amocrm-mcp.git
cd amocrm-mcp
pip install -r requirements.txt

Затем в файл claude_desktop_config.json (на macOS он лежит в ~/Library/Application Support/Claude/) добавляется блок:

{
  "mcpServers": {
    "amocrm": {
      "command": "python",
      "args": ["C:/path/to/amocrm-mcp/server.py"],
      "env": {
        "AMOCRM_DOMAIN": "your_subdomain",
        "AMOCRM_TOKEN": "your_long_lived_token"
      }
    }
  }
}

AMOCRM_DOMAIN — это поддомен аккаунта: для https://mycompany.amocrm.ru значение будет mycompany. Путь в args замените на свой. Нужен Python 3.10 или новее.

Для сервера из npm блок другой — команда npx и переменные AMOCRM_SUBDOMAIN и AMOCRM_ACCESS_TOKEN; три переменные с refresh-токеном и ключами интеграции необязательны и нужны только для автообновления обычного OAuth-токена. В Cursor и Claude Code тот же блок кладётся в их собственные файлы настроек — где именно, расписано в общей инструкции по подключению MCP.

Проверка: попросите агента показать список воронок и сделку, которую вы знаете наизусть, и сверьте с интерфейсом.

Ограничения: лимиты API и доступ ко всей базе клиентов

Лимиты запросов. По документации amoCRM — не более 7 запросов в секунду на одну интеграцию и до 50 на весь аккаунт. При превышении API отвечает кодом 429, при многократных нарушениях аккаунт блокируется и на любой запрос приходит 403. Отдельно сказано, что доступ могут закрыть за «бесконтрольный перебор всех данных» — а агент, которому задали широкий вопрос, склонен листать всё подряд. За один запрос отдаётся не более 250 сущностей в большинстве методов.

Подписка. После окончания оплаты запросы на запись блокируются сразу (код 402), чтение — через 30 дней.

Права токена. Это главное. Подключая сервер, вы даёте агенту доступ к базе клиентов: имена, телефоны, почта, суммы сделок, переписка в заметках. Тонко ограничить токен средствами amoCRM не получится: почти все методы API входят в одно разрешение «Данные аккаунта», а доступ, выданный администратором, документация называет полным. Что можно сделать:

  • при создании интеграции не отмечать разрешения, которые не нужны, — доступ к файлам, удаление файлов, центр уведомлений;
  • выбрать короткий срок токена, а не пять лет;
  • оставить агенту только инструменты чтения — в хабе Яндекса их выбирают при создании сервера, а в README открытых серверов такого переключателя мы не нашли;
  • хранить токен в переменной окружения, а не в файле, который попадает в репозиторий.

Данные из CRM при этом уходят в модель, с которой работает агент. Если она облачная — персональные данные клиентов уходят наружу. Разбор рисков — в материале про безопасность MCP.

Если вы выбираете между CRM, посмотрите соседний случай: MCP для Битрикс24 и обзор того, что можно связать с ИИ-агентом в Битрикс24.

Частые вопросы

Есть ли MCP для amoCRM?

Да, но не от самой amoCRM. На 3 октября 2026 есть шаблон в MCP Hub Яндекс AI Studio, несколько открытых серверов на GitHub и платный сервер от интегратора. Официального сервера на сайте amoCRM мы не нашли.

Как подключить Claude к amoCRM?

Создать в amoCRM интеграцию и долгосрочный токен, установить один из открытых серверов и добавить его в claude_desktop_config.json с поддоменом аккаунта и токеном, затем перезапустить Claude Desktop.

Сможет ли агент что-то испортить в CRM?

Сможет, если у сервера есть инструменты записи: создать лишние сделки, изменить этап или бюджет. В списках инструментов из README, которые мы прочитали, удаления сделок и контактов нет, но лишние записи и неверные правки тоже приходится разбирать руками. На время проверки оставьте только чтение.

Источники

ИИ-агент в CRM

Подключим ИИ-агента к вашей CRM

Агент отвечает на вопросы по сделкам, разбирает входящие заявки, готовит документы и следит за тем, что подвисло. Права выдаём точечно, а не администраторские.

  • Битрикс24, amoCRM, связка с 1С
  • Локальное приложение с ограниченным scope
  • Начинаем со сценария на чтение
🛡️ Официальный договор и NDA 💼 Данные в вашем контуре ⚡ Пилот 5–7 дней

Бесплатная консультация и смета

Расскажите задачу — предложу архитектуру и оценю сроки. Отвечает Степан Ноянов.

Или напишите сразу напрямую в Telegram: @noystem ↗

Теги: MCPamoCRMCRMпродажиИИ-агент

Вам также может быть интересно