Docker ComposeでMCPトンネルをデプロイする

このパスでは、ホストにOIDCアイデンティティプロバイダー（クラウドVMメタデータサーバーやSPIFFEなど）が必要です。ない場合は、代わりに プログラムによるアクセスなし タブを使用してください。

セットアップコンポーネントはWorkload Identity Federationを使用してトンネルトークンを取得し、CAとサーバー証明書を生成して、CAをAnthropicに登録します。

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ケーパビリティを削除し、権限昇格を無効にします。

   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
       # プロキシの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_...   # 既存のトンネルに接続する場合に設定
   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ガイドに従って、発行者を登録し、ルールのサブジェクトを設定し、トークンを発行してください。ルールのオーディエンスは、発行時にリクエストするオーディエンスと一致する必要があります。

   セットアップコンポーネントを実行します。

   docker compose run --rm setup

   

   setup init は data/ に対して冪等です。再実行すると、すでにそこに保存されているトンネルIDとCAを再利用し、2つ目のトンネルを作成することはありません。新しいCAが生成・登録されるのは、data/ が空の場合または TUNNEL_ID が変更された場合のみです。その場合、アクティブな証明書は2つまでという上限が適用されるため、両方のスロットが埋まっている場合は先にConsoleで1つを失効させてください。

   エラーが発生した場合は、セットアップコンポーネントの認証失敗を参照してください。

   トンネルドメインを取得し、後の手順のためにエクスポートします。

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

   
4. 4

   プロキシ設定を作成する

   tunnel_domain は必須です。プロキシはこれを使用して、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サーバーを対象としています。独自のルートに置き換える（または追加する）ようにしてください。利用可能なすべてのフィールドについては、プロキシ設定リファレンスを参照してください。

5. 5

   デプロイを開始する

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

   