Kommo CRM

kommo-kiro-power — Kiro 向け Kommo CRM Power

Model Context Protocol を使用して、AI エージェントを Kommo CRM（旧 amoCRM）に接続します。リード、連絡先、パイプライン、タスク、メモ、タグ、会社を、Kiro または MCP 互換クライアントから自然言語で管理できます。

機能

カテゴリ	ツール
リード	一覧表示、取得、作成、更新、削除、ステージ移動、一括更新
連絡先	一覧表示、取得、作成、更新
パイプライン	一覧表示、作成、更新
ステージ	一覧表示、作成、更新
タグ	一覧表示、追加、削除（必要に応じて自動作成）
タスク	作成、一覧表示（期限超過フィルター付き）
メモ	リードにメモを追加
チャット	テンプレート一覧表示、メッセージ送信
会社	作成、一覧表示
カスタムフィールド	一覧表示、作成（テキスト、選択、複数選択、日付など）
高度な操作	1 回の呼び出しでリード、連絡先、会社を作成

クイックスタート

Kiro Power としてインストール

1. Kiro → Powers パネル → カスタム Power を追加
2. GitHub から Power をインポートを選択
3. 次を貼り付けます：https://github.com/depper-IA/kommo-kiro-power
4. 有効化した後、オンボーディング手順に従います

スタンドアロン MCP としてインストール

PyPI および公式 MCP Registry で公開されています。uv がインストール済みであれば、リポジトリのクローンは不要です。

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

または、ワンクリックでインストールできる MCPB バンドル（kommo-crm.mcpb）を Claude Desktop または MCPB 互換クライアントにインストールします。バンドルのソースは 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 → 設定 → インテグレーション → インテグレーションを作成に移動します
2. Client ID と Client Secret をコピーします
3. Redirect URI に http://localhost:8080/callback を設定します

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 を使用し、トークンを自動更新します
• レート制限：最大 1 秒あたり 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をご覧ください。

サポート

• バグや機能のリクエスト：GitHub Issues
• メール：[email protected]

ライセンス

MIT