Conectores personalizados usando MCP remoto estão disponíveis no Claude e Claude Desktop para usuários nos planos Pro, Max, Team e Enterprise.
Construindo 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 construir, 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 Configurações > Conectores. 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.
Transporte e Autenticação
Claude suporta servidores remotos baseados em SSE e HTTP Streamable, 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 desabilitar 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 completa 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 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 do Cloudflare permitem que você teste a funcionalidade do servidor MCP remoto.