Kommo CRM

kommo-kiro-power — Kiro 的 Kommo CRM Power

使用 Model Context Protocol，将 AI Agent 连接到你的 Kommo CRM（原 amoCRM）。在 Kiro 或任何兼容 MCP 的客户端中，通过自然语言管理潜在客户、联系人、销售管道、任务、备注、标签和公司。

功能

类别	工具
潜在客户	列出、获取、创建、更新、删除、移动阶段、批量更新
联系人	列出、获取、创建、更新
销售管道	列出、创建、更新
阶段	列出、创建、更新
标签	列出、添加、移除（如有需要则自动创建）
任务	创建、列出（支持筛选逾期任务）
备注	为潜在客户添加备注
聊天	列出模板、发送消息
公司	创建、列出
自定义字段	列出、创建（文本、单选、多选、日期等）
高级	一次调用即可创建潜在客户、联系人和公司

快速开始

安装为 Kiro Power

1. 打开 Kiro → Powers 面板 → Add Custom Power
2. 选择 Import power from GitHub
3. 粘贴：https://github.com/depper-IA/kommo-kiro-power
4. 激活后按照引导步骤操作

安装为独立 MCP

已发布到 PyPI 和官方 MCP 注册表。安装 uv 后，无需克隆：

uvx --from kommo-kiro-power kommo-mcp

也可以在 Claude Desktop 或任何兼容 MCPB 的客户端中安装一键式 MCPB bundle（kommo-crm.mcpb）。Bundle 源文件位于 mcpb/。更改工具后，运行 python scripts/build_mcpb.py 同步清单，然后运行 pnpm dlx @anthropic-ai/mcpb pack mcpb kommo-crm.mcpb。对于 Smithery，运行 python scripts/build_mcpb.py --smithery kommo-crm-smithery.mcpb，即可构建一个同时包含每个工具 inputSchema 的变体。

或者从源代码安装：

git clone https://github.com/depper-IA/kommo-kiro-power.git
cd kommo-kiro-power
pip install -e .

设置

1. 创建 Kommo 集成

1. 前往 Kommo → Settings → Integrations → Create integration
2. 复制 Client ID 和 Client Secret
3. 将 http://localhost:8080/callback 设为 Redirect URI

2. 配置凭据

cp .env.example .env
# Edit .env with your Kommo integration details

3. 进行身份验证（OAuth）

python scripts/oauth_setup.py

浏览器会打开 → 登录 Kommo → 授权 → 自动保存令牌。

4. 运行 MCP 服务

python -m kommo_mcp
# or
kommo-mcp

在 Kiro 中使用

安装为 Power 后，在对话中提及“kommo”“leads”“pipeline”“crm”或“contacts”等关键词，服务便会自动激活。

"Show me all leads in the Sales pipeline"
"Create a lead for Maria from TechCorp with phone +57 310 543 6281"
"Move lead 12345 to the Negotiation stage"
"List all overdue tasks"

在其他 MCP 客户端中使用

将以下内容添加到你的 claude_desktop_config.json、opencode.json 或等效配置文件中：

{
  "mcpServers": {
    "kommo": {
      "command": "uvx",
      "args": ["--from", "kommo-kiro-power", "kommo-mcp"],
      "env": {
        "KOMMO_SUBDOMAIN": "your_subdomain",
        "KOMMO_ACCESS_TOKEN": "your_access_token"
      }
    }
  }
}

架构

kommo-kiro-power/
├── plugin.json           # Kiro Power manifest (Agent Plugins format)
├── POWER.md              # Legacy Kiro Power metadata + onboarding
├── mcp.json              # MCP server config for Kiro
├── server.json           # Official MCP Registry metadata
├── skills/               # Workflow guides loaded on-demand
│   ├── leads-workflow/SKILL.md
│   ├── pipeline-management/SKILL.md
│   └── automation-patterns/SKILL.md
├── kommo_mcp/            # Python MCP server
│   ├── __main__.py       # Entry point (stdio transport)
│   ├── mcp_server.py     # Server + tool registration
│   ├── kommo_client.py   # HTTP client (OAuth, retry, cache)
│   └── tools/            # Tool definitions + handlers
│       ├── leads.py
│       ├── contacts.py
│       └── pipelines.py
├── scripts/
│   └── oauth_setup.py    # One-time OAuth authentication
├── pyproject.toml        # Package config
└── requirements.txt

安全性

• 从 .env 读取凭据，绝不硬编码
• .env 已添加到 .gitignore，绝不提交
• 使用 OAuth v4 并自动刷新令牌
• 速率限制：每秒最多 5 个请求
• 失败时使用带抖动的指数退避
• 缓存销售管道、阶段和字段的响应（TTL 为 10 分钟）

兼容性

• Python：3.10、3.11、3.12、3.13
• MCP 客户端：Kiro、Claude Desktop、OpenCode、Cursor、Codex
• Kommo API：v4

隐私

此服务在你的计算机上本地运行，只与您自己的 Kommo 账户 API 通信。它不会收集遥测数据，也不会向作者或任何第三方发送数据。请参阅 PRIVACY.md。

支持

• Bug 和功能请求：GitHub Issues
• 电子邮件：[email protected]

许可证

MIT