Túneles MCP

Los túneles MCP te permiten conectar Claude a servidores de Model Context Protocol (MCP) que se ejecutan dentro de tu red privada. El tráfico fluye a través de una conexión de solo salida, por lo que no necesitas abrir puertos entrantes 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 la elegibilidad de Zero Data Retention y HIPAA BAA, consulta API y retención de datos.



Cómo funciona

La pila 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 de solo salida hacia el borde 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 de los 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 expones obtiene un nombre de host bajo tu dominio de túnel (por ejemplo, docs.<your-tunnel-domain>). Adjuntas estos nombres de host a una sesión de Managed Agent en la Claude Console, 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. Crea uno en la Claude Console (consulta Crear un túnel) o a través de la API; el hook de configuración del chart de Helm también puede crear uno por ti durante la instalación.
• Una forma de que tu pila se autentique ante la Tunnels API. Elige una:
  • Acceso programático (recomendado). Configura Workload Identity Federation cuando crees el túnel. Tu pila genera tokens de API de corta duración a partir de 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 alcance workspace:manage_tunnels.
  • Manual. Proporciona tú mismo credenciales estáticas: el token del túnel desde la Console 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 como 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. Debido a 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 cruzan 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 hace de esta telemetría. Cloudflare actúa como subencargado del tratamiento para esta vista previa de investigación.



Desplegar un túnel

Si eres nuevo en los túneles MCP, comienza con el inicio rápido para tener un túnel funcionando localmente antes de configurar un despliegue de producción.

Cómo elegir entre ellos:

• Destino de despliegue
  • Helm cuando despliegas 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 tienes un proveedor de identidad OIDC como un clúster de Kubernetes, IAM en la nube o SPIFFE.
  • Credenciales manuales cuando no lo tienes, 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 pila de túnel está conectada), los servidores MCP upstream son accesibles desde Claude Managed Agents y la Messages API.

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



Managed Agents (Console)

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 espacio de trabajo de la sesión que tienen al menos un certificado activo aparecen en la parte superior de la lista, por 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 espera el servidor MCP upstream. La línea Resolves to muestra la URL exacta.



Messages API

Pasa la URL del servidor MCP upstream en el arreglo 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 distinto de la beta mcp-tunnels usada por la Tunnels API. Usa una clave de API del espacio de trabajo en el que se creó el túnel (Console 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.

client = anthropic.Anthropic()

response = client.beta.messages.create(
    model="claude-opus-5",
    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"}],
    betas=["mcp-client-2025-11-20"],
)

print(response)

Para autenticarte ante el servidor MCP upstream (authorization_token) y otras opciones de mcp_servers, consulta Conector MCP.



Próximos pasos