MCPトンネルはリサーチプレビュー段階です。お試しいただくにはアクセスをリクエストしてください。
このページでは、MCPトンネルのデプロイにおけるConsole側の操作について説明します。具体的には、トンネルの作成、CA証明書の登録、トンネルトークンの取得、およびアップストリームMCPサーバーのエージェントへのアタッチです。ネットワーク内でトンネルスタックを実行する方法については、HelmでMCPトンネルをデプロイするおよびDocker ComposeでMCPトンネルをデプロイするを参照してください。
workspace:manage_tunnelsスコープを持つフェデレーションルールが必要です。MCP tunnelsページを開く
Consoleのサイドバーで、Manage > MCP tunnelsに移動します。トンネルはワークスペースにスコープされています。新しいトンネルはConsoleで現在選択されているワークスペースに属するため、別のワークスペースに作成したい場合は先にワークスペースを切り替えてください。
トンネルに名前を付ける
New tunnelをクリックし、Create tunnelダイアログで名前を入力します。名前は必須で、一覧、詳細ページ、およびエージェントのMCPサーバーピッカーでトンネルを識別するために使用されます。abcd1234.tunnel.anthropic.com形式のドメインが自動的に割り当てられます。
必要に応じてプログラムによるアクセスを設定する
ロールにフェデレーションルールを管理する権限がある場合、Set up programmatic accessトグルが表示されます(デフォルトはオフ)。権限がない場合、Consoleはその場所に通知を表示し、トンネルスタックは代わりに手動フローを使用します。どちらの場合も、作成フローの残りの部分は同じです。
プログラムによるアクセスはWorkload Identity Federationに依存しています。フェデレーションのイシュアー、ルール、サービスアカウントに馴染みがない場合は、まずそのページをお読みください。トグルをオンにするには、以下が必要です。
workspace:manage_tunnelsスコープを持つフェデレーションルール。トグルをオンにすると、Federation ruleピッカーが表示されます。そのスコープを持つ既存のルールを選択するか、Create federation ruleをクリックしてインラインで作成します。api.wif.workspaceId、Composeの場合はANTHROPIC_WORKSPACE_ID)。このステップをスキップすることも完全にサポートされています。両方のデプロイガイドにはWithout programmatic accessタブがあります。
トンネルを作成する
Create tunnelをクリックします。Consoleがトンネルをプロビジョニングし、詳細ページを開きます。
デプロイ用の識別子を記録する
どちらのデプロイ方法でも以下が必要です。
tnl_...)。トンネルの詳細ページに表示されます。abcd1234.tunnel.anthropic.com)。トンネルの詳細ページに表示されます。プロキシのtunnel_domainとして、およびサーバー証明書のSANで使用されます。その他に必要なものは、認証情報プロビジョニングモードによって異なります。
| プログラムによるアクセスあり | プログラムによるアクセスなし |
|---|---|
選択したルールのフェデレーションルールID(fdrl_...)。ルールは組織レベルであり、トンネルには保存されません。Settings > Workload identity > Rulesで確認できます。 | トンネルトークン。詳細ページのTokenの横にある目のアイコンで表示できます。シークレットとして扱ってください。接続の詳細を取得するを参照してください。 |
| 組織ID(UUID)。Settings > Organizationに表示されます。 | 自分で生成してトンネルに登録するCA証明書。 |
プログラムによるアクセスを使用する場合、スタックはTunnels APIを通じてトンネルトークンを取得し、CAとサーバー証明書をローカルで生成し(秘密鍵は環境外に出ません)、CAの公開証明書のみをAnthropicに登録します。秘密鍵の保護と、有効期限が切れる前のサーバー証明書の更新は、引き続きお客様の責任です。
組織は最大10個のアクティブなトンネルを持つことができます。トンネルを作成しても接続は確立されません。接続は、スタックがトンネルトークンでダイヤルインし、CA証明書が登録されて初めて確立されます。
トンネルを開きます。詳細ページには、ドメインとトークンを含むConnectionセクションと、Certificatesセクションが表示されます。
| フィールド | 説明 |
|---|---|
| Domain | 割り当てられたabcd1234.tunnel.anthropic.comの値をコピーします。プロキシのルートはこのドメインのサブドメインになります。 |
| Token | 目のアイコン(Show token)をクリックしてトンネルトークンを取得し、コピーアイコンを使用してトンネルスタックのシークレットストアにコピーします。Rotate tokenをクリックすると、現在のトークンが無効化され、新しいトークンが発行されます。 |
すべての表示とローテーションは、組織のCompliance APIアクティビティログに記録されます。ローテーションは、すでに確立されているcloudflared接続を切断しないため、ローテーションを行い、新しい値で再デプロイし、古い接続が自然に終了するのを待つことができます。
Anthropicは、トンネルに登録されたCA証明書に対して、プロキシへの内部TLSを検証します。アクティブな証明書がないトンネルは接続を受け付けることができず、証明書が登録されるまでエージェントのMCPサーバーピッカーに表示されません。
Certificatesセクションを見つける
トンネルの詳細ページで、Certificatesセクションまでスクロールし、Add certificateをクリックします。
証明書を提供する
Choose fileをクリックして.pem、.crt、または.cerファイルを選択するか、ファイルをテキストエリアにドラッグするか、PEMブロックを直接貼り付けます。モーダルは、秘密鍵の内容や-----BEGIN CERTIFICATE-----ブロックでないコンテンツを拒否します。ファイルは8 kB以下である必要があります。
証明書を追加する
Add certificateをクリックします。フィンガープリントと有効期限が証明書リストに表示され、セクションヘッダーのスロット数が増加します。
トンネルは最大2つのアクティブな証明書を保持できるため、ダウンタイムなしでローテーションできます。古い証明書と並行して新しい証明書を登録し、新しいキーペアでプロキシを再デプロイし、トラフィックが流れていることを確認してから、古い証明書の行でRevokeをクリックします。失効した証明書は、Revokedバッジ付きでリストに表示され続けます。
トンネルはConsoleに存在しますが、トンネルスタックがネットワーク内で実行され、トンネルトークンでダイヤルインするまでトラフィックは流れません。次のいずれかのデプロイガイドに従ってください。
単一ホストでトンネルスタックを実行します。プログラムによるアクセスと手動フローの両方に対応しています。
Kubernetesクラスターでトンネルスタックを実行します。プログラムによるアクセスと手動フローの両方に対応しています。
スタックが実行され、1つ以上のMCPサーバーが設定されたら、アップストリームMCPサーバーをManaged Agentセッションにアタッチします。代わりにMessages APIから同じサーバーを呼び出す場合は、トンネル経由のMCPサーバーを使用するを参照してください。
ピッカーには、少なくとも1つのアクティブな証明書を持つトンネルのみが表示されます。MCP tunnelsリストでまだNeeds certificateと表示されているトンネルはドロップダウンに表示されません。まずCA証明書を登録してください。ピッカーもワークスペースにスコープされており、セッションと同じワークスペース内のトンネルのみが一覧表示され、他のワークスペースのトンネルは表示されません。
New sessionモーダルを開く
Managed Agents > Sessionsに移動し、New sessionをクリックします。
インラインエージェントを定義する
エージェントピッカーでCreate new agentを選択し、MCPサーバーリストを直接編集できるようにします。
MCPサーバーを追加する
+ MCP Serverをクリックしてドロップダウンを開きます。現在のワークスペースで作成されたトンネルが、パブリックコネクタカタログの上、リストの先頭に表示されます。接続したいサーバーをフロントするトンネルを選択します。
ルーティングを指定する
カードには2つのオプションフィールドが表示されます。Subdomain(トンネルドメインの前に付加される)とPath(その後に付加される)です。プロキシのルートの設定方法に応じて、一方または両方を入力します。Resolves toの行には、エージェントが接続する完全なMCPサーバーURLが表示されます。
トンネルはトラフィックを運ぶものであり、アップストリームMCPサーバーに対する認証は行いません。他のMCPサーバーと同じ方法で、MCPサーバーにOAuthまたはベアラー認証を設定してください。
アーカイブすると、トンネルは直ちに接続の受け付けを停止します。この操作は元に戻せません。
MCP tunnelsリストで、トンネルの行メニューを開き、Archiveを選択します。アーカイブされたトンネルは、リストをArchivedまたはAllでフィルタリングすると表示されます。
Was this page helpful?