Como conectar no OpenAI Codex Desktop
O Codex Desktop é o app oficial da OpenAI pra ChatGPT que aceita servidores MCP. Conexão usa um Bearer token (jeito mais comum em ferramentas dev).
Pré-requisitos
- Codex Desktop instalado (macOS ou Windows). Baixar em https://chat.openai.com/codex
- Conta JusRatio — criada em https://jusratio.com.br/login
Passo a passo
1. Abra o Codex Desktop
Inicie o app.
2. Crie uma chave API no JusRatio
Acesse https://jusratio.com.br/app/chaves e clique em + Criar nova chave. Copie o token que começa com jusmcp_... — você vai usar nos próximos passos.
A chave completa só é mostrada UMA VEZ. Salve em gerenciador de senhas (1Password, Bitwarden) ou anote agora.
3. Grave o token em uma variável de ambiente
Windows PowerShell:
setx JUSRATIO_MCP_TOKEN "jusmcp_chave_completa_aqui"
macOS/Linux:
export JUSRATIO_MCP_TOKEN="jusmcp_chave_completa_aqui"
Reinicie o Codex Desktop depois disso (importante pra ele ler a variável nova).
4. Adicionar Custom MCP Server
No Codex: Settings → Connectors → Add Custom MCP Server e preencha:
- Name: JusRatio
- URL: https://mcp.jusratio.com.br/mcp
- Bearer token environment variable: JUSRATIO_MCP_TOKEN
- Headers: deixe vazio
Atenção: no campo Bearer token environment variable vai o NOME da variável (JUSRATIO_MCP_TOKEN), NÃO o valor da chave (jusmcp_...).
5. Always allow tools
Em Settings → Tools, ative Always allow pro JusRatio.
Como testar
Pergunta no Codex:
"Use o JusRatio e responda sobre indenização por dano moral em atraso de voo segundo o STJ."
Se ver a tool pesquisar_documentos sendo chamada → funcionou.
Não funcionou?
- Codex não autentica: verifique se a variável JUSRATIO_MCP_TOKEN existe (echo $JUSRATIO_MCP_TOKEN no terminal). Se vazio, refaça setx/export + reinicie Codex.
- Codex não chama o JusRatio: peça explicitamente "Use o JusRatio e ..."
Atualizado em: 16/05/2026
Obrigado!