@theyahia/amocrm-mcp

面向 amoCRM API 的生产级 MCP 服务器。19 个工具涵盖线索、联系人、公司、管道、任务、备注、搜索、事件和未分类线索。支持 OAuth 2.0 自动刷新令牌。速率限制（7 请求/秒）。采用指数退避重试。

安装

npx -y @theyahia/amocrm-mcp

Related MCP server: 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_DOMAIN 也可作为 AMOCRM_SUBDOMAIN 的别名（向后兼容）。

工具（19）

线索

联系人

公司

管道

任务

未分类线索

备注

搜索

事件

账户

演示提示

销售概览：

“显示‘Sales’管道中当前处于‘Negotiation’阶段的所有线索。包含联系人信息。”

任务管理：

“为线索 #12345 创建跟进电话任务，截止时间为明天上午 10:00。然后列出我所有未完成的任务。”

新客户引导：

“创建联系人‘Ivan Petrov’，电话 +79001234567；然后创建公司‘Petrov Solutions’和线索‘Website Development’，金额为 150,000 RUB，放入主管道。”

OAuth 2.0 设置指南

1. 转到你的 amoCRM 账户设置：https://YOUR_SUBDOMAIN.amocrm.ru/settings/widgets/

2. 创建一个新的集成（外部集成）

3. 将重定向 URI 设置为 https://YOUR_SUBDOMAIN.amocrm.ru

4. 复制客户端 ID和客户端密钥

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 未授权：如果配置了刷新凭据，则自动刷新令牌，然后重试。

• 429 请求过多：遵循 Retry-After 响应头，等待并重试。

• 5xx 服务器错误：指数退避重试（最多 3 次）。

• 速率限制：内置 150ms 请求间隔（约 7 请求/秒），以保持在 amoCRM 限制范围内。

开发

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

许可证

MIT