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

この方法では、ホストにOIDCアイデンティティプロバイダー（クラウドVMのメタデータサーバーや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ケーパビリティを削除し、権限昇格を無効にします。

   cat > docker-compose.yaml <<'EOF'
   services:
     setup:
       image: us-docker.pkg.dev/anthropic-public-registry/images/mcp-proxy@sha256:d243d30642d39857a0579e465cb3b9bf3ae7c1141e83143bb6856777a31467a5
       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:0e56c13c7058fcef9c4f0e7d83372f82330548dbf8f8b366f3d8b506526d93b2
       command: tunnel --no-autoupdate run --url http://localhost:8080
       environment:
         - TUNNEL_TOKEN
       # localhost:8080 でプロキシに到達できるよう、プロキシの netns を共有します。
       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:d243d30642d39857a0579e465cb3b9bf3ae7c1141e83143bb6856777a31467a5
       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

   

Set up programmatic access をオンにしなかった場合、またはローカルでの開発やテストには、このフローを使用してください。setup サービスはありません。

1. 1

   Consoleからトンネルトークンとドメインを取得する

   トンネルの詳細ページで Domain（abcd1234.tunnel.anthropic.com の形式）をコピーし、Token の横にある目のアイコンをクリックしてトンネルトークンを取得し、コピーアイコンを使用してコピーします。

   ガイドの残りの部分のために、両方をシェル変数として設定します。

   export TUNNEL_DOMAIN=YOUR_TUNNEL_DOMAIN_HERE
   export TUNNEL_TOKEN='eyJ...'

   
2. 2

   スキャフォールドを作成して証明書を生成する

   mkdir -p mcp-tunnel/{data,config}
   cd mcp-tunnel

   

   プロキシはプレーンなWebSocketで:8080をリッスンします。内部TLSハンドシェイクは、これらの証明書を使用してそのWebSocketストリームの内部で行われます。Anthropicは、Consoleに登録したCAに対して内部ハンドシェイクを検証します。証明書の要件に記載されているとおり、サーバー証明書の「Subject Alternative Name」（サブジェクト代替名）、すなわちSANには*.<tunnel-domain>を含める必要があります。

   # 自己署名CA。ディストリビューションの openssl.cnf のデフォルトに関係なく証明書の
   # 要件を満たすよう、拡張を明示的に指定します。
   openssl req -x509 -newkey rsa:2048 -nodes \
     -keyout data/ca.key -out data/ca.crt \
     -days 3650 -subj "/CN=mcp-tunnel-ca" \
     -addext "basicConstraints=critical,CA:TRUE" \
     -addext "keyUsage=critical,keyCertSign,cRLSign" \
     -addext "subjectKeyIdentifier=hash"
   
   # サーバー証明書用の拡張ファイル。-extfile を使用することで（OpenSSL 3.0+ 専用の
   # -copy_extensions の代わりに）、
   # OpenSSL 1.1.x でも動作します。
   cat > data/tls.ext <<EOF
   subjectAltName = DNS:${TUNNEL_DOMAIN},DNS:*.${TUNNEL_DOMAIN}
   authorityKeyIdentifier = keyid,issuer
   extendedKeyUsage = serverAuth
   EOF
   
   # CA によって署名されたサーバー証明書
   openssl req -newkey rsa:2048 -nodes \
     -keyout data/tls.key -out /tmp/server.csr \
     -subj "/CN=${TUNNEL_DOMAIN}"
   openssl x509 -req -in /tmp/server.csr \
     -CA data/ca.crt -CAkey data/ca.key -CAcreateserial \
     -out data/tls.crt -days 90 \
     -extfile data/tls.ext
   
   # 非 root のプロキシコンテナ（UID 65532）がバインドマウントから鍵を読み取れるようにします。
   # world-read ビットがないと、コンテナはホスト所有のファイルを
   # 開くことができません。
   chmod 644 data/tls.key

   
3. 3

   ConsoleにCA証明書を登録する

   トンネルの詳細ページで Certificates セクションまでスクロールし、Add certificate をクリックします。Choose file でdata/ca.crtを直接アップロードする（モーダルウィンドウは.pem、.crt、.cerを受け付けます）か、その内容を貼り付けます。

   cat data/ca.crt

   

   証明書が登録されると、トンネル名の横にある Needs certificate バッジが消えます。CA証明書を追加するを参照してください。

4. 4

   プロキシ設定を作成する

   tunnel_domain は必須です。プロキシはこれを使用して、routes でサブドメインを検索する前に受信ホスト名からドメインサフィックスを取り除きます。routes はサブドメインからアップストリームURLへのフラットなマップであり、リストではありません。

   cat > config/mcp-proxy.yaml <<EOF
   listen_addr: ":8080"
   log_level: info
   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

   docker-compose.yamlを作成する

   network_mode: "service:mcp-proxy" 設定により、cloudflaredがプロキシのネットワーク名前空間に配置され、cloudflaredコンテナ内の localhost:8080 がプロキシに到達するようになります。--url http://localhost:8080 フラグはcloudflaredに転送先を指定します。このフラグがないと、cloudflaredは受信リクエストのルートを持たず、503を返します。

   cat > docker-compose.yaml <<'EOF'
   services:
     cloudflared:
       image: cloudflare/cloudflared@sha256:0e56c13c7058fcef9c4f0e7d83372f82330548dbf8f8b366f3d8b506526d93b2
       # --url は必須です。手動フローでは ingress ルールがプッシュされないため、
       # これがないと cloudflared はすべてのリクエストに 503 を返します。
       command: tunnel --no-autoupdate run --url http://localhost:8080
       environment:
         - TUNNEL_TOKEN
       # localhost:8080 でプロキシに到達できるよう、プロキシの netns を共有します。
       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:d243d30642d39857a0579e465cb3b9bf3ae7c1141e83143bb6856777a31467a5
       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

   
6. 6

   デプロイを開始する

   docker compose up -d

   