Túneis MCP

Os túneis MCP permitem que você conecte Claude a servidores Model Context Protocol (MCP) que rodam dentro da sua rede privada. O tráfego flui por uma conexão exclusivamente 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 rodam dentro da sua rede:

• cloudflared: o conector de túnel de código aberto da Cloudflare. Ele inicia conexões exclusivamente 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 encerra o TLS interno, valida que os IPs upstream estão dentro de um intervalo permitido e roteia cada requisição para o servidor MCP upstream correto com base no nome do host.

Cada servidor MCP que você expõe recebe um nome de host sob o domínio do seu túnel (por exemplo, docs.<your-tunnel-domain>). Você anexa esses nomes de host 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 ter:

• 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 Helm chart também pode criar um para você durante a instalação.
• Uma forma de 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 gera 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 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 credenciais estáticas você mesmo: o token do túnel do Console e um certificado de servidor assinado por uma CA que você registra lá. Consulte Obter os detalhes da conexão e Adicionar um certificado 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 requisição:

O transporte do túnel roda na rede da Cloudflare. Como o proxy encerra o TLS interno usando um certificado que somente você possui, a Cloudflare não consegue ler os payloads de requisição ou resposta. A Anthropic não se conecta a um túnel até que um certificado CA seja registrado, então os payloads estã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 consegue ler os payloads de requisiçã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 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 subprocessador para este research preview.

Implantar um túnel

Se você é novo nos túneis MCP, comece pelo quickstart para obter um túnel funcional localmente antes de configurar uma implantação de produção.

Escolhendo entre eles:

• Destino de implantação
  • Helm ao implantar no Kubernetes.
  • Docker Compose para um único host ou testes locais.
• Autenticação para 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 seu túnel estiver ativo (ele tem um certificado CA ativo e 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. Túneis no workspace da sessão que tenham pelo menos um certificado ativo aparecem no topo da lista, acima do catálogo de conectores públicos.
3. Selecione o túnel e forneça o Subdomain que 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 requisiçã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. Faça a requisição no workspace em que o túnel foi criado usando uma chave de API para esse workspace ou, se sua chave tiver acesso a múltiplos workspaces, definindo o cabeçalho anthropic-workspace-id para esse workspace.

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

Próximos passos