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>）が割り当てられます。これらのホスト名をClaude 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アイデンティティプロバイダーがある場合。
  • 手動の認証情報: 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で提供され、他のサーバーは/やカスタムパスを使用する場合があります（サーバーのドキュメントを確認してください）。プロキシはパスをそのまま転送します。

client = anthropic.Anthropic()

response = client.beta.messages.create(
    model="claude-opus-5",
    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"}],
    betas=["mcp-client-2025-11-20"],
)

print(response)

アップストリームMCPサーバーへの認証（authorization_token）やその他のmcp_serversオプションについては、MCPコネクタを参照してください。



次のステップ