Conectores do Claude sumiram das configurações, travam em Conectar ou dão erro no meio do chat? Este artigo separa as causas por sintoma: limites do plano, aprovação do administrador, loops de login, servidores inacessíveis, arquivos de configuração incorretos e erros de ferramenta, cada um com uma solução concreta.
Poucas coisas no Claude são tão irritantes quanto um conector que funcionava ontem e sumiu hoje. O menu de Conectores está vazio, o botão Conectar gira para sempre ou uma ferramenta que parecia saudável dá erro no meio de uma conversa. A boa notícia é que quase todos os casos se resumem a um punhado de causas, e você consegue descartá-las em cerca de dez minutos se seguir a ordem certa.
Este artigo segue essa ordem. Começa pelas verificações básicas (plano, configurações de administrador, conta), porque elas explicam a maioria dos relatos de "não aparece", depois passa para falhas de login, alcance dos servidores, erros em arquivos de configuração local e erros que só surgem depois que um conector aparece como conectado. Menus e rótulos mudam com frequência, então, se um botão não estiver onde você espera, procure a área Conectores ou Personalizar nas configurações.
💡 Regra prática: Se o conector não está visível, desconfie do seu plano ou de uma configuração de administrador. Se está visível, mas não conecta, desconfie do login ou do alcance do servidor. Se conecta, mas falha no chat, desconfie da própria chamada da ferramenta.
Comece identificando o sintoma, porque cada um aponta para uma solução diferente:
Conectores, e em especial os conectores personalizados que apontam para um servidor MCP remoto, fazem parte dos planos pagos. Em um plano que não os inclui, a opção Conectores simplesmente não aparece, e nenhuma atualização da página a faz voltar. Abra as configurações da sua conta, confirme qual plano está ativo e compare com o artigo de ajuda oficial sobre conectores. Se você fez upgrade recentemente ou trocou de workspace, saia e entre de novo na conta para que o novo plano seja reconhecido.
Nos planos Team e Enterprise, um Owner ou o Primary Owner precisa habilitar um conector para a organização antes que alguém possa usá-lo. Na área de administração, isso significa abrir a lista de conectores por meio de Browse connectors e escolher Add to your team. Habilitar um conector apenas o torna disponível. Cada pessoa ainda precisa fazer login nele individualmente, então um colega vendo "conectado" não diz nada sobre a sua conta.
Três perguntas que valem a pena fazer ao seu administrador:
Elas levam dois minutos e resolvem uma parcela surpreendente dos casos. Faça-as antes de mexer em qualquer configuração de servidor.
Sessões desatualizadas causam problemas fantasmas. Siga estes passos em ordem e teste após cada um:
Um conector pode estar conectado e, ainda assim, desligado para a conversa em que você está. Abra o menu de ferramentas perto da caixa de mensagem e confirme que o conector está ativado. Depois verifique as permissões de ferramenta: cada ferramenta pode ser configurada para perguntar antes, sempre permitir ou ficar bloqueada. Uma ferramenta bloqueada parece exatamente igual a uma ferramenta ausente.
| Sintoma | Causa mais provável | Correção mais rápida |
|---|---|---|
| Nenhuma opção Conectores nas configurações | Seu plano não inclui a função | Confira o plano, faça upgrade ou peça ao administrador |
| O conector existe para outros, não para você | Nunca fez login, ou não foi adicionado por um Owner | Peça ao Owner que adicione e depois faça login você mesmo |
| O botão Conectar não faz nada | Pop-up bloqueado ou sessão desatualizada | Permita pop-ups, atualize à força e tente de novo |
| Conectado, mas o Claude ignora | Desligado nesta conversa | Ative no menu de ferramentas |
| Funcionava ontem, falha hoje | Token expirado ou revogado | Desconecte e conecte novamente |
Quando o conector está visível, mas o login falha, o problema está entre o seu navegador, a página de login do outro serviço e o Claude.
Ao conectar, abre-se uma página de login de outro serviço: sua agenda, seu CRM ou seu próprio servidor. Se essa janela nunca aparece, fecha na hora ou volta ao início, faça o seguinte:
💡 Reconecte do zero. Remova o conector, feche a aba, entre de novo e adicione-o outra vez. Uma tentativa anterior incompleta pode deixar um estado quebrado que novas tentativas repetidas nunca consertam.
"Authorization with the MCP server failed" costuma aparecer depois que o login já começou. A documentação de solução de problemas de conectores da Anthropic lista estas causas do lado do servidor:
Se você apenas usa o conector de outra pessoa, envie a ela esta lista. Se você administra o servidor, a próxima seção é para você.
Essa mensagem soa como uma queda de rede, mas a causa costuma ser mais discreta. O fato importante: conectores remotos no claude.ai rodam na infraestrutura da Anthropic, não no seu computador. O Claude resolve o nome do host do seu servidor pela internet pública e, se o resultado não for roteável globalmente, rejeita a conexão antes de enviar qualquer solicitação. Os logs de acesso não mostram nada.
O Claude rejeita nomes de host que resolvem para faixas privadas (10.0.0.0/8, 172.16.0.0/12, 192.168.0.0/16), endereços de NAT em nível de operadora (100.64.0.0/10), endereços de loopback ou link-local, ou uma mistura de resultados públicos e privados. Os conectores também funcionam apenas com IPv4, então um host que tenha somente registros AAAA falha.
Isso explica a queixa clássica: "Funciona no Claude Code e no curl, mas não no claude.ai." Essas ferramentas se conectam a partir da sua máquina, enquanto o claude.ai se conecta a partir da nuvem. Se o seu host resolve de um jeito dentro da sua rede e de outro fora dela (split-horizon DNS), ou fica atrás de uma VPN, de um provedor de DNS dinâmico ou de um roteador doméstico com CGNAT, o aplicativo web nunca recebe um endereço utilizável.
Teste a partir de uma rede externa à sua:
dig +short your-server.example.com
Todo endereço retornado precisa ser público. Para um servidor no seu notebook, exponha-o por meio de um túnel público ou de um proxy reverso, em vez de uma URL localhost.
Com o DNS correto, um CDN, um WAF ou um limitador de taxa ainda pode rejeitar a solicitação antes que sua aplicação a veja. Procure respostas 403 ou 429 nos logs de borda durante uma tentativa de conexão e, em seguida, adicione à lista de permissões a faixa de saída publicada na página de endereços IP da Anthropic, ou isente os caminhos do MCP e do login da regra de bloqueio.
Depois, verifique os redirecionamentos:
curl -sI https://your-server.example.com/mcp
Se a resposta for um 301, 302, 307 ou 308 apontando para outro host, registre essa URL de destino. Clientes locais falham logo no redirecionamento, enquanto o claude.ai o segue, perde a credencial e relata um erro de autorização mais tarde.
Quando um servidor exige login, o Claude primeiro consulta seus metadados OAuth. Solicite cada documento a partir de uma rede pública e espere um 200 com JSON válido:
curl -i https://your-server.example.com/.well-known/oauth-protected-resource
curl -i https://your-server.example.com/.well-known/oauth-authorization-server
curl -i https://your-server.example.com/.well-known/openid-configuration
Basta que uma das duas últimas responda. Os metadados também precisam oferecer uma forma de registrar o Claude como cliente (registro dinâmico de cliente, documentos de metadados de ID de cliente ou credenciais pré-registradas) e anunciar suporte a PKCE S256. Um proxy que descarte o cabeçalho WWW-Authenticate, ou que responda 403 em caminhos /.well-known/, produz a mesma mensagem de "não foi possível alcançar", mesmo com um servidor saudável por trás.
O Microsoft Entra merece uma nota à parte. Se a solicitação de token falhar com AADSTS9010010, o Entra está rejeitando o valor de recurso que o Claude envia. Registre a URL completa do seu servidor MCP como Application ID URI no registro do aplicativo de API, usando um domínio personalizado verificado se você estiver em um host de plataforma.
💡 Guarde o ID de referência. Quando uma conexão falha no claude.ai, a URL da página de erro contém um valor que começa com
ofid_. Copie-o imediatamente, porque ele expira, e inclua-o ao abrir um chamado no rastreador anthropics/claude-ai-mcp.
Servidores que rodam na sua própria máquina seguem outro caminho. O aplicativo de desktop os inicia a partir de um arquivo de configuração, então nada passa pela internet e nenhuma das dicas de DNS acima se aplica.
As falhas locais mais comuns são pequenas:
npx ou node funciona no terminal, mas não a partir do app. Use o caminho absoluto do executável.Passe o arquivo por um validador de JSON antes de reiniciar.
O aplicativo de desktop grava os logs do MCP em %APPDATA%\Claude\logs no Windows e em ~/Library/Logs/Claude no macOS, com um log geral do MCP e um arquivo para cada servidor. Um servidor que trava na inicialização costuma registrar o motivo ali: um pacote ausente, a versão errada do Node ou uma variável de ambiente que não existe. No Claude Code, claude mcp list mostra o status de todos os servidores configurados, e /mcp dentro de uma sessão mostra detalhes e permite fazer login.
"Unexpected error while invoking tool", seguido do nome de uma ferramenta, significa que a conexão em si está saudável. A solicitação do Claude chegou ao servidor e o servidor respondeu com um erro. Não há um ID de referência ofid_ aqui, porque nada falhou na hora da conexão.
Restrinja o problema nesta ordem:
Limites de taxa são outro culpado frequente, e parecem aleatórios. Muitos serviços limitam quanto trabalho roda ao mesmo tempo. A própria conexão MCP da PicassoIA é um bom exemplo: seus modelos de imagem, edição de imagem e vídeo compartilham um limite de 5 predições rodando ao mesmo tempo por conta, somando todas as credenciais e conexões MCP. No momento em que este texto foi escrito, você adiciona essa conexão pela página MCP da sua conta, que exige login. Se o Claude disparar dez gerações em uma única solicitação, algumas vão falhar. Peça a ele que trabalhe em lotes menores.
Aqui vai um guia rápido para as mensagens que você mais vai encontrar:
| Mensagem | O que significa | Onde procurar |
|---|---|---|
| Não foi possível conectar ao servidor MCP | O handshake falhou | DNS, firewall, redirecionamentos, metadados do OAuth |
| A autorização com o servidor MCP falhou | O login começou, mas não foi concluído | Emissor, audiência, PKCE, velocidade do token, redirecionamentos |
| Erro inesperado ao invocar a ferramenta | Conectou, mas a chamada da ferramenta falhou | Logs do servidor, MCP Inspector, limites de taxa |
| Nenhuma opção Conectores | Configuração do plano ou da organização | Página do plano, configurações de administrador |
Um conector quebrado não deveria parar o seu dia. Enquanto você o conserta, cole o texto do erro, um trecho de log ou uma captura de tela em um modelo que não dependa de nenhum conector. O Claude Sonnet 5 está disponível na PicassoIA, lida bem com código e tarefas com muitas ferramentas, e aceita imagem como entrada, o que combina com capturas de páginas de erro.
💡 Remova os segredos antes. Tire tokens, client secrets e senhas de qualquer configuração ou log antes de colar em algum lugar.
Antes de fechar a aba de configurações, faça esta checklist final:
ofid_ está salvo caso você precise de suporte
Quando seus conectores voltarem a funcionar, dê a eles algo criativo para fazer. A Picasso IA transforma um prompt curto em uma imagem fotorrealista em segundos com o PicassoIA Image, permite refinar o resultado com o PicassoIA Image Editor Pro e anima uma imagem parada com o PicassoIA Video. Abra a plataforma, escreva um prompt sobre uma cena que você tenha em mente, mude a iluminação ou o ângulo da câmera e execute de novo. Dez minutos de experimentação vão mostrar o que cada modelo faz de melhor, e você pode navegar por todas as opções na página de todos os modelos.
Escolha seu idioma
