amocrm-mcp

🗄 存储库已归档

开发工作已迁移至 theYahia/WWmcp——一个面向非西方 API 的 MCP 服务单体存储库：独联体、MENA、非洲、LATAM、东南亚。采用通用核心 @theyahia/mcp-core、统一 CI 和统一发布流水线。

此处内容的当前版本：servers/amocrm/

npm 包保持不变——@theyahia/amocrm-mcp，安装和使用方式照旧。 此处不再更新。请在 WWmcp 中提交问题和 pull request。

**已归档——开发工作已迁移至 theYahia/WWmcp，**这是一个面向非西方 API 的 MCP 服务单体存储库。 此软件包的当前版本现位于 servers/amocrm/。 npm 包 @theyahia/amocrm-mcp 保持不变。 请在那里提交问题和 pull request。

amoCRM MCP——通过神经网络管理交易、联系人和销售漏斗

如果你想了解如何将 amoCRM 连接到 AI 助手、用日常语言询问销售漏斗状态、创建交易，或不打开界面就查找联系人，这就是你要找的工具。为 amoCRM 提供 19 个工具：交易、联系人、公司、销售漏斗、任务、备注、搜索、事件和未分类线索。支持 OAuth 2.0 和令牌自动刷新，并限制为每秒 7 个请求，超出时采用指数退避重试。

安装

npx -y @theyahia/amocrm-mcp

MCP 配置

将以下内容添加到 Claude Desktop、Cursor 或任何其他 MCP 客户端的配置中：

{
  "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.amocrm.ru 中的 mycompany）
AMOCRM_ACCESS_TOKEN	是	OAuth 访问令牌
AMOCRM_REFRESH_TOKEN	否	OAuth 刷新令牌（启用 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	按姓名、电话或电子邮件搜索联系人。
get_contact	获取一个联系人及其所有自定义字段。
create_contact	创建联系人并设置电话、电子邮件和自定义字段。

公司

工具	描述
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. Обменяйте код на токены:

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"
  }'

7. Сохраните access_token и refresh_token из ответа
8. Сервер сам обновит просроченный токен, если заданы AMOCRM_REFRESH_TOKEN, AMOCRM_CLIENT_ID и AMOCRM_CLIENT_SECRET

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

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

Разработка

git clone https://github.com/theYahia/amocrm-mcp.git
cd amocrm-mcp
npm install
npm run build
npm test

Лицензия

MIT

---

Telegram: @vhodvai