Como conectar no OpenAI Codex CLI (terminal)

Versão terminal do Codex da OpenAI. Mesmo Bearer token do Desktop, mas configurado em arquivo.

1. Crie uma chave em https://jusratio.com.br/app/chaves

Copie o token jusmcp_.... Mostrado uma única vez — salve em gerenciador de senhas.

2. Exporte como variável de ambiente

Linux/Mac (bash/zsh):

export JUSRATIO_MCP_TOKEN="jusmcp_chave_completa_aqui"

Adicione ao ~/.zshrc ou ~/.bashrc pra persistir entre sessões.

Windows PowerShell:

setx JUSRATIO_MCP_TOKEN "jusmcp_chave_completa_aqui"

Feche e abra o terminal de novo.

3. Edite ~/.codex/config.toml

Crie o arquivo se não existir. Adicione:

 [mcp_servers.jusratio]
url = "https://mcp.jusratio.com.br/mcp"
bearer_token_env_var = "JUSRATIO_MCP_TOKEN"

bearer_token_env_var faz o Codex ler o token da variável de ambiente em runtime — você não cola a chave no arquivo.

Se já tem outros servidores MCP, adicione [mcp_servers.jusratio] como mais uma seção no mesmo arquivo.

4. Teste a conexão

Rode codex no terminal. Numa sessão nova:

"Use o JusRatio e responda sobre dano moral em atraso de voo segundo o STJ."

Se o Codex chamar a tool pesquisar_documentos, está conectado.

Variável não foi lida: confirme com echo $JUSRATIO_MCP_TOKEN. Se vazio, refaça e abra terminal novo.
TOML inválido: rode codex --help. Se há erro de parsing, ele aparece nas mensagens de inicialização.
401/Unauthorized: chave inválida ou revogada. Crie nova em https://jusratio.com.br/app/chaves.

Atualizado em: 16/05/2026

Este artigo foi útil?

Obrigado!