Problemas de conexão

Encontre o seu sintoma abaixo. Cada seção diz a causa mais provável e o que fazer.

A regra de ouro

“Conectado, mas sem ferramentas” quase sempre é permissão, não rede. O servidor responde a qualquer cliente que o alcance — o que varia é o que a sua credencial pode ver. Antes de mexer em firewall ou reinstalar o aplicativo, verifique conta, escopo e organização.

Fica em “Conectando…” para sempre

Causa: a janela de login do OpenThor foi fechada antes do fim — ou a sua conta não pertence a nenhuma organização aprovada, então não há o que autorizar.

Solução: refaça a conexão e complete o login até o botão Aprovar acesso. Se a janela nem chega nessa tela, confirme que a sua conta tem uma organização aprovada — Crie sua conta e peça acesso.

Conectou, mas aparece “0 ferramentas”

Causa: o escopo do seu usuário está vazio ou estreito demais, ou o acesso via MCP está desativado na sua credencial. A conexão em si funcionou.

Solução: fale com o administrador da sua organização — ele ajusta o seu escopo em Equipe, no painel. Não é problema de rede, do plano nem do aplicativo; reconectar não muda nada até o escopo mudar.

Causa: você não está logado em app.openthor.dev — a tela de autorização precisa de uma sessão ativa.

Solução: entre primeiro no painel (Enviar código → Confirmar código) e, com a sessão aberta, refaça a conexão no assistente.

Colou a chave em “OAuth Client ID/Secret”

Causa: campo errado. Esses campos avançados servem para registro de cliente OAuth — não têm nada a ver com a chave ot_live_….

Solução: apague e deixe os dois campos vazios. No claude.ai, no ChatGPT e no Claude Desktop não há onde colar chave: o caminho é colar a URL, entrar e aprovar. A chave é só para o Claude Code e a API REST — veja Claude Code e API REST.

O ChatGPT não mostra a opção de criar conector

Causa: o modo desenvolvedor está desligado — ou a conta está no plano Free, que não suporta conectores personalizados.

Solução: ative em Settings → Apps & Connectors → Advanced settings → Developer mode, com um plano pago. Passo a passo em Conectar o ChatGPT.

Claude Code diz “connected”, mas as chamadas dão 401

Causa: algumas versões do Claude Code tinham um defeito em que o cabeçalho configurado não era anexado nas chamadas — ou a chave foi revogada ou expirou.

Solução: atualize o Claude Code para a versão mais recente. Persistiu? Confira a chave em Chaves & Uso no painel — se estiver revogada ou expirada, crie outra e refaça o claude mcp add.

URL errada

Causa: a URL colada não termina em /mcp, ou usa http em vez de https.

Solução: a URL é exatamente https://api.openthor.dev/mcp — com https e terminando em /mcp. Nada a mais, nada a menos.

Ainda travado?

Fale com a gente: Suporte. Diga qual cliente você usa (claude.ai, ChatGPT, Claude Desktop ou Claude Code) e em qual passo parou — resolve mais rápido.

Esta página ajudou? Conte para a gente — lemos tudo.