Túneles MCP

Los túneles MCP te permiten conectar Claude a servidores del "Model Context Protocol", o MCP, que se ejecutan dentro de tu red privada. El tráfico fluye a través de una conexión exclusivamente de salida, por lo que no necesitas abrir puertos de entrada en el firewall, exponer servicios a la internet pública ni incluir los rangos de IP de Anthropic en la lista de permitidos de tu origen.

Para conocer la elegibilidad de Zero Data Retention y HIPAA BAA, consulta API y retención de datos.

Cómo funciona

El stack del túnel consta de dos componentes que se ejecutan dentro de tu red:

• cloudflared: el conector de túnel de código abierto de Cloudflare. Inicia conexiones exclusivamente de salida hacia el edge del túnel y transporta tráfico cifrado desde Anthropic hasta tu proxy.
• Proxy: el componente de enrutamiento de Anthropic. Termina el TLS interno, valida que las IP upstream estén dentro de un rango permitido y enruta cada solicitud al servidor MCP upstream correcto según el nombre de host.

Cada servidor MCP que expongas obtiene un nombre de host bajo el dominio de tu túnel (por ejemplo, docs.<your-tunnel-domain>). Adjuntas estos nombres de host a una sesión de Managed Agent en la Consola, o los pasas a la Messages API a través del conector MCP.

Requisitos previos

Antes de desplegar, asegúrate de tener:

• Un destino de despliegue: un clúster de Kubernetes, o una VM con Docker y Docker Compose.
• Un túnel creado en la Claude Console. Consulta Crear un túnel.
• Una forma de que tu stack se autentique ante la Tunnels API. Elige una:
  • Acceso programático (recomendado). Configura Workload Identity Federation cuando crees el túnel. Tu stack genera tokens de API de corta duración desde tu proveedor de identidad, obtiene el token del túnel, y genera y registra un certificado de CA automáticamente. Requiere permiso para administrar reglas de federación, un emisor OIDC registrado y una regla de federación con el scope org:manage_tunnels.
  • Manual. Proporciona credenciales estáticas tú mismo: el token del túnel desde la Consola y un certificado de servidor firmado por una CA que registres allí. Consulta Obtener los detalles de conexión y Agregar un certificado de CA.
• Uno o más servidores MCP ejecutándose en tu red privada. Consulta Servidores MCP remotos para ver ejemplos.
• Conectividad de salida según se indica en Requisitos de red.

Requisitos de red

Modelo de seguridad

Capas de seguridad

Tres capas independientes protegen cada solicitud:

El transporte del túnel se ejecuta en la red de Cloudflare. Dado que el proxy termina el TLS interno usando un certificado que solo tú posees, Cloudflare no puede leer las cargas útiles de las solicitudes ni de las respuestas. Anthropic no se conecta a un túnel hasta que se registra un certificado de CA, por lo que las cargas útiles siempre están cifradas cuando atraviesan la red de Cloudflare. Cloudflare sí recibe metadatos de conexión; consulta Qué puede observar el proveedor de transporte.

Modelo de responsabilidad compartida

Qué puede observar el proveedor de transporte

Cloudflare proporciona el transporte de salida. No puede leer las cargas útiles de las solicitudes ni de las respuestas MCP, pero sí recibe los siguientes metadatos de conexión:

• la dirección IP de salida del host que ejecuta cloudflared
• una huella digital del host de cloudflared
• tiempos de conexión y volumen de bytes
• el subdominio *.tunnel.anthropic.com asignado a tu túnel

El acuerdo de Anthropic con Cloudflare restringe el uso que Cloudflare puede hacer de esta telemetría. Cloudflare actúa como subprocesador para esta vista previa de investigación.

Desplegar un túnel

Si eres nuevo en los túneles MCP, comienza con el quickstart para obtener un túnel funcional localmente antes de configurar un despliegue de producción.

Cómo elegir entre ellos:

• Destino de despliegue
  • Helm cuando despliegues en Kubernetes.
  • Docker Compose para un solo host o pruebas locales.
• Autenticación para la configuración
  • Acceso programático (a través de Workload Identity Federation) cuando tengas un proveedor de identidad OIDC como un clúster de Kubernetes, IAM en la nube o SPIFFE.
  • Credenciales manuales cuando no lo tengas, o cuando estés haciendo pruebas.

Usar los servidores MCP tunelizados

Una vez que tu túnel esté activo (tiene un certificado de CA activo y tu stack del túnel está conectado), los servidores MCP upstream son accesibles desde Claude Managed Agents y la Messages API.

En ambos casos, el túnel transporta tráfico cifrado a tu servidor MCP pero no se autentica ante él. Si el servidor MCP upstream requiere su propia autenticación (OAuth, bearer token), proporciónala de la misma manera que lo harías para cualquier otro servidor MCP; es independiente del túnel.

Managed Agents (Consola)

1. En Managed Agents > Sessions, crea una sesión y elige Create new agent para poder editar la lista de servidores MCP.
2. Haz clic en + MCP Server y abre el menú desplegable. Los túneles en el workspace de la sesión que tengan al menos un certificado activo aparecen en la parte superior de la lista, encima del catálogo de conectores públicos.
3. Selecciona el túnel y proporciona el Subdomain que tu proxy enruta a un servidor MCP específico, y el Path que el servidor MCP upstream espera. La línea Resolves to muestra la URL exacta.

Messages API

Pasa la URL del servidor MCP upstream en el array mcp_servers, de la misma manera que cualquier otro servidor MCP remoto. El cuerpo de la solicitud y el encabezado anthropic-beta siguen el formato estándar del conector MCP; solo la url es específica del túnel. El siguiente ejemplo usa el encabezado beta mcp-client del conector MCP, que es independiente del beta mcp-tunnels usado por la Tunnels API. Usa una clave de API para el workspace en el que se creó el túnel (Consola Settings > API keys).

El host de la URL es <subdomain>.<your-tunnel-domain>. La ruta depende de tu servidor MCP upstream, no del túnel: el transporte streamable-http de FastMCP sirve en /mcp, y otros servidores pueden usar / o una ruta personalizada (consulta la documentación del servidor). El proxy reenvía la ruta sin modificarla.

curl https://api.anthropic.com/v1/messages \
  -H "Content-Type: application/json" \
  -H "X-API-Key: $ANTHROPIC_API_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -H "anthropic-beta: mcp-client-2025-11-20" \
  -d '{
    "model": "claude-opus-4-8",
    "max_tokens": 1000,
    "messages": [{"role": "user", "content": "Use the hello tool to greet tunnel."}],
    "mcp_servers": [
      {
        "type": "url",
        "url": "https://echo.YOUR_TUNNEL_DOMAIN_HERE/mcp",
        "name": "echo"
      }
    ],
    "tools": [{"type": "mcp_toolset", "mcp_server_name": "echo"}]
  }'

Para ver ejemplos de SDK en todos los lenguajes, consulta Conector MCP; el único valor específico del túnel es la url.

Próximos pasos