---
title: Seguridad de los túneles MCP
url: https://platform.claude.com/docs/es/agents-and-tools/mcp-tunnels/security
description: Guía de endurecimiento, rotación de credenciales, respuesta ante brechas y desmantelamiento para implementaciones de túneles MCP.
---

<Note>
  Los "MCP tunnels" (túneles de MCP) están en "research preview" (vista previa de investigación). [Solicita acceso](https://claude.com/form/mcp-tunnels) para probarlos.
</Note>

La arquitectura del túnel proporciona valores predeterminados sólidos (conectividad solo de salida, cifrado de extremo a extremo y validación de IP), pero la seguridad general de tu [pila del túnel](https://platform.claude.com/docs/es/agents-and-tools/mcp-tunnels/concepts#components) (tunnel stack) también depende de cómo la configures y operes. Esta página cubre el endurecimiento recomendado, la respuesta ante brechas y cómo dar de baja un túnel.

## Mejores prácticas

* **Exige OAuth en cada servidor MCP.** Configura cada [servidor MCP upstream](https://platform.claude.com/docs/es/agents-and-tools/mcp-tunnels/concepts#components) para que requiera OAuth como se describe en la [especificación de autorización de MCP](https://modelcontextprotocol.io/specification/2025-11-25/basic/authorization). OAuth proporciona defensa en profundidad sobre la autenticación de transporte del túnel y habilita la autorización a nivel de usuario en la capa de datos.
* **Habilita SSO para tu organización.** Los túneles, las reglas de federación y las cuentas de servicio se administran en la Claude Console. SSO aplica los controles de sesión de tu proveedor de identidad a los administradores que pueden modificarlos.
* **Restringe `upstream.allowed_ips`.** Usa los rangos CIDR más pequeños que cubran tus servidores MCP. Esta es la principal defensa contra SSRF del [proxy](https://platform.claude.com/docs/es/agents-and-tools/mcp-tunnels/concepts#components).
* **Monitorea los registros.** Genera alertas ante advertencias, errores y patrones de tráfico inusuales de la pila del túnel.
* **Rota las credenciales.** Rota el certificado del servidor y el token del túnel de forma periódica, e inmediatamente si sospechas que han sido comprometidos.
* **Mantén las imágenes actualizadas.** Haz seguimiento de las nuevas versiones del proxy y fija las imágenes por su digest SHA-256.
* **Limita el alcance de red.** El proxy y [cloudflared](https://platform.claude.com/docs/es/agents-and-tools/mcp-tunnels/concepts#components) solo deberían poder alcanzar los destinos enumerados en los [requisitos de red](https://platform.claude.com/docs/es/agents-and-tools/mcp-tunnels/overview#network-requirements). Usa NetworkPolicy (Kubernetes) o reglas de firewall del host (Compose).
* **Limita el alcance del servidor MCP.** Cada servidor debería exponer únicamente las herramientas y los datos necesarios para su propósito.
* **Protege las credenciales en reposo.** Aplica las prácticas de gestión de secretos de tu organización a las claves privadas y los tokens del túnel.

## Responder ante una posible brecha

Si crees que tu token del túnel, tus claves TLS o el host del proxy han sido comprometidos:

<Steps>
  <Step title="Detén la pila del túnel">
    <Tabs>
      <Tab title="Helm">
        ```bash
        helm uninstall mcp-tunnel -n mcp-tunnel
        ```
      </Tab>

      <Tab title="Docker Compose">
        ```bash
        docker compose down --timeout 0
        ```
      </Tab>
    </Tabs>
  </Step>

  <Step title="Desvincula los servidores MCP upstream">
    Elimina los servidores MCP upstream de cualquier sesión de Managed Agent que los use, y deja de pasar sus URL en el bloque `mcp_servers` de las solicitudes a la Messages API.
  </Step>

  <Step title="Archiva el túnel">
    Archivar invalida el token del túnel y desvincula el dominio. En la Console, [archiva el túnel](https://platform.claude.com/docs/es/agents-and-tools/mcp-tunnels/console#archive-a-tunnel) desde la lista **MCP tunnels**. Para archivarlo mediante la API en su lugar, consulta [Archivar un túnel](https://platform.claude.com/docs/es/api/beta/tunnels/archive).
  </Step>

  <Step title="Contacta a Anthropic">
    Reporta la posible vulneración al soporte de Anthropic.
  </Step>

  <Step title="Rota las credenciales downstream">
    Vuelve a aprovisionar un túnel nuevo y rota cualquier token OAuth que hayan emitido los servidores MCP afectados.
  </Step>

  <Step title="Revisa los registros antes de restaurar el servicio">
    Inspecciona los registros del proxy, de cloudflared y de los servidores MCP correspondientes al período de la posible vulneración antes de poner en línea el nuevo túnel.
  </Step>
</Steps>

## Desmantelar un túnel

Sigue estos pasos para dar de baja un túnel y eliminar todas las credenciales almacenadas.

<Steps>
  <Step title="Detén la pila del túnel">
    <Tabs>
      <Tab title="Helm">
        ```bash
        helm uninstall mcp-tunnel -n mcp-tunnel
        ```
      </Tab>

      <Tab title="Docker Compose">
        ```bash
        docker compose down
        ```
      </Tab>
    </Tabs>
  </Step>

  <Step title="Archiva el túnel">
    En la Console, [archiva el túnel](https://platform.claude.com/docs/es/agents-and-tools/mcp-tunnels/console#archive-a-tunnel) desde la lista **MCP tunnels**.
  </Step>

  <Step title="Elimina las credenciales almacenadas">
    <Tabs>
      <Tab title="Helm">
        Con acceso programático, el componente de configuración creó un único Secret con el nombre del release. Sin acceso programático, tú mismo creaste `mcp-tunnel-token` y `mcp-tunnel-cert`. Elimina los que correspondan:

        ```bash
        kubectl -n mcp-tunnel delete secret \
          mcp-tunnel mcp-tunnel-token mcp-tunnel-cert \
          --ignore-not-found
        ```
      </Tab>

      <Tab title="Docker Compose">
        Las claves privadas y los certificados se encuentran en `data/`. El token del túnel se encuentra en `data/tunnel-token` (flujo programático) o en el entorno de tu shell (flujo manual). El directorio `config/` y `docker-compose.yaml` no contienen secretos; consérvalos si planeas volver a aprovisionar, o elimínalos también.

        ```bash
        sudo rm -rf data
        ```
      </Tab>
    </Tabs>
  </Step>
</Steps>