> ## Knowledge Base Index
> Fetch the complete knowledge base index at: https://suporte.jusratio.com.br/sitemap.xml
> Use this file to discover available pages before exploring further.
> Pure-Markdown content can be obtained by appending a '.md' suffix to the content URLs listed in the sitemap (without the trailing slash).

# 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.