Conectores personalizados usando MCP remoto estão disponíveis no Claude, Cowork e Claude Desktop para usuários nos planos Free, Pro, Max, Team e Enterprise. Usuários do plano Free estão limitados a um conector personalizado. Este recurso está atualmente em beta.
Criando servidores MCP remotos
Para começar com servidores remotos, comece com os seguintes recursos:
A especificação de autenticação, especialmente detalhes sobre o fluxo de autenticação para serviços de terceiros.
Os exemplos de servidor remoto nos SDKs TypeScript e Python.
As implementações de autenticação de cliente e servidor nos SDKs TypeScript e Python.
O roteiro oficial do MCP e o changelog da especificação de rascunho para detalhes sobre como o protocolo evoluirá.
Outros recursos (como este) também podem ser úteis para aprender sobre considerações ao criar, implantar e solucionar problemas de servidores remotos.
Além disso, algumas soluções como Cloudflare fornecem hospedagem de servidor MCP remoto com dimensionamento automático integrado, gerenciamento de token OAuth e implantação.
Suporte MCP
Plataformas
Servidores MCP remotos são suportados no Claude e Claude Desktop para planos Pro, Max, Team e Enterprise.
Para configurar servidores MCP remotos para uso no Claude Desktop, adicione-os via Personalizar > Conectores. O Claude Desktop não se conectará a servidores remotos que estão configurados diretamente via
claude_desktop_config.json.
A partir de julho, Claude para iOS e Android também suportam servidores MCP remotos!
Os usuários podem usar ferramentas, prompts e recursos de servidores remotos que já adicionaram via claude.ai. Os usuários não podem adicionar novos servidores diretamente do Claude Mobile.
Acessibilidade de rede
Todas as conexões MCP remotas originam-se da infraestrutura em nuvem da Anthropic, independentemente de qual cliente Claude o usuário está executando. Seu servidor deve aceitar conexões HTTPS de entrada dos intervalos de IP da Anthropic—veja endereços IP da Anthropic para a lista atual.
Isso se aplica mesmo quando os usuários estão executando Cowork ou Claude Desktop localmente. Conectores remotos adicionados através de Personalizar > Conectores são intermediados no lado do servidor, portanto a solicitação para seu servidor MCP vem da Anthropic, não da máquina do usuário.
Se seu servidor é executado dentro de uma rede privada, configure seu firewall ou entrada para permitir tráfego de entrada dos intervalos de IP publicados da Anthropic. Servidores que são apenas acessíveis via VPN ou atrás de um firewall que bloqueia os IPs de saída da Anthropic falharão ao conectar.
Transporte e autenticação
Claude suporta servidores remotos baseados em SSE e Streamable HTTP, embora o suporte para SSE possa ser descontinuado nos próximos meses.
Claude suporta servidores remotos sem autenticação e baseados em OAuth.
Suporte de autenticação
Claude suporta a especificação de autenticação 3/26 e (a partir de julho) a especificação de autenticação 6/18.
Claude suporta Registro Dinâmico de Cliente (DCR).
Servidores OAuth podem sinalizar ao Claude que um cliente DCR foi deletado e que Claude deve re-registrar o cliente retornando um HTTP 401 com um erro de invalid_client do endpoint de token, conforme descrito em RFC 6749.
A partir de julho, os usuários também podem especificar um ID de cliente e segredo de cliente personalizados ao configurar um servidor que não suporta DCR.
A URL de callback OAuth do Claude é https://claude.ai/api/mcp/auth_callback e seu nome de cliente OAuth é Claude.
Esta URL de callback pode mudar para https://claude.com/api/mcp/auth_callback no futuro – se você optar por colocar na lista de permissões URLs de callback de cliente MCP, coloque também esta URL de callback na lista de permissões para garantir que seu servidor continue funcionando com Claude.
Claude suporta expiração e atualização de token – servidores devem suportar essa funcionalidade para fornecer a melhor experiência para os usuários.
Veja aqui os endereços IP usados pelo Claude para conexões de entrada e saída para servidores MCP. Desenvolvedores de servidor que desejam desautorizar clientes MCP não-Claude podem colocar na lista de permissões esses endereços IP, a URL de callback OAuth do Claude e/ou o nome do cliente OAuth do Claude.
Recursos do Protocolo
Claude suporta ferramentas, prompts e recursos.
Claude suporta resultados de ferramentas baseados em texto e imagem.
Claude suporta recursos baseados em texto e binários.
Claude ainda não suporta subscrições de recursos, amostragem e outros recursos mais avançados ou de rascunho.
Testando servidores MCP remotos
A melhor maneira de testar e validar um servidor é tentar adicioná-lo ao Claude.
Alternativamente, use a ferramenta inspector. Isso permitirá que você valide:
que seu servidor inicia e conclui com sucesso o fluxo de autenticação.
que seu servidor implementa corretamente várias partes do fluxo de autenticação.
quais ferramentas, prompts, recursos e outros recursos MCP seu servidor expõe.
Veja a documentação do MCP para mais detalhes sobre como usar o inspector e para outras dicas sobre como depurar e solucionar problemas do seu servidor.
Além disso, outras soluções como AI Playground da Cloudflare permitem que você teste a funcionalidade do servidor MCP remoto.