MCPトンネル

MCPトンネルを使用すると、プライベートネットワーク内で実行されているModel Context Protocol（MCP）サーバーにClaudeを接続できます。トラフィックはアウトバウンド専用の接続を通じて流れるため、受信ファイアウォールポートを開いたり、サービスをパブリックインターネットに公開したり、オリジンでAnthropicのIP範囲を許可リストに追加したりする必要はありません。

Zero Data RetentionおよびHIPAA BAAの適格性については、APIとデータ保持を参照してください。



仕組み

トンネルスタックは、ネットワーク内で実行される2つのコンポーネントで構成されます。

• cloudflared: Cloudflareのオープンソーストンネルコネクタです。トンネルエッジへのアウトバウンド専用接続を開始し、Anthropicからプロキシへの暗号化されたトラフィックを伝送します。
• プロキシ: Anthropicのルーティングコンポーネントです。内部TLSを終端し、アップストリームIPが許可された範囲内にあることを検証し、ホスト名に基づいて各リクエストを正しいアップストリームMCPサーバーにルーティングします。

公開する各MCPサーバーには、トンネルドメイン配下のホスト名（例: docs.<your-tunnel-domain>）が割り当てられます。これらのホスト名をConsoleでManaged Agentセッションにアタッチするか、MCPコネクタを通じてMessages APIに渡します。



前提条件

デプロイする前に、以下を用意してください。

• デプロイ先: Kubernetesクラスタ、またはDockerとDocker Composeがインストールされた VM。
• トンネル。Claude Consoleで作成する（トンネルを作成するを参照）か、API経由で作成します。Helmチャートのセットアップフックでインストール時に作成することもできます。
• スタックがTunnels APIに対して認証する手段。以下のいずれかを選択します。
  • プログラマティックアクセス（推奨）。 トンネル作成時にWorkload Identity Federationを設定します。スタックはアイデンティティプロバイダーから短期間有効なAPIトークンを発行し、トンネルトークンを取得し、CA証明書を自動的に生成・登録します。フェデレーションルールを管理する権限、登録済みのOIDC発行者、およびworkspace:manage_tunnelsスコープを持つフェデレーションルールが必要です。
  • 手動。 静的な認証情報を自分で用意します。Consoleから取得したトンネルトークンと、Consoleに登録したCAによって署名されたサーバー証明書です。接続の詳細を取得するおよびCA証明書を追加するを参照してください。
• プライベートネットワーク内で実行されている1つ以上のMCPサーバー。例についてはリモートMCPサーバーを参照してください。
• ネットワーク要件に記載されているアウトバウンド接続。



ネットワーク要件



セキュリティモデル



セキュリティレイヤー

3つの独立したレイヤーがすべてのリクエストを保護します。

トンネルトランスポートはCloudflareのネットワーク上で動作します。プロキシはあなただけが保持する証明書を使用してインナーTLSを終端するため、Cloudflareはリクエストやレスポンスのペイロードを読み取ることができません。AnthropicはCA証明書が登録されるまでトンネルに接続しないため、ペイロードはCloudflareのネットワークを通過する際に常に暗号化されています。Cloudflareは接続メタデータを受け取ります。トランスポートプロバイダーが観測できるものを参照してください。



責任共有モデル



トランスポートプロバイダーが観測できるもの

Cloudflareはアウトバウンドトランスポートを提供します。MCPリクエストやレスポンスのペイロードを読み取ることはできませんが、以下の接続メタデータを受け取ります。

• cloudflaredを実行しているホストのエグレスIPアドレス
• cloudflaredホストのフィンガープリント
• 接続のタイミングとバイト量
• トンネルに割り当てられた*.tunnel.anthropic.comサブドメイン

AnthropicとCloudflareの契約により、Cloudflareによるこのテレメトリの使用は制限されています。Cloudflareはこのリサーチプレビューにおいてサブプロセッサーとして機能します。



トンネルをデプロイする

MCPトンネルを初めて使用する場合は、本番環境のデプロイを設定する前に、クイックスタートから始めてローカルで動作するトンネルを構築してください。

選択の基準:

• デプロイ先
  • Helm: Kubernetesにデプロイする場合。
  • Docker Compose: 単一ホストまたはローカルテストの場合。
• セットアップの認証
  • プログラマティックアクセス（Workload Identity Federation経由）: Kubernetesクラスタ、クラウドIAM、SPIFFEなどのOIDCアイデンティティプロバイダーがある場合。
  • 手動の認証情報: それらがない場合、またはテスト中の場合。



トンネル経由のMCPサーバーを使用する

トンネルがアクティブになると（アクティブなCA証明書があり、トンネルスタックが接続されている状態）、アップストリームMCPサーバーにClaude Managed AgentsおよびMessages APIからアクセスできるようになります。

どちらの場合も、トンネルは暗号化されたトラフィックをMCPサーバーに伝送しますが、MCPサーバーに対する認証は行いません。アップストリームMCPサーバーが独自の認証（OAuth、ベアラートークン）を必要とする場合は、他のMCPサーバーと同じ方法で提供してください。これはトンネルとは独立しています。



Managed Agents（Console）

1. Managed Agents > Sessionsでセッションを作成し、Create new agentを選択してMCPサーバーリストを編集できるようにします。
2. + MCP Serverをクリックしてドロップダウンを開きます。セッションのワークスペース内にあり、少なくとも1つのアクティブな証明書を持つトンネルが、パブリックコネクタカタログの上部に表示されます。
3. トンネルを選択し、プロキシが特定のMCPサーバーにルーティングするSubdomainと、アップストリームMCPサーバーが期待するPathを指定します。Resolves toの行に正確なURLが表示されます。



Messages API

他のリモートMCPサーバーと同じように、アップストリームMCPサーバーのURLをmcp_servers配列に渡します。リクエストボディとanthropic-betaヘッダーは標準のMCPコネクタ形式に従います。トンネル固有なのはurlのみです。以下の例ではMCPコネクタのmcp-clientベータヘッダーを使用しています。これはTunnels APIで使用されるmcp-tunnelsベータとは別のものです。トンネルが作成されたワークスペースのAPIキー（ConsoleのSettings > API keys）を使用してください。

URLのホストは<subdomain>.<your-tunnel-domain>です。パスはトンネルではなくアップストリームMCPサーバーに依存します。FastMCPのstreamable-httpトランスポートは/mcpで提供され、他のサーバーは/やカスタムパスを使用する場合があります（サーバーのドキュメントを確認してください）。プロキシはパスをそのまま転送します。

curl https://api.anthropic.com/v1/messages \
  -H "Content-Type: application/json" \
  -H "X-API-Key: $ANTHROPIC_API_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -H "anthropic-beta: mcp-client-2025-11-20" \
  -d '{
    "model": "claude-opus-4-8",
    "max_tokens": 1000,
    "messages": [{"role": "user", "content": "Use the hello tool to greet tunnel."}],
    "mcp_servers": [
      {
        "type": "url",
        "url": "https://echo.YOUR_TUNNEL_DOMAIN_HERE/mcp",
        "name": "echo"
      }
    ],
    "tools": [{"type": "mcp_toolset", "mcp_server_name": "echo"}]
  }'

各言語のSDKの例については、MCPコネクタを参照してください。トンネル固有の値はurlのみです。



次のステップ