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