Implantar túneis MCP com Docker Compose

Este caminho requer que o host tenha um provedor de identidade OIDC (como um servidor de metadados de VM em nuvem ou SPIFFE). Se não tiver, use a aba Sem acesso programático.

O componente de setup usa Workload Identity Federation para buscar o token do túnel, gerar uma CA e um certificado de servidor e registrar a CA na Anthropic.

1. 1

   Prepare o diretório de implantação

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

   

   Os contêineres são executados como o UID não-root 65532 e precisam de acesso de escrita a data/.

2. 2

   Escreva o docker-compose.yaml

   O arquivo compose fixa as imagens por digest SHA-256, executa cada contêiner como não-root com um sistema de arquivos somente leitura, remove todas as capabilities do Linux e desativa a escalada de privilégios.

   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
       # Compartilha o netns do proxy para que localhost:8080 o alcance.
       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

   

   Se você estiver usando o servidor MCP de exemplo, adicione-o como um serviço:

   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

   Provisione o túnel

   Defina os identificadores. Deixe TUNNEL_ID sem definir para que o componente de setup crie um túnel; defina-o para anexar a um túnel existente do Console:

   # export TUNNEL_ID=tnl_...   # defina para anexar a um túnel existente
   export ANTHROPIC_FEDERATION_RULE_ID=fdrl_...
   export ANTHROPIC_ORGANIZATION_ID=00000000-0000-0000-0000-000000000000

   

   Se sua regra de federação tiver escopo em um workspace diferente do padrão da sua organização, defina também ANTHROPIC_WORKSPACE_ID=wrkspc_...; caso contrário, o componente de setup usa o workspace padrão. Um túnel criado automaticamente é criado nesse workspace.

   Defina ANTHROPIC_IDENTITY_TOKEN como um JWT OIDC do provedor de identidade deste host. Siga o guia de WIF para o seu provedor para registrar o emissor, definir o subject da regra e emitir o token; a audience da regra deve corresponder à audience que você solicita ao emitir.

   Execute o componente de setup:

   docker compose run --rm setup

   

   setup init é idempotente sobre data/: executá-lo novamente reutiliza o ID do túnel e a CA já armazenados ali e nunca cria um segundo túnel. Uma nova CA é gerada e registrada somente quando data/ está vazio ou TUNNEL_ID mudou; nesse caso, aplica-se o limite de dois certificados ativos, então revogue um no Console primeiro se ambos os slots estiverem ocupados.

   Consulte Falhas de autenticação do componente de setup se ocorrer erro.

   Recupere o domínio do seu túnel e exporte-o para as etapas posteriores:

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

   
4. 4

   Escreva a configuração do proxy

   tunnel_domain é obrigatório: o proxy o usa para remover o sufixo de domínio dos hostnames recebidos antes de procurar o subdomínio em routes. routes é um mapa plano de subdomínio para URL upstream, não uma lista.

   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

   

   A rota echo: aponta para o servidor MCP de exemplo; substitua-a por (ou adicione) suas próprias rotas. Consulte a referência de configuração do proxy para todos os campos disponíveis.

5. 5

   Inicie a implantação

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

   