使用 Docker Compose 部署 MCP 通道

此路徑要求主機具備 OIDC 身分提供者（例如雲端虛擬機器中繼資料伺服器或 SPIFFE）。若沒有，請改用不使用程式化存取分頁。

設定元件使用 Workload Identity Federation 來擷取通道權杖、產生 CA 與伺服器憑證，並向 Anthropic 註冊該 CA。

1. 1

   準備部署目錄

   mkdir -p mcp-tunnel/{config,data}
   cd mcp-tunnel
   sudo chown 65532:65532 data

   

   容器以非 root 的 UID 65532 執行，且需要對 data/ 的寫入權限。

2. 2

   撰寫 docker-compose.yaml

   此 compose 檔案以 SHA-256 摘要固定映像檔版本、以非 root 身分搭配唯讀檔案系統執行每個容器、移除所有 Linux capabilities，並停用權限提升。

   cat > docker-compose.yaml <<'EOF'
   services:
     setup:
       image: us-docker.pkg.dev/anthropic-public-registry/images/mcp-proxy@sha256:efb27b299d627e4134815663cb8896641eeaee025d734c0f695582b4df38f013
       entrypoint: ["/setup"]
       command:
         - init
         - --api-url=https://api.anthropic.com
         - --output=dir:/data
         - --token-version=1
       environment:
         - TUNNEL_ID
         - ANTHROPIC_FEDERATION_RULE_ID
         - ANTHROPIC_ORGANIZATION_ID
         - ANTHROPIC_WORKSPACE_ID
         - ANTHROPIC_IDENTITY_TOKEN
       volumes:
         - ./data:/data
       user: "65532:65532"
       read_only: true
       security_opt:
         - no-new-privileges:true
       cap_drop:
         - ALL
       profiles: ["setup"]
   
     cloudflared:
       image: cloudflare/cloudflared@sha256:6b599ca3e974349ead3286d178da61d291961182ec3fe9c505e1dd02c8ac31b0
       command: tunnel --no-autoupdate run --url http://localhost:8080
       environment:
         - TUNNEL_TOKEN
       # 共用 proxy 的 netns，讓 localhost:8080 能連到它。
       network_mode: "service:mcp-proxy"
       restart: unless-stopped
       user: "65532:65532"
       read_only: true
       security_opt:
         - no-new-privileges:true
       cap_drop:
         - ALL
       stop_grace_period: 30s
       logging:
         options:
           max-size: "10m"
           max-file: "3"
   
     mcp-proxy:
       image: us-docker.pkg.dev/anthropic-public-registry/images/mcp-proxy@sha256:efb27b299d627e4134815663cb8896641eeaee025d734c0f695582b4df38f013
       volumes:
         - ./config/mcp-proxy.yaml:/etc/mcp-gateway/config.yaml:ro
         - ./data:/data:ro
       restart: unless-stopped
       user: "65532:65532"
       read_only: true
       security_opt:
         - no-new-privileges:true
       cap_drop:
         - ALL
       stop_grace_period: 30s
       logging:
         options:
           max-size: "10m"
           max-file: "3"
   EOF

   

   如果您使用範例 MCP 伺服器，請將其附加為一個服務：

   cat >> docker-compose.yaml <<'EOF'
   
     hello-mcp:
       image: python:3.13-slim
       working_dir: /app
       volumes:
         - ./hello_server.py:/app/hello_server.py:ro
       command: sh -c "pip install --quiet mcp && python hello_server.py"
       restart: unless-stopped
   EOF

   
3. 3

   佈建通道

   設定識別碼。將 TUNNEL_ID 保持未設定，讓設定元件建立通道；若要附加到 Console 中的現有通道，請設定它：

   # export TUNNEL_ID=tnl_...   # 設定此值以連接至現有的 tunnel
   export ANTHROPIC_FEDERATION_RULE_ID=fdrl_...
   export ANTHROPIC_ORGANIZATION_ID=00000000-0000-0000-0000-000000000000

   

   如果您的聯合規則範圍限定於組織預設工作區以外的工作區，請同時設定 ANTHROPIC_WORKSPACE_ID=wrkspc_...；否則設定元件會使用預設工作區。自動建立的通道會建立在該工作區中。

   將 ANTHROPIC_IDENTITY_TOKEN 設定為來自此主機身分提供者的 OIDC JWT。請依照適用於您提供者的 WIF 指南註冊簽發者、設定規則的 subject，並鑄造權杖；規則的 audience 必須與您鑄造時所請求的 audience 相符。

   執行設定元件：

   docker compose run --rm setup

   

   setup init 對 data/ 具有冪等性：重新執行時會重複使用已儲存於其中的通道 ID 與 CA，絕不會建立第二個通道。只有在 data/ 為空或 TUNNEL_ID 已變更時，才會產生並註冊新的 CA；在這種情況下，兩張有效憑證的上限會適用，因此若兩個位置都已佔滿，請先在 Console 中撤銷其中一張。

   若發生錯誤，請參閱設定元件身分驗證失敗。

   取得您的通道網域並匯出，供後續步驟使用：

   export TUNNEL_DOMAIN=$(sudo cat data/tunnel-domain)
   echo "$TUNNEL_DOMAIN"

   
4. 4

   撰寫 proxy 設定

   tunnel_domain 為必填：proxy 會使用它從傳入的主機名稱中去除網域後綴，然後再於 routes 中查詢子網域。routes 是從子網域對應到上游 URL 的扁平映射，而非清單。

   cat > config/mcp-proxy.yaml <<EOF
   listen_addr: ":8080"
   log_level: info
   shutdown_timeout: 30s
   tunnel_domain: ${TUNNEL_DOMAIN}
   tls:
     cert_file: /data/tls.crt
     key_file: /data/tls.key
   routes:
     echo: http://hello-mcp:9000
   EOF

   

   echo: 路由指向範例 MCP 伺服器；請以您自己的路由取代（或新增）。所有可用欄位請參閱 proxy 設定參考文件。

5. 5

   啟動部署

   export TUNNEL_TOKEN=$(sudo cat data/tunnel-token)
   docker compose up -d

   