O conector do Claude não funciona? Dois erros explicados

O Claude mostra dois erros principais quando um conector personalizado falha: "Couldn't reach the MCP server" (Não foi possível acessar o servidor MCP) e "Authorization with the MCP server failed" (Falha na autorização com o servidor MCP). A maioria das causas está do lado do servidor, então os passos úteis são poucos. Confira se a URL é exatamente a que o serviço forneceu a você e se o seu plano ou a configuração do administrador permite conectores personalizados. Remova o conector e adicione de novo. Depois copie o ID de referência que começa com ofid_ e envie para quem administra o servidor.

Pontos principais

• Duas mensagens cobrem a maioria das falhas de conexão. Uma terceira, "Unexpected error while invoking tool" (Erro inesperado ao invocar a ferramenta), significa que o conector está conectado e que uma chamada de ferramenta falhou.
• A página de solução de problemas da Anthropic diz que "Couldn't reach" "nem sempre é uma falha de rede", e que a página foi escrita para o desenvolvedor do servidor, não para você.
• No plano Free você pode adicionar um conector personalizado. Em um plano Team, só os Owners e Primary Owners podem adicionar um.
• Para mudar as configurações de um conector personalizado, você o remove e o adiciona de novo. Não há botão de editar.
• Uma URL de servidor que redireciona para outro host perde o cabeçalho de login no caminho, e o Claude então mostra o erro de autorização. Só o dono do servidor pode informar a URL correta, e talvez você precise adicionar o conector de novo com ela.
• O ID ofid_ do erro tem prazo de validade. Copie logo depois da falha.

O que significam os dois erros do conector do Claude?

Um conector personalizado é um serviço que você adiciona ao Claude pela sua URL, usando o Model Context Protocol (MCP). O Claude não chama o serviço a partir do seu computador. A página de solução de problemas da Anthropic diz que os conectores no claude.ai "rodam na infraestrutura da Anthropic e acessam seu servidor pela internet pública". Muitas falhas vêm desse fato, porque o servidor precisa estar acessível de fora da sua rede, e não só para você.

A mesma página lista as mensagens e o que cada uma cobre. Ela descreve "Couldn't reach the MCP server" como o erro exibido "quando o Claude não consegue concluir o handshake de conexão", e acrescenta: "Apesar da redação, nem sempre é uma falha de rede". Ela descreve "Authorization with the MCP server failed" como um erro que "normalmente aparece depois que o fluxo OAuth começou". OAuth é o padrão de login que os conectores usam.

Mensagem	Quando aparece	Quem normalmente pode corrigir	Fonte
Couldn't reach the MCP server	O Claude não consegue concluir o handshake de conexão	O desenvolvedor do servidor (DNS, firewall, descoberta do login). Você pode conferir a URL que colou.	Troubleshoot your connector
Authorization with the MCP server failed	O fluxo de login começa, mas não termina, ou a URL redireciona para outro host	O desenvolvedor do servidor (configuração do login, redirecionamento). Você pode fazer login de novo ou adicionar o conector outra vez.	Troubleshoot your connector
Unexpected error while invoking tool	O conector aparece como conectado, mas uma chamada de ferramenta falha	O desenvolvedor do servidor. Este erro não tem ID ofid_.	Troubleshoot your connector

A página é direta sobre o público dela: "Esta página é para o desenvolvedor do servidor MCP". Ela também diz que cada mensagem "cobre várias causas do seu lado", em que "your" significa o desenvolvedor. Por isso, aqui vem uma lista curta de verificações para você, e depois uma lista mais longa de causas do desenvolvedor. A página fica em claude.com/docs/connectors/building/troubleshooting.

O que você mesmo pode verificar?

Estes cinco passos seguem a ajuda e as páginas de teste e solução de problemas da Anthropic. Eles não precisam de ferramentas de desenvolvedor.

