MCP tunnels (MCP トンネル)

通信は外向きのみの接続を通るため、受信用のファイアウォールポートを開けたり、サービスを公開インターネットに出したり、Anthropic の IP 範囲を許可リストに入れたりする必要がありません。社内に置いた MCP サーバーを、Claude Managed Agents や Messages API から使う場面に関わる機能です。

トンネルスタックは、利用者のネットワーク内で動く 2 つの構成要素、cloudflared と Anthropic のプロキシから成ります。

プロキシは内側の TLS を終端し、上流の IP アドレスが許可された範囲内にあることを検証したうえで、ホスト名に基づいて各リクエストを正しい上流の MCP サーバーに振り分けます。リクエストのパスは変更せずにそのまま転送します。

公開する MCP サーバーごとに、トンネルドメイン配下のホスト名 (例: docs.<your-tunnel-domain>) が割り当てられます。

• プロキシは利用者だけが持つ証明書で内側の TLS を終端するため、Cloudflare はリクエストやレスポンスの中身を読めません。
• Anthropic は CA 証明書が登録されるまでトンネルに接続しません。そのため、Cloudflare のネットワークを通る中身は常に暗号化されています。
• トンネルは MCP サーバーまで暗号化された通信を運びますが、MCP サーバーへの認証は行いません。上流の MCP サーバーが独自の認証 (OAuth、bearer token) を必要とする場合は、ほかの MCP サーバーと同じ方法で、トンネルとは別に渡します。

Messages API では、上流の MCP サーバーの URL を mcp_servers 配列に渡します。ほかのリモート MCP サーバーと同じ渡し方です。リクエスト本文と anthropic-beta ヘッダーは標準の MCP connector の形式に従い、トンネル固有なのは url だけです。

URL のホストは <subdomain>.<your-tunnel-domain> です。パスはトンネルではなく上流の MCP サーバーによって決まります。

リクエストは、トンネルを作成したワークスペースで行います。そのワークスペースの API キーを使うか、キーがワークスペースに紐づいていない場合は anthropic-workspace-id ヘッダーにそのワークスペースを指定します。

MCP tunnels は、2026 年 5 月 19 日にリサーチプレビューとして提供が始まりました。対象のプランや提供地域は、公式のリリースノートには記載がありません。

• Workload Identity Federation によるプログラムからの利用では、トンネルスタックが ID プロバイダーから有効期間の短い API トークンを発行し、トンネルトークンを取得し、CA 証明書の生成と登録を自動で行います。
• 現在の管理 API は、anthropic-beta: mcp-tunnels-2026-06-22 ヘッダーと workspace:manage_tunnels WIF スコープを使います。
• 上流の MCP サーバーの認証はトンネルとは別に用意する必要があります。

トンネルが有効 (有効な CA 証明書があり、トンネルスタックが接続済み) になった後、Claude Console の Managed Agents から次の手順で使えます。

1. Claude Console の Sessions (セッション) ページでセッションを作成し、Create new agent (新しいエージェントを作成) を選んで、MCP サーバーの一覧を編集できる状態にします。
2. MCP servers (MCP サーバー) の下で MCP server (MCP サーバー) をクリックし、ドロップダウンメニューを開きます。セッションのワークスペースにあり、有効な証明書を 1 つ以上持つトンネルが、公開コネクタのカタログより上の一覧上部に表示されます。
3. トンネルを選び、プロキシが特定の MCP サーバーに振り分ける Subdomain (サブドメイン) と、上流の MCP サーバーが求める Path (パス) を入力します。Resolves to (解決先) の行に、接続先の正確な URL が表示されます。