mcp-tunnels プラグイン
プラグイン Claude Code 開発 AI エージェント・AI アプリ開発クラウド・デプロイ・CI/CDClaude Code 拡張・ワークフロー以下の解説は生成 AI によるものです。出典と照らし合わせてご確認ください。
mcp-tunnelsは、Anthropicが提供するMCP tunnelを介して、Claudeをプライベートネットワーク内で稼働するMCPサーバーに接続するための公式Claudeプラグインです。通信はアウトバウンドのみで、インバウンドポートの開放は不要です。主要コマンド/create-docker-mcp-tunnelは、単一ホスト上でDocker Composeによるquickstartを一通り実行し、事前チェック、Claude ConsoleでのトンネルcreateとCA登録、証明書生成、プロキシ・Compose設定の書き出し、スタック起動と検証、Claudeからの呼び出し方法までをカバーします。READMEによると、本プラグインはresearch previewであり、稼働率やサポートの保証はなく、サードパーティのトランスポートプロバイダー(Cloudflare)に依存します。対象範囲は手動クレデンシャル・単一ホスト・ローカルテスト向けの構成で、耐障害性を高めた構成やKubernetesデプロイは別の公式デプロイガイドで案内されています。作者はAnthropic([email protected])です。
概要
mcp-tunnelsは単体のSaaSではなく、Claude向けプラグインです。Anthropic MCP tunnelのセットアップと、これを支えるDockerコンテナスタック(mcp-proxy、cloudflared、任意でサンプルサーバーhello-mcp)の構築を自動化し、インバウンドポートを開けずにプライベートなMCPサーバーへClaudeからアクセスできるようにします。
mcp-tunnels でできること
- /create-docker-mcp-tunnel [deployment-dir] を実行し、MCP tunnel構築のためのDocker Composeによるquickstart全体を進められます
- Docker、Docker Compose、OpenSSL、アウトバウンド接続の事前チェックをプラグインに実行させられます
- Claude ConsoleでのトンネルcreateとCA証明書登録の手順を案内してもらえます。トークンはチャットに出さず、gitignore対象の.envに保持されます
- OpenSSLによるCA証明書とサーバー証明書の生成(必要な拡張含む)を自動化できます
- 検証用のFastMCPサンプルサーバー(hello-mcp)を用意するか、既存のMCPサーバーをupstreamとして接続できます
- mcp-proxy.yamlと、digest固定イメージおよびcloudflaredエージェントを含むdocker-compose.yamlの書き出しを自動化できます
- スタックを起動し、proxyおよびtunnelのログを確認したうえで、Managed AgentsやMessages APIからサーバーを呼び出す手順を確認できます
- TLSハンドシェイク失敗、routesがmap形式である必要がある点、tls.keyの権限問題、設定変更が自動反映されない点、upstream IP検証など、トラブルシューティングの内容を参照できます
- ca.crt証明書(鍵ファイルは対象外)だけをcatやscpで別マシンにコピーする手順を確認できます
- トークンのローテーションや証明書更新といった運用上の基本作業の手順を確認できます
出典
原文の説明(英語)
Connect Claude to a private MCP server through an Anthropic MCP tunnel. The /create-docker-mcp-tunnel command drives the Docker Compose quickstart end to end: certificates, proxy config, cloudflared, and a verifiable sample server.
mcp-tunnels の変更履歴
- プラグイン mcp-tunnels を追加