AI导哈

amoCRM API服务

为amoCRM（Kommo）API v4提供多功能的服务器工具，支持潜在客户、联系人、公司、任务、笔记、管道、关联、分析和自定义字段的管理。

  • by AntonTera
  • Python
  • 本地部署
  • 1 星标
  • 更新于
在 GitHub 查看 AntonTera/amocrm_mcp

使用说明

amoCRM MCP服务器

MCP服务器 amoCRM （Kommo）API v4。展示潜在客户、联系人、公司、任务、笔记、管道、关联、分析和自定义字段的工具。

建于 FastMCP。适用于Claude Desktop、Cursor和任何兼容MCP的客户端。

特性

  • 39个MCP工具 跨11个领域（潜在客户、联系人、公司、任务、笔记、管道、关联、帐户、批处理、未排序、分析）
  • OAuth 2.0 具有磁盘持久性的令牌刷新
  • 长寿命令牌模式 用于更简单的单帐户部署
  • 速率限制 --7个请求/秒，具有自动429退避和抖动功能
  • HAL+JSON规范化 --条状物 _links，变平 _embedded
  • 一致的响应信封 — {data, pagination} 或 {error, status_code, detail}
  • stdio、SSE和可流式传输的http 运输

快速开始

1.安装

pip install -e .

2.配置

复制 .env.example 到 .env 并填写您的amoCRM凭据：

cp .env.example .env

您至少需要：

  • AMO_SUBDOMAIN --您的amoCRM帐户子域
  • AMO_ACCESS_TOKEN --OAuth访问令牌

对于自动令牌刷新，还可以设置：

  • AMO_CLIENT_ID, AMO_CLIENT_SECRET, AMO_REFRESH_TOKEN

3.跑步

# stdio (default — for Claude Desktop, Cursor, etc.)
python -m amocrm_mcp

# SSE transport
AMO_TRANSPORT=sse AMO_PORT=8000 python -m amocrm_mcp

# Streamable HTTP transport
AMO_TRANSPORT=streamable-http AMO_PORT=8000 python -m amocrm_mcp

Claude桌面配置

添加 claude_desktop_config.json:

{
  "mcpServers": {
    "amocrm": {
      "command": "python",
      "args": ["-m", "amocrm_mcp"],
      "env": {
        "AMO_SUBDOMAIN": "your-subdomain",
        "AMO_ACCESS_TOKEN": "your-token"
      }
      }
    }
}

Vercel部署

当前生产部署 helloevospru:

  • MCP端点： https://amocrm-mcp-helloevospru.vercel.app/mcp
  • 健康检查： https://amocrm-mcp-helloevospru.vercel.app/healthz

此存储库是为最简单的多帐户操作模型设置的：

  • 一个Vercel项目=一个amoCRM帐户
  • 将amoCRM凭据存储在Vercel项目环境变量中
  • 将Codex连接到特定项目 /mcp 统一资源定位符

部署新的amoCRM帐户

  1. 从此存储库创建新的Vercel项目。
  2. 添加生产环境变量：
    • AMO_SUBDOMAIN=<your amoCRM subdomain>
    • AMO_ACCESS_TOKEN=<your long-lived token>
    • 离开 AMO_CLIENT_ID, AMO_CLIENT_SECRET，以及 AMO_REFRESH_TOKEN 如果使用长期令牌模式，则为空
  3. 部署到生产环境：
npx vercel link --project <new-project-name>
npx vercel env add AMO_SUBDOMAIN production --value <subdomain>
npx vercel env add AMO_ACCESS_TOKEN production --value <long-lived-token>
npx vercel deploy --prod -y
  1. 使用Codex中的项目URL：
[mcp_servers.amocrm_<account_name>]
url = "https://<your-project>.vercel.app/mcp"

推荐命名：

  • Vercel项目： amocrm-mcp-<account>
  • Codex服务器密钥： amocrm_<account>

工具

域 工具 描述
潜在客户 leads_list, leads_get, leads_search, leads_create, leads_create_complex, leads_update 完整的潜在客户生命周期
联系人 contacts_get, contacts_search, contacts_create, contacts_update 联系人管理
公司 companies_get, companies_search, companies_create, companies_update 公司管理层
任务 tasks_list, tasks_get, tasks_create, tasks_update CRM任务操作
备注 notes_list, notes_create 关于实体的说明
管道 pipelines_list, pipelines_get, pipelines_list_statuses 管道和状态信息
协会 associations_get_linked, associations_link_entities 实体关系
账户 account_get, account_list_users, account_list_custom_fields, account_create_custom_field, account_update_custom_field, account_delete_custom_field 帐户元数据和自定义字段管理
批次 batch_create_leads, batch_create_contacts, batch_update_leads 批量操作
分析 analytics_get_events, analytics_get_pipeline_analytics，+1 CRM分析
未分类 unsorted_list, unsorted_accept, unsorted_reject 未分类收件箱

获取amoCRM凭据

  1. 转到您的amoCRM帐户→ 设置 → 集成
  2. 创建新的集成（或使用现有集成）
  3. 复制 访问令牌, 客户端ID，以及 客户端密钥
  4. 您的子域是前面的部分 .amocrm.ru 在您的帐户URL中

许可证

麻省理工学院

相关 MCP