Amocrm Mcp

io.github.theYahia由 GitHub 账号 theYahia 发布v1.0.1更新于 Oct 24, 2026

MCP server for amoCRM API — leads, contacts, pipelines. Auth: Bearer token.

已验证STDIO仅桌面效率与工作流商业与电商

概览

AI 生成的概览

面向 amoCRM 的本地 MCP 服务器，让助手读取和管理 CRM 账户中的线索、联系人、公司、销售管道、任务、备注和事件。

可以做什么
搜索、列出并读取线索、联系人、公司，包括关联记录和丢单原因，并提供跨对象的通用搜索、事件流和账户信息（用户与设置）。创建和更新线索、联系人、公司，可在阶段间移动交易、修改预算或负责人。列出销售管道及其阶段。列出、创建和完成与交易、联系人或公司关联的任务，支持截止时间和结果文本。列出待处理的未分派请求并将其接收入管道，还可为任意实体添加多种类型的备注。
适用场景
适合在 MCP 客户端中用自然语言查询或更新 amoCRM 销售管道：查看某阶段的交易、一次性创建联系人、公司和交易，或在不打开 CRM 界面的情况下管理跟进任务。
运行要求
通过 npx 以 npm 包形式在 Node.js 上本地运行。需要 amoCRM 账户子域名和 OAuth 2.0 凭据：访问令牌，以及可选的刷新令牌、客户端 ID 和客户端密钥用于自动刷新令牌。需要访问 amoCRM API 的网络连接。
安装前请注意
需要 CRM 账户的 OAuth 凭据，包括客户端密钥和刷新令牌，请勿放入共享配置。服务器可创建和修改记录（线索、联系人、公司、任务、备注）并将未分派请求接收入管道，改动会影响真实 CRM 数据。README 说明仓库已归档、开发已迁往别处，但称 npm 包保持不变。

安装

在 SourceWeft 中

  1. 打开 控制台中的 Amocrm Mcp，将其添加到工作区。
  2. 为需要使用其工具的对话启用该服务。

Desktop only，通过 STDIO。 STDIO 服务会启动本地进程，因此需要 SourceWeft 桌面宿主。

其他 MCP 客户端

参照 仓库 中的启动说明。

README

🗄 Репозиторий заархивирован

Разработка переехала в theYahia/WWmcp — монорепозиторий MCP-серверов для незападных API: СНГ, MENA, Африка, LATAM, Юго-Восточная Азия. Общее ядро @theyahia/mcp-core, единый CI, единый релизный конвейер.

Актуальная версия того, что лежало здесь: servers/amocrm/

Пакет в npm прежний — @theyahia/amocrm-mcp, ставится и работает как раньше. Здесь больше ничего не обновляется. Задачи и pull request'ы — в WWmcp.

Archived — development moved to theYahia/WWmcp, a monorepo of MCP servers for non-Western APIs. The current version of this package now lives at servers/amocrm/. The npm package @theyahia/amocrm-mcp is unchanged. Please open issues and pull requests there.

amoCRM MCP — сделки, контакты и воронка продаж через нейросеть

Если вы искали, как подключить amoCRM к ИИ-ассистенту, спросить состояние воронки обычными словами, завести сделку или найти контакт не открывая интерфейс — это оно. 19 инструментов для amoCRM: сделки, контакты, компании, воронки, задачи, примечания, поиск, события и неразобранное. OAuth 2.0 с автообновлением токена, ограничение 7 запросов/сек и повтор с экспоненциальной задержкой.

Установка

bash
npx -y @theyahia/amocrm-mcp

Настройка MCP

Добавьте в конфигурацию Claude Desktop, Cursor или любого другого MCP-клиента:

json
{  "mcpServers": {    "amocrm": {      "command": "npx",      "args": ["-y", "@theyahia/amocrm-mcp"],      "env": {        "AMOCRM_SUBDOMAIN": "mycompany",        "AMOCRM_ACCESS_TOKEN": "your-access-token",        "AMOCRM_REFRESH_TOKEN": "your-refresh-token",        "AMOCRM_CLIENT_ID": "your-client-id",        "AMOCRM_CLIENT_SECRET": "your-client-secret"      }    }  }}

Переменные окружения

ПеременнаяОбяз.Описание
AMOCRM_SUBDOMAINдаПоддомен вашего amoCRM (например, mycompany из mycompany.amocrm.ru)
AMOCRM_ACCESS_TOKENдаOAuth access-токен
AMOCRM_REFRESH_TOKENнетOAuth refresh-токен (включает автообновление при 401)
AMOCRM_CLIENT_IDнетOAuth client ID (нужен для обновления токена)
AMOCRM_CLIENT_SECRETнетOAuth client secret (нужен для обновления токена)

AMOCRM_DOMAIN тоже принимается как алиас AMOCRM_SUBDOMAIN (обратная совместимость).

Инструменты (19)

Сделки

