Não consegui conectar — checklist

Checklist genérico (vale pra qualquer cliente de IA)

1. Você está logado na conta JusRatio?

Acesse https://jusratio.com.br/app. Se redirecionou pra login, faça login. Se já está logado, OK.

2. Você criou uma chave (se cliente exige Bearer token)?

Claude Desktop NÃO exige (login via navegador). Os outros (Codex, Antigravity, Gemini CLI) exigem.

Em https://jusratio.com.br/app/chaves, deve haver pelo menos uma chave ativa (status "Ativa"). Se houver, ela já existe — pegue o prefixo jusmcp_xxxx... e confira se é a que você está usando.

3. A URL está correta?

https://mcp.jusratio.com.br/mcp — exatamente assim. Não use http:// (sem s), nem mcp.jusratio.com (sem .br), nem mcp.jusratio.com.br (sem /mcp final).

4. Variável de ambiente foi lida?

Pros clientes que usam Bearer (Codex, Gemini CLI), abra novo terminal e rode:

• Linux/Mac: echo $JUSRATIO_MCP_TOKEN
• Windows: echo $env:JUSRATIO_MCP_TOKEN

Se sair vazio: a variável não persistiu. Refaça export/setx e abra terminal NOVO.

5. Você reiniciou o cliente de IA?

Muitos só leem env var no startup. Feche e abra de novo o Claude Desktop / Codex / Antigravity.

6. Erro específico?

• 401 Unauthorized: chave inválida ou revogada → revogue e crie nova em https://jusratio.com.br/app/chaves
• 404 Not Found: URL errada → confira
• Connection refused: problema de rede ou firewall corporativo bloqueando mcp.jusratio.com.br → teste de outra rede

Ainda não funcionou?

Manda mensagem aqui no chat com:

• Qual cliente de IA você está usando
• Em qual passo travou
• Mensagem de erro exata (printar pode ajudar)

Resolvemos juntos.

Atualizado em: 16/05/2026