MCP サーバーを使う

このガイドでは、外部の MCP クライアント — Claude Code、エディター、MCP Inspector — を Control Center 自身のツールサーバーに接続する方法を説明します。

Control Center は 110 個のツールを登録し、プロトコルバージョン 2024-11-05 の Model Context Protocol でそれらを提供します。期待されるかもしれないツールファミリーが丸ごと存在しません。ミーティングやカレンダーのツールはなく、プロジェクトのツールもありません。

エンドポイントを見つける

MCP サーフェスはメインの cc_server リスナーを共有します。MCP 専用のポートはありません。

エンドポイント	メソッド	用途
`/mcp`	`POST`	Streamable HTTP トランスポート — クライアントが話すのはこれです
`/mcp`	`DELETE`	セッションを終了する
`/sse`	`GET`	サーバー送信の通知ストリーム

したがって、既定のローカルインストールでは http://127.0.0.1:9030/mcp になります。

設定 → サーバー → MCP サーバーに移動します
MCP サーバーカードを確認します — 実行中か停止済みか、およびリッスンしているポートが表示されます

新規インストールではこのサーフェスは既定で有効なので、ループバックのクライアントは設定を触ることなく動作します。アプリ起動時に開始は再起動後に再び起動するかどうかを制御します。開始 / 停止はセッションのコントロールであり、この設定を変更しません。

サーバーは既定でループバックにバインドするため、--bind any を付けて起動しない限り、エンドポイントに到達できるのは cc_server が動作しているマシンからのみです。

クライアントを接続する

クライアントを Streamable HTTP エンドポイントに向けます。設定の正確な形はお使いのクライアント次第ですが、URL はどちらでも同じです。

{
  "mcpServers": {
    "control-center": {
      "type": "http",
      "url": "http://127.0.0.1:9030/mcp"
    }
  }
}

Claude Code

Claude Code はプロジェクトの .mcp.json からこれを読み込みません — プロジェクトスコープの MCP サーバーは承認プロンプトの背後にゲートされており、非対話の claude -p はそれに決して回答しません。設定を明示的に渡してください:

claude --mcp-config /path/to/mcp.json --strict-mcp-config

--strict-mcp-config は Claude にそのファイルだけを使わせるので、同じサーバーがプロジェクトからも検出されて二重に登録されることはありません。

チェックポイント: クライアントにツールを一覧表示させます。チケット、スペース、メモリ、コードグラフ、レビューをカバーする mcp__* のエントリが表示されるはずです。

ホストの外に MCP を公開する

設定 → サーバー → MCP サーバーで、認証トークンの行にある設定を押し、トークンを貼り付けます
すべての POST /mcp リクエストで Authorization: Bearer <token> として送信します

トークンのないサーフェスは、ループバック以外の呼び出し元をすべて 403 で拒否します。これは設計上フェイルクローズです。トークンがあってこそ、ホスト外へのサービス提供がそもそも可能になります。

トークンの変更は実行中のサーフェスに即座に反映されます — 再起動は不要です。

すべての呼び出しをワークスペースにスコープする

ワークスペーススコープのデータに触れるすべてのツールは workspace_id を必須とし、それがなければ呼び出しは、何らかの「現在の」ワークスペースに解決されるのではなく拒否されます:

{
  "workspace_id": "acme",
  "title": "Fix login bug",
  "priority": "high"
}

ID はブラウザーまたはアプリの URL にあるものです: /workspaces/<workspace_id>/…。唯一の例外は、list_workspaces やニュースフィードのツールのように、本当にワークスペースをまたぐツールです — ニュースフィードはユーザー単位であり、エージェントは自分自身のユーザーを持たないため、これらのツールはサーバー所有者のフィードを操作します。

リポジトリスコープのツールはさらに、そのリポジトリがそのワークスペースにリンクされているかを確認します。

サーフェスが何を拒否するかを知る

モードによるゲート。 呼び出しはサーバー側で、呼び出し元エージェントのスペースのモードに対して解決されます。読み取り専用モードのエージェントは、space_id を省略しても書き込みツールに到達できません — 代わりに、そのモードはその実行中の実行から参照されます。
アクションガードレール。 変更を加えるツールは自身のエフェクトクラスを宣言し、製品の他の部分と同じポリシーを通ります。ガードレールを設定を参照してください。
確認。 一部の破壊的なツールは確認ペイロードを生成し、呼び出しが進む前に承認される必要があります。

完全なカタログは tools/list で、ディスカバリーのゲートなしに公開されます — 外部の MCP クライアントは、自身のキャッシュ済みリストにないツールの呼び出しを拒否するため、ツールを隠すことはそれらを整理するのではなく壊すことになります。

トラブルシューティング

クライアントにツールが表示されない

MCP サーバーカードが「実行中」と表示されているか確認します
ポートが cc_server のポートと一致しているか確認します
Claude Code では、--mcp-config と --strict-mcp-config を渡したか確認します

サーバー以外のマシンから 403 が返る

ベアラートークンが設定されていません。設定して送信してください。

ツール呼び出しが “Missing or invalid argument: workspace_id” で失敗する

workspace_id を追加します。暗黙のワークスペースは存在しません。

ツール呼び出しが不明として拒否される

MCP ツールにカタログがあります。そこに表示されているとおりの名前で呼び出してください。