1. Plano e função. A página de ajuda da Anthropic diz que os conectores personalizados estão disponíveis "para usuários dos planos Free, Pro, Max, Team e Enterprise", que "usuários Free são limitados a um conector personalizado", e que "somente 'Owners' (proprietários) e 'Primary Owners' (proprietários principais) podem adicioná-los aos planos Team". No Enterprise, a página também menciona pessoas com uma função personalizada que inclui "Manage access to Libraries" (Gerenciar acesso às bibliotecas). Se você está no Team e não é Owner, peça a um Owner para adicionar.
2. A URL, exatamente como o serviço a fornece. Cole a URL inteira, com o caminho. Se a página do próprio serviço indicar um segundo endereço, como um com www. na frente, use o que o serviço indicar. Uma URL que redireciona para outro host é uma causa conhecida do erro de autorização (veja o exemplo prático mais abaixo).
3. Remova e adicione de novo. A página de ajuda diz: "Se você quer editar um conector personalizado, primeiro precisa removê-lo e depois adicioná-lo de novo com os dados atualizados". Na web e no aplicativo de desktop, usuários Pro e Max individuais encontram os conectores em "Customize" (Personalizar) > "Connectors" (Conectores). Owners de Team e Enterprise usam "Organization settings" (Configurações da organização) > "Connectors" (Conectores).
4. Faça login de novo quando o Claude pedir. A página de testes da Anthropic diz que um conector funcionando mostra "Connected" (Conectado) em "Your connectors" (Seus conectores). Se mostrar "Connect" (Conectar) ou "Reconnect" (Reconectar), "o login não foi concluído". Conclua a etapa de login e depois confira o status de novo.
5. Copie o ID ofid_. Ele está na mensagem de erro e no endereço da página. Copie antes de fechar a aba.

Nada nessas páginas sugere desligar uma proteção do navegador, um firewall ou uma etapa de login. Se uma etapa pedir isso, pare e consulte o provedor do serviço.

O que só o desenvolvedor do servidor pode corrigir?

Quando as cinco verificações não ajudam, a causa costuma estar na configuração do servidor. Você não precisa corrigir estas causas, mas conhecê-las mostra o que pedir. A tabela segue a página de solução de problemas da Anthropic, em linguagem simples.

Causa	O que o Claude faz	Verificação do desenvolvedor
O nome do host resolve para um endereço privado	Recusa a conexão antes que qualquer requisição saia da Anthropic. Os logs do servidor não veem nada.	Consulte o nome do host de fora da rede. Todos os endereços devem ser roteáveis globalmente.
Uma regra de firewall ou de bots bloqueia a Anthropic	A requisição é interrompida antes que a aplicação a veja.	Procure respostas 403 ou 429 nos logs de borda (edge). Libere a faixa de IP publicada pela Anthropic.
A URL redireciona para outro host	Descarta o cabeçalho de login no redirecionamento. O destino responde 401. O Claude mostra o erro de autorização.	Faça a requisição à URL e leia o destino do redirecionamento. Registre essa URL.
Faltam os dados de descoberta do login	Não consegue encontrar o servidor de autorização. Pode mostrar "Couldn't reach" mesmo que o endpoint responda.	Peça os documentos de descoberta de uma rede pública. Eles devem responder 200.
Não há como registrar um cliente	Não consegue obter uma identidade de cliente, então o login não pode começar.	Ofereça registro dinâmico de cliente, documentos de metadados de ID de cliente ou credenciais pré-registradas.
PKCE com S256 não é suportado	O fluxo falha no endpoint de token.	Suporte S256 e anuncie isso nos metadados do servidor de autorização.
O endpoint de token leva mais de 10 segundos	Espera até 10 segundos pela resposta e depois falha, mesmo que o token seja emitido depois.	Meça o manipulador de token e qualquer proxy à frente dele.

