Como conectar o Codex à jurisprudência

No Codex, o Precedentes entra com dois comandos: um adiciona o servidor e o outro abre a janela de entrada. A CLI, a extensão do editor e o app do ChatGPT no computador leem a mesma configuração. Depois, o Codex pesquisa as decisões do STF e do STJ e cita com o link oficial.

Pelo terminal

  1. Adicione o servidor:
    codex mcp add precedentes --url https://precedentes.com.br/mcp
  2. Entre com a sua conta. O navegador abre a janela do Precedentes: entre e clique em Autorizar.
    codex mcp login precedentes
  3. Confira com codex mcp list ou, dentro do Codex, com /mcp.

Pelo arquivo de configuração

  1. No ~/.codex/config.toml, acrescente:
    [mcp_servers.precedentes]
    url = "https://precedentes.com.br/mcp"
  2. Depois, rode codex mcp login precedentes e autorize na janela do Precedentes.

A CLI, a extensão do Codex no editor e o app do ChatGPT no computador usam o mesmo ~/.codex/config.toml: configurou uma vez, vale nos três.

Para testar

Peça, numa conversa nova: “Use o Precedentes: o STJ aplica o tráfico privilegiado a reincidente? Traga 3 decisões com link oficial.”

O que dá para perguntar

  • Buscar decisões, com nível de autoridade de A a E e aviso de cobertura. “o STJ aplica o tráfico privilegiado a reincidente?”
  • Abrir uma decisão pelo número. “mostre a ementa e o dispositivo do HC que eu citei”
  • Verificar citações de um texto: confere se cada julgado existe no índice, se relator, data e órgão batem e se a tese atribuída aparece na ementa; sugere a mais próxima. “confira as citações desta petição”
  • Ler o inteiro teor em partes. “leia o voto do relator nessa decisão”
  • Quem cita e quem é citado. “quais decisões citam esse acórdão?”
  • Súmulas e temas repetitivos ou de repercussão geral, com a tese e a situação. “qual a tese do tema sobre ANPP em processo já em curso?”
  • Artigo de lei com o texto e as decisões que o citam. “o que diz o art. 33, § 4º, da Lei de Drogas e quem o aplica?”
  • Informativos do STF e do STJ. “o que saiu nos informativos sobre prisão preventiva este ano?”
  • Taxa de êxito com universo, período e critério. “quanto a defesa ganha em HC sobre tráfico na Sexta Turma?”
  • Como o tribunal decidiu um tema ao longo dos anos. “como o STJ decidiu o reconhecimento pessoal desde 2015?”
  • Viradas: temas revistos, súmulas canceladas, mudança de maioria. “o STJ mudou de entendimento sobre insignificância no furto?”
  • Andamento de um processo pelo número CNJ, com o que cada passo quer dizer. “em que pé está o meu processo? (cole o número)”
  • Publicações no DJEN. “há publicações da minha OAB nesta semana?”
  • Empresas e sócios. “quem são os sócios deste CNPJ?”
  • Processos eleitorais e candidaturas, com o link da consulta pública do TSE. “fulano de tal responde a processo na Justiça Eleitoral?”
  • O que a base cobre: tribunais, órgãos, período, data de atualização. “até quando vão as decisões do STF na base?”
  • Calculadoras: prescrição, dosimetria, progressão, multa, correção monetária. “calcule a prescrição de um furto simples com pena de 1 ano”

Se der erro

  • O Precedentes não aparece no /mcp: confira a tabela [mcp_servers.precedentes] e a chave url no ~/.codex/config.toml.
  • O Codex pede para entrar de novo: rode codex mcp login precedentes outra vez.
  • “Couldn't reach the MCP server” ou outro erro de conexão: confira o endereço: com /mcp no fim, sem www e sem barra depois do mcp. Só o domínio não funciona.
  • A janela do Precedentes pede para entrar: use a mesma conta (ou a senha do escritório) que você usa no site.
  • “Limite diário do conector do seu plano atingido”: as consultas voltam à meia-noite, horário de Brasília. Ou suba de plano.
  • “Muitas consultas em sequência”: aguarde um minuto e peça de novo.

Perguntas frequentes

Funciona na extensão do Codex no VS Code?

Funciona. A extensão lê o mesmo ~/.codex/config.toml da CLI: o que você configurou no terminal já vale no editor.

Para que serve jurisprudência no Codex?

Para quem escreve peça ou parecer em arquivo: o Codex busca a decisão, confere as citações do texto e põe o trecho com o link oficial no documento que você está editando.

Preciso de conta no Precedentes?

Sim. O conector entra com a sua conta do Precedentes: na primeira vez, a janela do Precedentes pede para entrar e autorizar o assistente. Não há chave de API para copiar.

Como desfazer a conexão?

Remova o Precedentes no próprio assistente. No Precedentes, a tela Conectar, com a sua conta aberta, lista cada aplicativo conectado com o botão Desconectar.

De onde vem cada dado

Páginas abertas e conferidas em 01/10/2026.

  1. Model Context Protocol (documentação do Codex). Os comandos codex mcp add com --url, codex mcp login e codex mcp list, a tabela mcp_servers do config.toml e a configuração compartilhada entre CLI, extensão e app.