Túneis MCP

Os túneis MCP permitem que você conecte Claude a servidores Model Context Protocol (MCP) que são executados dentro da sua rede privada. O tráfego flui por uma conexão apenas de saída, então você não precisa abrir portas de entrada no firewall, expor serviços à internet pública ou adicionar os intervalos de IP da Anthropic à lista de permissões na sua origem.

Para elegibilidade de Zero Data Retention e HIPAA BAA, consulte API e retenção de dados.



Como funciona

A pilha do túnel consiste em dois componentes que são executados dentro da sua rede:

• cloudflared: o conector de túnel de código aberto da Cloudflare. Ele inicia conexões apenas de saída para a borda do túnel e transporta tráfego criptografado da Anthropic para o seu proxy.
• Proxy: o componente de roteamento da Anthropic. Ele termina o TLS interno, valida que os IPs upstream estão dentro de um intervalo permitido e roteia cada solicitação para o servidor MCP upstream correto com base no hostname.

Cada servidor MCP que você expõe recebe um hostname sob o domínio do seu túnel (por exemplo, docs.<your-tunnel-domain>). Você anexa esses hostnames a uma sessão de Managed Agent no Claude Console, ou os passa para a Messages API por meio do conector MCP.



Pré-requisitos

Antes de implantar, certifique-se de que você tem:

• Um destino de implantação: um cluster Kubernetes, ou uma VM com Docker e Docker Compose.
• Um túnel. Crie um no Claude Console (consulte Criar um túnel) ou por meio da API; o hook de configuração do chart Helm também pode criar um para você durante a instalação.
• Uma forma de a sua pilha se autenticar na Tunnels API. Escolha uma:
  • Acesso programático (recomendado). Configure a Workload Identity Federation ao criar o túnel. Sua pilha emite tokens de API de curta duração a partir do seu provedor de identidade, busca o token do túnel e gera e registra um certificado de CA automaticamente. Requer permissão para gerenciar regras de federação, um emissor OIDC registrado e uma regra de federação com o escopo workspace:manage_tunnels.
  • Manual. Forneça você mesmo credenciais estáticas: o token do túnel do Console e um certificado de servidor assinado por uma CA que você registra lá. Consulte Obter os detalhes de conexão e Adicionar um certificado de CA.
• Um ou mais servidores MCP em execução na sua rede privada. Consulte Servidores MCP remotos para exemplos.
• Conectividade de saída conforme listado em Requisitos de rede.



Requisitos de rede



Modelo de segurança



Camadas de segurança

Três camadas independentes protegem cada solicitação:

O transporte do túnel é executado na rede da Cloudflare. Como o proxy termina o TLS interno usando um certificado que apenas você possui, a Cloudflare não pode ler os payloads de solicitação ou resposta. A Anthropic não se conecta a um túnel até que um certificado de CA seja registrado, então os payloads são sempre criptografados quando atravessam a rede da Cloudflare. A Cloudflare recebe metadados de conexão; consulte O que o provedor de transporte pode observar.



Modelo de responsabilidade compartilhada



O que o provedor de transporte pode observar

A Cloudflare fornece o transporte de saída. Ela não pode ler os payloads de solicitação ou resposta MCP, mas recebe os seguintes metadados de conexão:

• o endereço IP de saída do host que executa o cloudflared
• uma impressão digital do host do cloudflared
• tempo de conexão e volume de bytes
• o subdomínio *.tunnel.anthropic.com atribuído ao seu túnel

O acordo da Anthropic com a Cloudflare restringe o uso dessa telemetria pela Cloudflare. A Cloudflare atua como subprocessadora para esta prévia de pesquisa.



Implantar um túnel

Se você é novo em túneis MCP, comece com o início rápido para obter um túnel funcionando localmente antes de configurar uma implantação de produção.

Como escolher entre eles:

• Destino de implantação
  • Helm ao implantar no Kubernetes.
  • Docker Compose para um único host ou testes locais.
• Autenticação para a configuração
  • Acesso programático (por meio da Workload Identity Federation) quando você tem um provedor de identidade OIDC, como um cluster Kubernetes, IAM de nuvem ou SPIFFE.
  • Credenciais manuais quando você não tem, ou quando está testando.



Usar os servidores MCP tunelados

Assim que o seu túnel estiver ativo (ele tem um certificado de CA ativo e a sua pilha de túnel está conectada), os servidores MCP upstream ficam acessíveis a partir dos Claude Managed Agents e da Messages API.

Em ambos os casos, o túnel transporta tráfego criptografado para o seu servidor MCP, mas não se autentica nele. Se o servidor MCP upstream exigir sua própria autenticação (OAuth, bearer token), forneça-a da mesma forma que faria para qualquer outro servidor MCP; ela é independente do túnel.



Managed Agents (Console)

1. Em Managed Agents > Sessions, crie uma sessão e escolha Create new agent para poder editar a lista de servidores MCP.
2. Clique em + MCP Server e abra o menu suspenso. Os túneis no workspace da sessão que têm pelo menos um certificado ativo aparecem no topo da lista, acima do catálogo público de conectores.
3. Selecione o túnel e forneça o Subdomain que o seu proxy roteia para um servidor MCP específico, e o Path que o servidor MCP upstream espera. A linha Resolves to mostra a URL exata.



Messages API

Passe a URL do servidor MCP upstream no array mcp_servers, da mesma forma que qualquer outro servidor MCP remoto. O corpo da solicitação e o cabeçalho anthropic-beta seguem o formato padrão do conector MCP; apenas a url é específica do túnel. O exemplo a seguir usa o cabeçalho beta mcp-client do conector MCP, que é separado do beta mcp-tunnels usado pela Tunnels API. Use uma chave de API do workspace em que o túnel foi criado (Console Settings > API keys).

O host da URL é <subdomain>.<your-tunnel-domain>. O caminho depende do seu servidor MCP upstream, não do túnel: o transporte streamable-http do FastMCP serve em /mcp, e outros servidores podem usar / ou um caminho personalizado (verifique a documentação do servidor). O proxy encaminha o caminho sem alterações.

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 autenticação no servidor MCP upstream (authorization_token) e outras opções de mcp_servers, consulte Conector MCP.



Próximos passos