オンにする
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 を使用します。
- Organization → CLI keys を開き、キーを生成してコピーします。キーを生成できるのは組織のオーナーのみです。CLI キーを参照してください。
- ツールを呼び出すときに、次のいずれかのヘッダーでキーを送信するようクライアントを設定します。
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へのレスポンス以外で、クライアントに何も送信しません。