メッセージMCPトンネル

MCPトンネルクイックスタート

ローカルのDocker Composeデプロイメントを使用して、ClaudeをプライベートMCPサーバーに接続します。

MCPトンネルはリサーチプレビュー段階です。お試しいただくにはアクセスをリクエストしてください。

このクイックスタートでは、ゼロから始めて、Claudeがトンネル経由でプライベートMCPサーバーを呼び出せるようになるまでを説明します。ここでは手動での認証情報プロビジョニングを用いたDocker Composeを使用します。これはローカルテストのための最短経路です。本番環境へのデプロイについては、HelmでデプロイするまたはDocker Composeでデプロイするを参照してください。

構築するもの

2つのコンテナからなるトンネルスタック（プロキシとcloudflared）に加えて、それと並行して動作するサンプルMCPサーバーを構築します。すべてが稼働すると、パブリックポートで何もリッスンしていないにもかかわらず、サンプルサーバーはClaudeからhttps://echo.<your-tunnel-domain>/mcpでアクセス可能になります。

必要なもの

アウトバウンドインターネットアクセスが可能なマシン上のDockerおよびDocker Compose。
MCPトンネルを管理できるClaude Consoleのロール。Consoleガイドの前提条件を参照してください。
OpenSSL 1.1.1以降。macOSおよびほとんどのLinuxディストリビューションにはプリインストールされています。Windowsでは別途インストールしてください（opensslバイナリがPATH上にある必要があります）。

トンネルを作成する
Claude Consoleのサイドバーで、Manage > MCP tunnelsに移動し、New tunnelをクリックします。名前を付けます。Set up programmatic accessはオフのままにしてください。このクイックスタートでは手動での認証情報プロビジョニングを使用します。
作成後、トンネルを開きます。Connectionセクションから次の2つの値をコピーします。
- Domain（abcd1234.tunnel.anthropic.comのような形式）
- Token（目のアイコンをクリックしてからコピー）
デプロイメントディレクトリをセットアップする
CAとサーバー証明書を生成する
プロキシは、あなたが管理するCAによって署名された証明書を使用して内部TLSを終端します。両方を生成します。
Consoleに戻り、トンネルの詳細ページでAdd certificateをクリックし、data/ca.crtをアップロードします（またはその内容を貼り付けます）。トンネルのステータスがActiveに切り替わります。
サンプルMCPサーバーを作成する
プロキシ設定とComposeファイルを作成する
起動する
echoに対するroute configuredの行が1つと、Registered tunnel connectionの行が4つ表示されるはずです。コンテナの起動には数秒かかります。何も表示されない場合は、ログコマンドを再実行してください。
Claudeから呼び出す
Consoleで、Managed Agents > Sessionsに移動し、セッションを作成します。エージェントピッカーでCreate new agentを選択し、エージェントに名前を付け、事前入力されたモデルをそのまま使用します。+ MCP Serverをクリックし、トンネルを選択して、Subdomainをechoに、Pathをmcpに設定します。その後、次のように依頼します。

Use the hello tool to greet tunnel.

ツール呼び出しとその結果が表示されるはずです。

次のステップ

トンネルはエンドツーエンドで検証されました。独自のMCPサーバーに切り替えるには、それをdocker-compose.yamlに追加し（または同じDockerネットワーク上で実行し）、config/mcp-proxy.yamlにそのルートを追加してから、プロキシを再起動します（docker compose restart mcp-proxy）。

本番環境へのデプロイについては、以下を参照してください。

Docker Composeでデプロイする

プログラムによるアクセスの有無にかかわらず、堅牢化された単一ホストデプロイメント。

Helmでデプロイする

自動認証情報管理を備えたKubernetesデプロイメント。

Was this page helpful?

構築するもの

必要なもの

アウトバウンドインターネットアクセスが可能なマシン上のDockerおよびDocker Compose。

MCPトンネルを管理できるClaude Consoleのロール。Consoleガイドの前提条件を参照してください。

OpenSSL 1.1.1以降。macOSおよびほとんどのLinuxディストリビューションにはプリインストールされています。Windowsでは別途インストールしてください（opensslバイナリがPATH上にある必要があります）。

トンネルを作成する
Claude Consoleのサイドバーで、Manage > MCP tunnelsに移動し、New tunnelをクリックします。名前を付けます。Set up programmatic accessはオフのままにしてください。このクイックスタートでは手動での認証情報プロビジョニングを使用します。
作成後、トンネルを開きます。Connectionセクションから次の2つの値をコピーします。
- Domain（abcd1234.tunnel.anthropic.comのような形式）
- Token（目のアイコンをクリックしてからコピー）
デプロイメントディレクトリをセットアップする
CAとサーバー証明書を生成する
プロキシは、あなたが管理するCAによって署名された証明書を使用して内部TLSを終端します。両方を生成します。
Consoleに戻り、トンネルの詳細ページでAdd certificateをクリックし、data/ca.crtをアップロードします（またはその内容を貼り付けます）。トンネルのステータスがActiveに切り替わります。
サンプルMCPサーバーを作成する
プロキシ設定とComposeファイルを作成する
起動する
echoに対するroute configuredの行が1つと、Registered tunnel connectionの行が4つ表示されるはずです。コンテナの起動には数秒かかります。何も表示されない場合は、ログコマンドを再実行してください。
Claudeから呼び出す
Consoleで、Managed Agents > Sessionsに移動し、セッションを作成します。エージェントピッカーでCreate new agentを選択し、エージェントに名前を付け、事前入力されたモデルをそのまま使用します。+ MCP Serverをクリックし、トンネルを選択して、Subdomainをechoに、Pathをmcpに設定します。その後、次のように依頼します。

Use the hello tool to greet tunnel.

ツール呼び出しとその結果が表示されるはずです。

次のステップ

本番環境へのデプロイについては、以下を参照してください。

Was this page helpful?