ИнструментОписание
list_leadsПоиск и список сделок с фильтрами (воронка, статусы, запрос). Подтягивает контакты и причины отказа.
get_leadОдна сделка по ID вместе со связанными контактами и элементами каталога.
create_leadСоздать сделку с названием, бюджетом, воронкой, статусом и пользовательскими полями.
update_leadОбновить поля сделки — перевести между этапами, изменить бюджет, сменить ответственного.

Контакты

ИнструментОписание
list_contactsПоиск контактов по имени, телефону, e-mail.
get_contactОдин контакт со всеми пользовательскими полями.
create_contactСоздать контакт с телефоном, e-mail и пользовательскими полями.

Компании

ИнструментОписание
list_companiesПоиск компаний. Подтягивает связанные сделки и контакты.
create_companyСоздать компанию с пользовательскими полями.

Воронки

ИнструментОписание
list_pipelinesВсе воронки продаж вместе с их статусами (этапами).

Задачи

ИнструментОписание
list_tasksСписок задач с фильтрами по сущности, выполненности и ответственному.
create_taskСоздать задачу, привязанную к сделке, контакту или компании, с дедлайном.
complete_taskОтметить задачу выполненной и добавить текст результата.

Неразобранное

ИнструментОписание
list_unsortedВходящие неразобранные заявки (формы, разбор почты).
accept_unsortedПринять неразобранную заявку в воронку.

Примечания

ИнструментОписание
add_noteДобавить примечание (common, call_in, call_out, service_message) к любой сущности.

Поиск

ИнструментОписание
searchУниверсальный поиск по сделкам, контактам и компаниям.

События

ИнструментОписание
list_eventsЛента событий — смены статусов, звонки, примечания, связи.

Аккаунт

ИнструментОписание
get_accountИнформация об аккаунте, пользователи, типы задач, настройки amojo.

Демо-промпты

Обзор продаж:

«Покажи все сделки в воронке „Продажи“, которые сейчас на этапе „Переговоры“. С контактами.»

Работа с задачами:

«Создай задачу-перезвон по сделке #12345, дедлайн завтра в 10:00. Потом выведи все мои невыполненные задачи.»

Заведение нового клиента:

«Создай контакт „Иван Петров“ с телефоном +79001234567, потом компанию „Петров Солюшнс“ и сделку „Разработка сайта“ на 150 000 рублей в основной воронке.»

Как настроить OAuth 2.0

  1. Откройте настройки аккаунта amoCRM: https://YOUR_SUBDOMAIN.amocrm.ru/settings/widgets/
  2. Создайте новую интеграцию (внешняя интеграция)
  3. Укажите redirect URI: https://YOUR_SUBDOMAIN.amocrm.ru
  4. Скопируйте Client ID и Client Secret
  5. Авторизуйте интеграцию, чтобы получить первичный код авторизации
  6. Обменяйте код на токены:
bash
curl -X POST https://YOUR_SUBDOMAIN.amocrm.ru/oauth2/access_token \  -H "Content-Type: application/json" \  -d '{    "client_id": "YOUR_CLIENT_ID",    "client_secret": "YOUR_CLIENT_SECRET",    "grant_type": "authorization_code",    "code": "YOUR_AUTH_CODE",    "redirect_uri": "https://YOUR_SUBDOMAIN.amocrm.ru"  }'
  1. Сохраните access_token и refresh_token из ответа
  2. Сервер сам обновит просроченный токен, если заданы AMOCRM_REFRESH_TOKEN, AMOCRM_CLIENT_ID и AMOCRM_CLIENT_SECRET

Обработка ошибок

  • 401 Unauthorized — автообновление токена, если настроены реквизиты для refresh, затем повтор запроса
  • 429 Rate Limited — учитывает заголовок Retry-After, ждёт и повторяет
  • 5xx — повтор с экспоненциальной задержкой (до 3 попыток)
  • Ограничение частоты — встроенная пауза 150 мс между запросами (~7 запросов/сек), чтобы укладываться в лимиты amoCRM

Разработка

bash
git clone https://github.com/theYahia/amocrm-mcp.gitcd amocrm-mcpnpm installnpm run buildnpm test

Лицензия

MIT

Telegram: @vhodvai

来源：README.md，提交 a969508

工具

0
SourceWeft 尚未在沙箱中启动过该软件包，因此其工具未知。

版本历史

1
  1. v1.0.1最新Sep 16, 2026

评分

已满足适用检查项的 50%

该评分衡量此收录条目的完整程度，依据注册中心条目、端点与公开来源计算得出。它不是对服务器本身的评价，也不表示服务器安全或当前可用：可连通性是带日期的检查结果，评分也不包含安装量或用户评价。

  • 近 30 天内可连通25 分

    请保持端点能够响应 MCP 握手；SourceWeft 每 30 天探测一次。

  • 已声明认证方式10 分

    请在注册中心条目中声明凭据请求头，或保持端点能够响应探测，以便判定其认证方式。

  • 已列出工具15 分

    请让服务器在无凭据时响应 tools/list，或发布可在沙箱中无凭据启动的软件包。

  • 描述必需15 分
  • 图标10 分
  • 文档15 分
  • 许可证10 分