A mesma página lista mais causas do erro de autorização, como incompatibilidade de emissor, incompatibilidade de audiência e falhas na renovação de tokens. A lista de diagnóstico dela segue a ordem em que o Claude passa por cada etapa. Uma das verificações é uma requisição simples para ver os cabeçalhos de redirecionamento:

curl -sI https://your-server.example.com/your-mcp-path

Se a resposta for um 3xx apontando para outro host, "esse destino é a URL que você deve registrar". A página de solução de problemas diz que as requisições de saída da Anthropic vêm de uma faixa publicada, que a Anthropic lista na sua página de endereços IP. A especificação de autorização do MCP diz que servidores MCP "MUST implement" OAuth 2.0 Protected Resource Metadata, definido na RFC 9728. Esses metadados são o que as linhas de "descoberta" acima mencionam.

O que é o ID de referência ofid_ e quem o recebe?

Quando uma conexão ou um login falha no claude.ai, a página da Anthropic diz que "a mensagem de erro e a URL da página incluem um ID de referência que começa com ofid_". O ID "permite à Anthropic rastrear a falha exata do lado dela, e tem prazo de validade, então relate logo depois da falha".

O caminho da Anthropic para um relato é uma issue no rastreador de issues anthropics/claude-ai-mcp, com o ID, a URL do servidor e o que os logs do servidor mostram durante a tentativa. A página é voltada para desenvolvedores, que podem fornecer esses logs. Você não pode. Por isso, a ordem que sugerimos é esta: envie primeiro o ID, a mensagem exata e o horário ao provedor do serviço. Se o provedor não encontrar nada do lado dele, ele abre a issue. Se você mesmo abrir, o rastreador pode ser lido sem login, então deixe de fora dados pessoais e qualquer token.

Uma falha em chamada de ferramenta é diferente. A Anthropic diz que "não há ID de referência ofid_" para esse erro. Um relato desse erro leva o nome da ferramenta e o horário da falha em UTC.

Exemplo: uma URL que redireciona para www

Exemplo prático (hipotético): um serviço manda você adicionar https://example.com/mcp. Nada aqui é saída real de servidor. Ele só percorre um erro, da mensagem até a causa.

1. Mensagem: você adiciona a URL e clica em Connect. O Claude mostra "Authorization with the MCP server failed". Para o desenvolvedor, funciona no MCP Inspector ou no Claude Code.
2. Causa: o servidor responde 301 e envia os clientes para https://www.example.com/mcp. A página da Anthropic explica o resto: o Claude segue o redirecionamento, descarta o cabeçalho de login, o destino responde 401 e aparece o erro de autorização. Clientes locais "falham rápido em um redirecionamento", e o claude.ai não, então a falha aparece depois, como erro de autorização.
3. Verificação: curl -sI https://example.com/mcp retorna um status 3xx e um cabeçalho Location no host www..
4. Correção: o desenvolvedor confirma a URL final. Você remove o conector e o adiciona de novo com https://www.example.com/mcp.

A página da Anthropic inclui o redirecionamento entre as causas do erro de autorização. Por isso, vale pedir ao dono para fazer a verificação do passo 3.

Isso explica o relato comum de que um conector funciona no MCP Inspector ou no Claude Code, mas não no claude.ai. A página dá também outro motivo: "a CLI e o curl se conectam a partir da sua máquina, enquanto o claude.ai se conecta a partir dos servidores da Anthropic". Se um nome de host resolve de um jeito dentro da rede de uma empresa e de outro jeito fora, o claude.ai pode obter um endereço privado e mostrar "Couldn't reach".

O que você deve saber antes de conectar um conector personalizado?

Um conector personalizado pode ser qualquer serviço cujo dono publique uma URL. A página de ajuda da Anthropic diz que os conectores personalizados ligam o Claude a serviços arbitrários que a Anthropic não revisou. Ela também alerta: "Servidores MCP maliciosos podem incluir instruções ocultas que tentam fazer o Claude executar ações não pretendidas".

