MCP 通道

MCP 通道（MCP tunnels）讓您可以將 Claude 連接到在您私有網路內執行的 Model Context Protocol（MCP）伺服器。流量透過僅出站的連線傳輸，因此您不需要開放入站防火牆連接埠、將服務暴露到公共網際網路，或在您的來源端將 Anthropic 的 IP 範圍加入允許清單。

關於零資料保留（Zero Data Retention）和 HIPAA BAA 資格，請參閱 API 與資料保留。



運作方式

通道堆疊由兩個在您網路內執行的元件組成：

• cloudflared： Cloudflare 的開源通道連接器。它向通道邊緣發起僅出站的連線，並將來自 Anthropic 的加密流量傳送到您的代理。
• 代理（Proxy）： 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 chart 的設定掛鉤（setup hook）也可以在安裝期間為您建立一個。
• 讓您的堆疊向 Tunnels API 進行身份驗證的方式。選擇其一：
  • 程式化存取（建議）。 在建立通道時設定 Workload Identity Federation。您的堆疊會從您的身份提供者鑄造短期 API 權杖、取得通道權杖，並自動產生和註冊 CA 憑證。需要管理聯合規則的權限、已註冊的 OIDC 發行者，以及具有 workspace:manage_tunnels 範圍的聯合規則。
  • 手動。 自行提供靜態憑證：來自 Console 的通道權杖，以及由您在該處註冊的 CA 簽署的伺服器憑證。請參閱取得連線詳細資訊和新增 CA 憑證。
• 在您私有網路中執行的一個或多個 MCP 伺服器。請參閱遠端 MCP 伺服器以取得範例。
• 網路需求中列出的出站連線能力。



網路需求



安全模型



安全層

三個獨立的層級保護每個請求：

通道傳輸在 Cloudflare 的網路上執行。由於代理使用只有您持有的憑證來終止內層 TLS，Cloudflare 無法讀取請求或回應的酬載。Anthropic 在 CA 憑證註冊之前不會連接到通道，因此酬載在穿越 Cloudflare 網路時始終是加密的。Cloudflare 確實會收到連線中繼資料；請參閱傳輸供應商可以觀察到什麼。



共同責任模型



傳輸供應商可以觀察到什麼

Cloudflare 提供出站傳輸。它無法讀取 MCP 請求或回應的酬載，但確實會收到以下連線中繼資料：

• 執行 cloudflared 的主機的出口 IP 位址
• cloudflared 主機指紋
• 連線時間和位元組流量
• 指派給您通道的 *.tunnel.anthropic.com 子網域

Anthropic 與 Cloudflare 的協議限制了 Cloudflare 對此遙測資料的使用。在此研究預覽中，Cloudflare 作為次級處理者（subprocessor）。



部署通道

如果您是 MCP 通道的新手，請從快速入門開始，在設定正式環境部署之前先在本機取得一個可運作的通道。

如何選擇：

• 部署目標
  • 部署到 Kubernetes 時使用 Helm。
  • 單一主機或本機測試時使用 Docker Compose。
• 設定的身份驗證方式
  • 當您擁有 OIDC 身份提供者（例如 Kubernetes 叢集、雲端 IAM 或 SPIFFE）時，使用程式化存取（透過 Workload Identity Federation）。
  • 當您沒有，或正在測試時，使用手動憑證。



使用通道化的 MCP 伺服器

一旦您的通道處於活躍狀態（它具有活躍的 CA 憑證且您的通道堆疊已連線），上游 MCP 伺服器即可從 Claude Managed Agents 和 Messages API 存取。

在這兩種情況下，通道會將加密流量傳送到您的 MCP 伺服器，但不會對其進行身份驗證。如果上游 MCP 伺服器需要自己的身份驗證（OAuth、bearer token），請以與任何其他 MCP 伺服器相同的方式提供；這與通道無關。



Managed Agents（Console）

1. 在 Managed Agents > Sessions 中，建立一個工作階段並選擇 Create new agent，以便您可以編輯 MCP 伺服器清單。
2. 點擊 + MCP Server 並開啟下拉選單。工作階段所在工作區中至少擁有一個活躍憑證的通道會出現在清單頂部，位於公開連接器目錄之上。
3. 選擇通道並提供您的代理路由到特定 MCP 伺服器的 Subdomain，以及上游 MCP 伺服器預期的 Path。Resolves to 這一行會顯示確切的 URL。



Messages API

在 mcp_servers 陣列中傳遞上游 MCP 伺服器的 URL，方式與任何其他遠端 MCP 伺服器相同。請求主體和 anthropic-beta 標頭遵循標準的 MCP 連接器格式；只有 url 是通道特有的。以下範例使用 MCP 連接器的 mcp-client beta 標頭，這與 Tunnels API 使用的 mcp-tunnels beta 是分開的。請使用建立通道所在工作區的 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 連接器。



後續步驟