内容
# kommo-kiro-power — Kommo CRM 能力增强
<p align="center">
<img src="https://img.shields.io/badge/Kiro-%E5%8A%AB%E9%BA%A6-blue" alt="Kiro 能力" />
<img src="https://img.shields.io/badge/MCP-%E5%90%8C%E6%AD%A5-green" alt="MCP 兼容" />
<img src="https://img.shields.io/badge/Python-3.10%2B-yellow" alt="Python 3.10+" />
<img src="https://img.shields.io/badge/License-MIT-lightgrey" alt="MIT 许可证" />
</p>
通过 [模型上下文协议](https://modelcontextprotocol.io) 将 AI 代理连接到您的 **Kommo CRM**（前身为 amoCRM）。管理线索、联系人、渠道、任务、备注、标签和公司 — 所有这些都可以通过 [Kiro](https://kiro.dev) 或任何 MCP 兼容客户端的自然语言实现。
## 功能
| 类别 | 工具 |
|----------|-------|
| **线索** | 列出、获取、创建、更新、删除、移动阶段、批量更新 |
| **联系人** | 列出、获取、创建、更新 |
| **渠道** | 列出、创建、更新 |
| **阶段** | 列出、创建、更新 |
| **标签** | 列出、添加、删除（自动创建，如果需要） |
| **任务** | 创建、列出（带有逾期筛选） |
| **备注** | 添加备注到线索 |
| **聊天** | 列出模板、发送消息 |
| **公司** | 创建、列出 |
| **自定义字段** | 列出、创建（文本、选择、多选、日期等） |
| **高级** | 一次调用创建线索 + 联系人 + 公司 |
## 快速开始
### 作为 Kiro 能力安装
1. 打开 Kiro → 能力面板 → **添加自定义能力**
2. 选择 **从 GitHub 导入能力**
3. 粘贴：`https://github.com/depper-IA/kommo-kiro-power`
4. 激活后按照引导步骤进行
### 作为独立 MCP 安装
```bash
git clone https://github.com/depper-IA/kommo-kiro-power.git
cd kommo-kiro-power
pip install -e .
```
## 设置
### 1. 创建 Kommo 集成
1. 进入 Kommo → **设置** → **集成** → **创建集成**
2. 复制 **客户端 ID** 和 **客户端密钥**
3. 将 `http://localhost:8080/callback` 设置为 **重定向 URI**
### 2. 配置凭证
```bash
cp .env.example .env
# 使用您的 Kommo 集成详细信息编辑 .env
```
### 3. 身份验证（OAuth）
```bash
python scripts/oauth_setup.py
```
浏览器打开 → 登录到 Kommo → 授权 → 自动保存令牌。
### 4. 运行 MCP 服务器
```bash
python -m kommo_mcp
# 或
kommo-mcp
```
## 与 Kiro 一起使用
安装为能力后，当您在对话中提及“kommo”、“leads”、“pipeline”、“crm”或“contacts”等关键词时，服务器会自动激活。
```
"显示销售渠道中的所有线索"
"为来自 TechCorp 的 Maria 创建一个线索，电话号码为 +57 310 543 6281"
"将线索 12345 移至谈判阶段"
"列出所有逾期的任务"
```
## 与其他 MCP 客户端一起使用
添加到您的 `claude_desktop_config.json`、`opencode.json` 或等效文件中：
```json
{
"mcpServers": {
"kommo": {
"command": "python",
"args": ["-m", "kommo_mcp"]
}
}
}
```
## 架构
```
kommo-kiro-power/
├── POWER.md # Kiro 能力元数据 + 入门指南
├── mcp.json # Kiro 的 MCP 服务器配置
├── steering/ # 按需加载的工作流程指南
│ ├── leads-workflow.md
│ ├── pipeline-management.md
│ └── automation-patterns.md
├── kommo_mcp/ # Python MCP 服务器
│ ├── __main__.py # 入口点（stdio 传输）
│ ├── mcp_server.py # 服务器 + 工具注册
│ ├── kommo_client.py # HTTP 客户端（OAuth、重试、缓存）
│ └── tools/ # 工具定义 + 处理程序
│ ├── leads.py
│ ├── contacts.py
│ └── pipelines.py
├── scripts/
│ └── oauth_setup.py # 一次性 OAuth 身份验证
├── pyproject.toml # 包配置
└── requirements.txt
```
## 安全
- 从 `.env` 读取凭证 — 绝不硬编码
- `.env` 位于 `.gitignore` 中 — 绝不提交
- OAuth v4 带有自动令牌刷新
- 速率限制：最大 5 请求/秒
- 失败时的指数退避 + 抖动
- 管道/阶段/字段的响应缓存（10 分钟 TTL）
## 兼容性
- **Python**：3.10、3.11、3.12、3.13
- **MCP 客户端**：Kiro、Claude Desktop、OpenCode、Cursor、Codex
- **Kommo API**：v4
## 许可证
MIT
