CLIENTE MCP
OpenAI Codex

Como instalar no OpenAI Codex (Desktop ou CLI)

Esta página cobre as duas variantes do Codex da OpenAI: o app Desktop (UI) e o CLI (terminal). Pule pra seção do que você está usando.

Codex Desktop

Em 5 minutos você conecta o Jusratio ao Codex Desktop da OpenAI.

Pré-requisitos

Passo a passo

1. Abra o Codex Desktop

Inicie o app.

2. Vá em Settings → Connectors

Clique no menu Settings (ícone de engrenagem), depois selecione a aba Connectors.

3. Crie uma Chave de Acesso Manual

Acesse o painel web em /painel/conexoes e clique em + Nova chave. Copie o Token gerado (ele começará com jusmcp_).

4. Grave o token em uma variável de ambiente

No Windows PowerShell, rode:

setx JUSRATIO_MCP_TOKEN "jusmcp_chave_completa_aqui"

Depois feche e abra o Codex Desktop de novo.

5. Adicionar Custom MCP Server no Codex

Volte no Codex Desktop, clique em 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

Não cole a chave jusmcp_... no campo de variável de ambiente. Ali entra o nome JUSRATIO_MCP_TOKEN.

6. Always allow tools

Em Settings → Tools, ative Always allow pro Jusratio. Evita ter que aprovar cada busca.

Pronto!

Pergunte ao Codex tipo:

"Use o Jusratio e responda sobre indenização por dano moral em atraso de voo segundo o STJ."

Não funcionou? (Codex Desktop)

  • Codex não autentica: confira se a variável JUSRATIO_MCP_TOKEN existe no sistema e reinicie o Codex.
  • Codex não chama o RAG: peça explicitamente ("use o Jusratio e ...").
  • Outro problema: contato em [email protected].

Codex CLI

Em 3 minutos você conecta o Jusratio ao Codex CLI (terminal). Mesmo Bearer token do Desktop, configurado via config.toml.

Pré-requisitos (Codex CLI)

Passo a passo (Codex CLI)

1. Crie uma chave em /painel/conexoes

Acesse /painel/conexoes e clique em + Nova chave. Copie o token (começa com jusmcp_).

2. Exporte o token como variável de ambiente

Linux/Mac:

export JUSRATIO_MCP_TOKEN="jusmcp_chave_completa_aqui"

Adicione ao ~/.zshrc ou ~/.bashrc pra persistir.

Windows PowerShell:

setx JUSRATIO_MCP_TOKEN "jusmcp_chave_completa_aqui"

Depois feche e abra o terminal de novo.

3. Edite ~/.codex/config.toml

Adicione o bloco abaixo (crie o arquivo se ele não existir):

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

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

Se já existem outros servidores MCP, adicione esse bloco como mais uma seção [mcp_servers.<nome>] no mesmo arquivo.

4. Verifique a conexão

Rode codex no terminal. Em uma sessão nova, peça:

"Use o Jusratio e responda sobre indenização por dano moral em atraso de voo segundo o STJ."

Se o Codex chamar a tool pesquisar_documentos, tá conectado. Você também pode listar servidores MCP com codex mcp list (se disponível na sua versão).

Não funcionou? (Codex CLI)

  • Variável de ambiente não foi lida: confirme com echo $JUSRATIO_MCP_TOKEN. Se vazio, refaça export/setx e abra terminal novo.
  • TOML inválido: confira indentação e aspas no config.toml. Codex pode silenciar erros de parsing — rode codex --help ou comando equivalente pra ver mensagens de inicialização.
  • 401/Unauthorized: chave inválida ou revogada. Crie outra em /painel/conexoes.
  • Outro problema: contato em [email protected].

Veja também