Despliega túneles MCP con Docker Compose

Esta ruta requiere que el host tenga un proveedor de identidad OIDC (como un servidor de metadatos de VM en la nube o SPIFFE). Si no lo tiene, usa la pestaña Sin acceso programático en su lugar.

El componente de configuración usa Workload Identity Federation para obtener el token del túnel, generar una CA y un certificado de servidor, y registrar la CA con Anthropic.

1. 1

   Prepara el directorio de despliegue

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

   

   Los contenedores se ejecutan como el UID no root 65532 y necesitan acceso de escritura a data/.

2. 2

   Escribe docker-compose.yaml

   El archivo compose fija las imágenes por digest SHA-256, ejecuta cada contenedor como no root con un sistema de archivos de solo lectura, elimina todas las capacidades de Linux y deshabilita la escalada de privilegios.

   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
       # Comparte el netns del proxy para que localhost:8080 lo 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

   

   Si estás usando el servidor MCP de ejemplo, agrégalo como un servicio:

   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

   Aprovisiona el túnel

   Establece los identificadores. Deja TUNNEL_ID sin definir para que el componente de configuración cree un túnel; defínelo para conectarte a un túnel existente desde la Console:

   # export TUNNEL_ID=tnl_...   # configúralo para conectarte a un túnel existente
   export ANTHROPIC_FEDERATION_RULE_ID=fdrl_...
   export ANTHROPIC_ORGANIZATION_ID=00000000-0000-0000-0000-000000000000

   

   Si tu regla de federación está limitada a un workspace distinto del predeterminado de tu organización, establece también ANTHROPIC_WORKSPACE_ID=wrkspc_...; de lo contrario, el componente de configuración usa el workspace predeterminado. Un túnel creado automáticamente se crea en ese workspace.

   Establece ANTHROPIC_IDENTITY_TOKEN con un JWT OIDC del proveedor de identidad de este host. Sigue la guía de WIF para tu proveedor para registrar el emisor, establecer el sujeto de la regla y emitir el token; la audiencia de la regla debe coincidir con la audiencia que solicitas al emitirlo.

   Ejecuta el componente de configuración:

   docker compose run --rm setup

   

   setup init es idempotente sobre data/: volver a ejecutarlo reutiliza el ID del túnel y la CA ya almacenados allí y nunca crea un segundo túnel. Solo se genera y registra una nueva CA cuando data/ está vacío o TUNNEL_ID ha cambiado; en ese caso se aplica el límite de dos certificados activos, así que revoca uno en la Console primero si ambos espacios están ocupados.

   Consulta Fallos de autenticación del componente de configuración si produce errores.

   Obtén el dominio de tu túnel y expórtalo para los pasos posteriores:

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

   
4. 4

   Escribe la configuración del proxy

   tunnel_domain es obligatorio: el proxy lo usa para eliminar el sufijo de dominio de los nombres de host entrantes antes de buscar el subdominio en routes. routes es un mapa plano de subdominio a URL upstream, no una 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

   

   La ruta echo: apunta al servidor MCP de ejemplo; reemplázala con (o agrega) tus propias rutas. Consulta la referencia de configuración del proxy para ver todos los campos disponibles.

5. 5

   Inicia el despliegue

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

   