A página dá dois hábitos. Revise cada pedido de aprovação de ferramenta antes de permitir: "Revise com cuidado os pedidos de aprovação de ferramentas do Claude". Escolha "Allow always" (Permitir sempre) só para servidores e ferramentas em que você confia. Adicione um conector somente quando souber quem administra o serviço e o que ele pode fazer com os seus dados. A página fica em Get started with custom connectors using remote MCP.

E se for o conector do Remembite?

A URL do conector do Remembite é https://remembite.com/mcp. Ele funciona no Claude, inclusive no aplicativo do iPhone. Também funciona no ChatGPT (beta, pelo modo desenvolvedor): soluções para o ChatGPT. Comece pelo guia que corresponde ao que você vê:

• Conectado, mas o Claude não lista ferramentas do Remembite: O conector do Remembite não mostra ferramentas.
• O Claude pede para conectar ou autorizar de novo: O Claude pede para conectar o Remembite de novo.
• Primeira configuração, passo a passo: conecte o Remembite ao Claude.
• Ainda travado depois dessas páginas: suporte do Remembite. Inclua a mensagem exata e o ID ofid_.

Sua IA faz as contas. O Remembite guarda o registro. O conector é o elo entre os dois, então, para um passo a passo de registro de refeições com o Claude, leia como registrar refeições com o Claude. Para entender como as peças se encaixam, leia como o Remembite funciona. Para saber o que é um servidor MCP, leia o guia do servidor MCP de nutrição.

O que esta página não cobre?

• As páginas da Anthropic mudam. Todas as citações aqui foram lidas em 18 de out. de 2026. Se um nome de menu ou um limite for diferente quando você ler isto, vale a página da Anthropic.
• Não reproduzimos esses erros. As causas vêm das páginas da Anthropic e da especificação do MCP, não dos nossos próprios testes.
• Esta página trata de conectores personalizados. Os conectores do diretório da Anthropic são um caso à parte.
• Ela não faz nenhuma afirmação sobre um servidor específico, inclusive se um serviço é bem administrado ou continua no ar.
• A lista de verificações para você é curta de propósito. Ela contém apenas passos que uma página da Anthropic sustenta.

Perguntas frequentes

Por que meu conector personalizado do Claude não funciona?

O Claude alcança o servidor a partir da infraestrutura da Anthropic, então um endereço privado, uma regra de firewall, um redirecionamento ou um problema de configuração do login no servidor podem impedir o acesso. Confira seu plano, a URL exata e se o login foi concluído. Depois, adicione o conector de novo e envie o ID ofid_ ao dono do servidor.

Por que funciona no Claude Code ou no MCP Inspector, mas não no Claude?

A Anthropic diz que as ferramentas locais se conectam a partir da sua máquina e que o claude.ai se conecta a partir dos servidores da Anthropic. Um nome de host que resolve de forma diferente fora da sua rede, ou uma URL que redireciona para outro host, aparece só no claude.ai.

O que é o ID ofid_ no erro?

É um ID de referência na mensagem de erro e na URL da página, que permite à Anthropic rastrear uma conexão que falhou. Ele tem prazo de validade, então copie logo após a falha e entregue ao provedor do serviço.

Preciso de um plano pago para adicionar um conector personalizado?

A página de ajuda da Anthropic, lida em 18 de out. de 2026, lista os planos Free, Pro, Max, Team e Enterprise. O Free é limitado a um conector personalizado. As regras dos planos podem mudar, então confira a página.

Por que não consigo adicionar um conector em um plano Team?

A página de ajuda diz que somente Owners e Primary Owners podem adicionar conectores personalizados a planos Team. Peça a um Owner para adicionar em "Organization settings" (Configurações da organização) > "Connectors" (Conectores).

São estimativas, não aconselhamento médico. As citações de terceiros neste texto são traduções nossas do inglês. Como os números funcionam.