使用说明
amoCRM MCP服务器
MCP(模型上下文协议)服务器,用于amoCRM与Claude Desktop和其他AI助手的集成。
特性
- 潜在客户 --列表、获取、创建、更新
- 联系人 --列表、获取、创建
- 公司 --列表、获取、创建
- 任务 --列表,创建
- 管道 --列出管道和阶段
- 用户 --列出帐户用户
- 备注 --添加和阅读任何实体的注释
- 账户 --获取帐户信息
先决条件
- Python 3.10+
- 具有API访问权限的amoCRM帐户
- amoCRM集成设置中的长期令牌
安装
git clone https://github.com/DocAtWork2026/amocrm-mcp.git
cd amocrm-mcp
pip install -r requirements.txt
配置
- 复制
.env.example到.env并填写您的凭据:
cp .env.example .env
AMOCRM_DOMAIN=your_subdomain
AMOCRM_TOKEN=your_long_lived_token
AMOCRM_DOMAIN--您的amoCRM子域名(例如,如果您的URL是https://mycompany.amocrm.ru,域是mycompany)AMOCRM_TOKEN--来自您的amoCRM集成设置的长期API令牌
获取令牌
- 转到amoCRM设置->amoMarket
- 点击三点菜单->创建集成
- 选择“外部集成”,设置名称和重定向URI(
https://localhost) - 保存,然后安装集成
- 打开集成->“密钥和访问”选项卡
- 点击“长期代币”下的“生成代币”
- 复制令牌
Claude桌面设置
将此添加到您的 claude_desktop_config.json:
macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
窗户: %APPDATA%\Claude\claude_desktop_config.json
{
"mcpServers": {
"amocrm": {
"command": "python",
"args": ["C:/path/to/amocrm-mcp/server.py"],
"env": {
"AMOCRM_DOMAIN": "your_subdomain",
"AMOCRM_TOKEN": "your_long_lived_token"
}
}
}
}
更新配置后重新启动Claude Desktop。
可用工具
| 工具 | 说明 |
|---|---|
get_account_info |
获取amoCRM帐户信息 |
get_leads |
列出潜在客户(带搜索功能) |
get_lead |
按ID获取潜在客户详细信息 |
create_lead |
创建新的潜在客户 |
update_lead |
更新现有潜在客户 |
get_contacts |
列出联系人(带搜索功能) |
get_contact |
按ID获取联系方式 |
create_contact |
创建新联系人 |
get_companies |
列出公司(带搜索) |
get_company |
按ID获取公司详细信息 |
create_company |
创建新公司 |
get_tasks |
列出任务 |
create_task |
创建新任务 |
get_pipelines |
列出管道和阶段 |
get_users |
列出帐户用户 |
add_note |
向实体添加注释 |
get_notes |
获取实体的注释 |
许可证
麻省理工学院