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

# Como conectar no OpenAI Codex CLI (terminal)

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

### Pré-requisitos

* **Codex CLI** instalado. Veja https://developers.openai.com/codex/cli/reference
* **Conta Jusratio** — criada em https://jusratio.com.br/login

### Passo a passo

**1. Crie uma chave em&#32;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.

### Não funcionou?

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