使用说明
amoCRM MCP服务器
MCP服务器 amoCRM （Kommo）API v4。展示36个工具，用于潜在客户、联系人、公司、任务、笔记、管道、关联、分析等。
建于 FastMCP。适用于Claude Desktop、Cursor和任何兼容MCP的客户端。
特性
- 36个MCP工具 跨11个领域（潜在客户、联系人、公司、任务、笔记、管道、关联、帐户、批处理、未排序、分析）
- OAuth 2.0 具有磁盘持久性的令牌刷新
- 速率限制 --7个请求/秒，具有自动429退避和抖动功能
- HAL+JSON规范化 --条状物
_links，变平_embedded - 一致的响应信封 —
{data, pagination}或{error, status_code, detail} - stdio和SSE 运输
快速开始
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
Claude桌面配置
增添 claude_desktop_config.json:
{
"mcpServers": {
"amocrm": {
"command": "python",
"args": ["-m", "amocrm_mcp"],
"env": {
"AMO_SUBDOMAIN": "your-subdomain",
"AMO_ACCESS_TOKEN": "your-token"
}
}
}
}
工具
| 域 | 工具 | 描述 |
|---|---|---|
| 潜在客户 | 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 |
帐户元数据 |
| 批次 | 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凭据
- 转到您的amoCRM帐户→ 设置 → 集成
- 创建新的集成（或使用现有集成）
- 复制 访问令牌, 客户端ID，以及 客户端密钥
- 您的子域是前面的部分
.amocrm.ru在您的帐户URL中
许可证
麻省理工学院
