メインコンテンツへスキップ
MCP サーバーはセルフホスト版の Kodus でのみ利用できます。ワークスペースのリポジトリ、Pull Request、Kody Issues、Kody Rules、メモリを、MCP クライアント向けのツールとして公開します。 Plugins から Kody に外部ツールを接続するには、MCP Manager を設定してください。

オンにする

Docker Compose インストーラーでは、このエンドポイントはデフォルトでオフです。kodus-installer ディレクトリの .env に次を追加します。
同じディレクトリで docker compose up -d --no-deps api を実行して環境変数を反映します。 Helm チャートではこのエンドポイントはデフォルトでオンです。オフにするには values ファイルで global.config.API_MCP_SERVER_ENABLED を "false" に設定し、helm upgrade を実行します。 オフの間、API は /mcp を提供しません。ルートは API ホストの POST /mcp なので、リバースプロキシで転送する必要があります。リバースプロキシを参照してください。

クライアントの接続

自分のインスタンスの API にある https://<your-api-host>/mcp に接続します。通信には Streamable HTTP を使用します。
  1. Organization → CLI keys を開き、キーを生成してコピーします。キーを生成できるのは組織のオーナーのみです。CLI キーを参照してください。
  2. ツールを呼び出すときに、次のいずれかのヘッダーでキーを送信するようクライアントを設定します。
接続を確認するには、kodus-api.example.com をお使いの API のホスト名に置き換え、ツールを一覧表示します。この検出リクエストにキーは不要です。
  • キーは 1 つのチームに属します。別のチームの teamId 引数は拒否され、teamId を省略するとキーから補完されます。
  • ほとんどのツールは organizationId 引数を取ります。これは自分の組織の ID である必要があります。それ以外の値は拒否されます。
  • initialize、tools/list、ping はキーなしで動作します。それ以外の呼び出しには有効なキーが必要で、キーがない、無効、または失効している場合は 401 が返されます。

ツール

リポジトリと Pull Request

Kody Issues

Kody Rules とメモリ

ルールとメモリの管理

KODUS_CREATE_KODY_RULE、KODUS_UPDATE_KODY_RULE、KODUS_DELETE_KODY_RULE、KODUS_CREATE_MEMORY には、キーの kodyRules:manage ケイパビリティが必要です。Organization → CLI keys で、キーの Configure をクリックし、Allow Kody Rules management via CLI をオンにします。オンにしていない場合、これらのツールは、キーに Kody Rules を管理する権限がないというエラー結果(isError: true)を返します。その他のツールにはケイパビリティは不要です。
  • サーバー経由で作成されたルールには MCP/Agent のオリジンが表示され、誰かが承認するまで Pending review で待機します。
  • メモリが待機するのは、Kody knowledge approval がオンの場合のみです。
  • 集中管理設定が有効な場合、ルールやメモリの作成、変更、削除は、代わりに設定リポジトリに Pull Request を作成します。

制限事項

  • サポートされるのは POST のみです。
  • ステートレスです。サーバーはリクエスト間でセッションを保持せず、Mcp-Session-Id も返しません。
  • POST へのレスポンス以外で、クライアントに何も送信しません。