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 分