Pular para o conteúdo

Documentação

A Precedent AI entrega à IA que você já usa o inteiro teor de decisões judiciais reais e o trecho pertinente a uma tese, com a citação pronta. Ela entrega o texto que o tribunal publicou, nunca o que isso significa para o caso de quem pergunta: essa leitura continua sendo sua.

Antes de começar

Você precisa de uma conta na Precedent AI: crie a sua em Criar conta. A conta nova começa com 15 créditos grátis, e os planos estão na página inicial.

Como conectar

Nos assistentes abaixo você entra com a sua conta da Precedent AI e autoriza o acesso; nenhum arquivo é necessário.

Claude, pelo diretório (site e aplicativo de computador)

O aplicativo de computador e o site são a mesma conta e o mesmo conector. Este é o caminho mais curto, e o conector também está na página da Precedent AI no diretório do Claude.

  1. Passo 1. No Claude, abra Configurações → Conectores e busque por “Precedent AI”.

    Deu certo quando: você deve ver a Precedent AI no resultado, com o nosso símbolo.

  2. Passo 2. Clique em Adicionar e depois em Conectar.

    Deu certo quando: o Claude abre a tela de autorização da Precedent AI.

  3. Passo 3. Entre com a sua conta da Precedent AI e autorize.

    Deu certo quando: você volta ao Claude e vê a Precedent AI marcada como conectada.

Claude (site e aplicativo)

Conector personalizado depende do seu plano no Claude. Em Team e Enterprise, só o titular conecta, nas configurações da organização.
  1. Passo 1. No Claude, abra Configurações → Conectores, escolha “Adicionar conector personalizado” e cole a URL abaixo no campo da URL.

    Deu certo quando: você deve ver a Precedent AI entrar na lista do Claude, ainda sem a marca de conectada.

  2. Passo 2. Clique em Conectar. O Claude abre a tela de autorização da Precedent AI: entre com a sua conta e confirme o acesso.

    Deu certo quando: você deve voltar ao Claude e ver a Precedent AI listada como conectada.

  3. Passo 3. Numa conversa nova, confirme que a Precedent AI aparece entre as ferramentas e cole a pergunta de teste abaixo.

    Deu certo quando: você deve ver a resposta trazer a data da última atualização do acervo — ela só aparece quando a pergunta chega ao fim sem erro.

URL da Precedent AI

https://mcp.precedentai.com.br/mcp

ChatGPT

O conector personalizado no ChatGPT sai pelo modo desenvolvedor, na versão web, e depende do plano da sua conta — regra deles, confira no seu.
  1. Passo 1. No ChatGPT, com o modo desenvolvedor ligado, abra Configurações → Conectores, crie um conector personalizado, cole a URL e escolha a autenticação OAuth.

    Deu certo quando: você deve ver o ChatGPT preencher sozinho o nome Precedent AI depois de consultar a URL — é o sinal de que ele conseguiu falar com a Precedent AI.

  2. Passo 2. Autorize o acesso na tela da Precedent AI que o ChatGPT abrir, com a sua conta.

    Deu certo quando: você deve voltar ao ChatGPT e ver a Precedent AI listada como conectada.

  3. Passo 3. Numa conversa nova, ative a Precedent AI entre as ferramentas e cole a pergunta de teste abaixo.

    Deu certo quando: você deve ver a resposta trazer a data da última atualização do acervo — ela só aparece quando a pergunta chega ao fim sem erro.

URL da Precedent AI

https://mcp.precedentai.com.br/mcp

Grok

Em conta Business ou Enterprise, quem libera a conexão é o administrador da equipe.
  1. Passo 1. No Grok, abra grok.com/connectors, clique em New Connector e escolha Custom.

    Deu certo quando: você deve ver o campo para colar o endereço da Precedent AI, e não uma lista de aplicativos prontos.

  2. Passo 2. Cole a URL abaixo e conclua a autenticação que o Grok pedir, com a sua conta da Precedent AI.

    Deu certo quando: você deve ver o Grok listar as ferramentas que a Precedent AI oferece — é assim que ele mostra que conseguiu falar com ela e leu o que há lá dentro.

  3. Passo 3. Numa conversa nova, cole a pergunta de teste abaixo.

    Deu certo quando: você deve ver a resposta trazer a data da última atualização do acervo — ela só aparece quando a pergunta chega ao fim sem erro.

URL da Precedent AI

https://mcp.precedentai.com.br/mcp

Claude Code, Gemini CLI, Cursor usam uma chave em vez da entrada com a conta. A chave é criada no painel, em Conexões, depois que você entra: é lá que o botão “Criar chave” dos passos abaixo está, e o trecho sai com a chave já dentro. Aqui você vê o que cada um pede.

Claude Code

  1. Passo 1. Clique em Criar chave e crie o arquivo .mcp.json na raiz do projeto, com o trecho que aparece, já com a sua chave.

    Deu certo quando: o arquivo deve ficar na mesma pasta de onde você abre o Claude Code, e o conteúdo deve ter uma linha Authorization começando por Bearer pcd_.

  2. Passo 2. Abra o Claude Code nessa pasta e aprove a conexão quando ele perguntar se pode usá-la neste projeto.

    Deu certo quando: você deve ver precedentai na lista de conexões “MCP” do Claude Code, marcado como conectado.

  3. Passo 3. Cole a pergunta de teste abaixo na conversa.

    Deu certo quando: você deve ver a resposta trazer a data da última atualização do acervo — ela só aparece quando a pergunta chega ao fim sem erro.

.mcp.json

{
  "mcpServers": {
    "precedentai": {
      "type": "http",
      "url": "https://mcp.precedentai.com.br/mcp",
      "headers": {
        "Authorization": "Bearer {chave}"
      }
    }
  }
}

Use “Criar chave”, em Chaves: o trecho sai lá com a sua chave dentro.

Gemini CLI

É o Gemini do terminal. O aplicativo Gemini, no site e no celular, só aceita conector personalizado para quem está nos Estados Unidos, com conta pessoal do Google — regra deles, e por isso ele não aparece aqui.
  1. Passo 1. Clique em Criar chave, abra o terminal e rode o comando que aparece, já com a sua chave. Ele vale para qualquer pasta.

    Deu certo quando: o terminal deve responder sem erro, e a configuração deve ficar em ~/.gemini/settings.json.

  2. Passo 2. Ainda no terminal, rode gemini mcp list para o Gemini CLI conferir a conexão que você acabou de gravar.

    Deu certo quando: você deve ver precedentai na lista, com o estado de conectado ao lado do nome.

  3. Passo 3. Rode gemini e cole a pergunta de teste abaixo.

    Deu certo quando: você deve ver a resposta trazer a data da última atualização do acervo — ela só aparece quando a pergunta chega ao fim sem erro.

Comando do Gemini CLI

gemini mcp add --transport http -s user precedentai https://mcp.precedentai.com.br/mcp --header "Authorization: Bearer {chave}"

Use “Criar chave”, em Chaves: o trecho sai lá com a sua chave dentro.

Cursor

  1. Passo 1. Clique em Criar chave e crie o arquivo .cursor/mcp.json dentro do projeto, com o trecho que aparece, já com a sua chave.

    Deu certo quando: o arquivo deve ficar em .cursor/mcp.json dentro da pasta do projeto, e o conteúdo deve ter uma linha Authorization começando por Bearer pcd_.

  2. Passo 2. No Cursor, abra Settings → “MCP” para que ele releia o arquivo.

    Deu certo quando: você deve ver precedentai na lista de conexões “MCP” do Cursor, com o indicador de conectado ao lado do nome.

  3. Passo 3. Cole a pergunta de teste abaixo no chat do Cursor.

    Deu certo quando: você deve ver a resposta trazer a data da última atualização do acervo — ela só aparece quando a pergunta chega ao fim sem erro.

.cursor/mcp.json

{
  "mcpServers": {
    "precedentai": {
      "url": "https://mcp.precedentai.com.br/mcp",
      "headers": {
        "Authorization": "Bearer {chave}"
      }
    }
  }
}

Use “Criar chave”, em Chaves: o trecho sai lá com a sua chave dentro.

Perguntas para testar

Depois de conectar, cole uma destas perguntas numa conversa nova. Os colchetes são para você preencher.

  • Busque no acervo da Precedent AI acórdãos do STJ sobre a cobertura, pelo plano de saúde, de tratamento fora do rol da ANS, e traga o trecho de cada um com a citação pronta.
  • Busque no acervo da Precedent AI acórdãos do STJ que decidiram [a tese, em uma frase] e traga o trecho de cada um com a citação pronta.
  • Localize no acervo da Precedent AI o REsp [número do recurso] e diga se ele está lá.
  • Abra o inteiro teor dessa decisão e transcreva a ementa exatamente como o tribunal escreveu.
  • Nessa decisão, transcreva a conclusão do voto do relator e diga em que seção ela está.
  • Quantos documentos do STJ estão no acervo, e qual é a data da última atualização dele?
  • Diga a versão do acervo que você está usando agora.
  • Confira se o trecho “[o trecho entre aspas]” consta no inteiro teor dessa decisão, palavra por palavra.
  • Vigie o [tema ou súmula] e, quando eu pedir, diga o que mudou nele.

Exemplos de pedido

Cinco pedidos, um para cada passo do trabalho. A forma que mais ajuda: nomear o tribunal, usar os termos que apareceriam na ementa em vez da pergunta inteira e, quando houver número, entregá-lo.

  • Busque na Precedent AI decisões do [tribunal] sobre [três a oito termos que apareceriam na ementa] e mostre, de cada uma, o trecho pertinente e a citação pronta.
  • Localize na Precedent AI o processo [número no padrão do CNJ] e diga se há decisão dele no acervo.
  • Leia o inteiro teor dessa decisão e me mostre primeiro o dispositivo, na íntegra, com a seção de onde ele veio.
  • Antes de eu usar esta frase entre aspas, confira se ela consta, palavra por palavra, no inteiro teor dessa decisão: “[a frase]”.
  • Esta decisão não apareceu na busca, mas deveria estar no acervo: reporte o problema, sem dados do meu cliente.

O que o acervo cobre

Pergunte à sua IA: “O que o acervo da Precedent AI cobre?”. Ela consulta a cobertura medida no dia, com os tribunais e as datas de cada um, e responde a partir dela.

O que a sua IA pode fazer

Nenhuma ferramenta altera o acervo. Só duas guardam algo, e é o pedido que você fez: o que vigiar e o problema reportado.

  • Buscar fundamento por tese (buscar_fundamento): procura decisões sobre a tese descrita, decididas em qualquer sentido, e devolve de cada uma o trecho pertinente com a citação pronta. Quem lê o dispositivo e diz de que lado ela está é a sua IA, e a conferência final é sua.
  • Localizar decisão por número (localizar): encontra um processo, tema ou súmula pelo número exato e diz se ele está no acervo.
  • Ler inteiro teor (inteiro_teor): traz o texto integral da decisão, com as seções marcadas nos tribunais em que isso existe e, em parte deles, as transcrições de outras fontes identificadas.
  • Cobertura do acervo (estatisticas_acervo): mostra o que o acervo cobre, por tribunal, quantos documentos e em quais períodos.
  • Estado do serviço (status): diz se o serviço está no ar e quando o acervo foi atualizado pela última vez.
  • Conferir citações (conferir_citacoes): confere, caractere a caractere, se o trecho entre aspas que você atribui a uma decisão consta no texto dela, e avisa quando o trecho está dentro de uma transcrição marcada.
  • Conferir citações de uma peça (conferir_peca): confere as citações de uma peça em DOCX ou PDF; a peça é apagada ao fim da conferência.
  • Vigiar tema, súmula ou tese (vigiar): acompanha um tema, uma súmula ou uma tese do catálogo oficial e, quando você pede a lista, traz o que mudou (afetação, julgamento, cancelamento ou virada); guarda só o que é vigiado, nunca o texto da sua pergunta.
  • Reportar problema no resultado (reportar): registra um problema num resultado, como citação errada ou documento ausente; o comentário é opcional e não deve trazer dados do cliente nem do caso.

Limites conhecidos

O que o serviço não faz hoje, dito antes de você descobrir na peça.

  • A busca devolve decisões pertinentes à tese, decididas em qualquer sentido. Ela não separa as contrárias à posição que você defende: quando a resposta traz o aviso “adverso_indisponivel”, leia o dispositivo de cada decisão.
  • As transcrições de terceiros são marcadas só em parte dos tribunais, e mesmo nesses a marcação pode ser parcial. Um trecho sem marca pode ser transcrição: leia o inteiro teor antes de atribuí-lo ao tribunal.
  • A conferência de citações confere o texto. Hoje a conferência de uma peça só emite certificado, e só diz se o trecho é do tribunal ou de terceiro transcrito, para decisões do STJ já reextraídas pelas regras atuais. Nas demais, inclusive as do STJ ainda não reextraídas, ela não emite certificado: a citação vem em “sem_certificado”, e a origem do trecho, “nao_verificada”.
  • Natureza e função da decisão, risco de inadmissão e a ordem dos resultados são classificações da Precedent AI, não do tribunal: confirme no dispositivo antes de afirmá-las.
  • A vigência de uma tese só aparece para o que o catálogo oficial registra. Sem esse dado, não se conclui que a tese está em vigor. O estado recursal da decisão não é verificado: confira o andamento antes de chamá-la de definitiva.
  • A vigília acompanha tema, súmula ou tese do catálogo oficial; uma decisão vigiada não gera aviso.
  • O acervo é o que a página inicial e a cobertura mostram, tribunal a tribunal e por período. Ter um período não quer dizer ter todos os julgados dele.

Quando não acha

Resposta vazia quer dizer “não encontrei nesta base”, nunca “não existe”. Antes de desistir:

  • Reformule com três a oito termos que apareceriam na ementa, em vez da pergunta inteira, e tente duas ou três formulações.
  • Nomeie o tribunal. Se já nomeou, tire um termo.
  • Se você tem o número do processo, do tema ou da súmula, peça para localizar por ele.
  • Pergunte o que o acervo cobre: o tribunal ou o período podem estar fora, e parte do que foi recebido pode ainda estar em processamento.
  • Se a decisão deveria estar no acervo, peça à sua IA para reportar o problema, sem dados do seu cliente.

Como citar

  • Use a citação pronta que vem com a decisão: ela traz só o que a fonte informou. Quando a resposta avisar que faltam dados, confira no portal do tribunal antes de citar.
  • Antes de pôr um trecho entre aspas, peça a conferência: ela diz se o trecho consta, caractere a caractere, no texto servido da decisão. Paráfrase não confere.
  • Trecho dentro de transcrição, ou sem marca num tribunal em que a marcação é parcial, pode não ser fala do tribunal: não o atribua a ele.
  • Decisão monocrática é do relator, não de “o tribunal entende”. Voto vencido não é a decisão do colegiado.
  • A leitura final antes de assinar a peça continua sendo sua.

Glossário dos avisos

Avisos que a sua IA pode repetir na resposta. O texto de cada um é o que a Precedent AI devolve.

citacao_incompleta
A fonte não informou o órgão julgador ou a data de julgamento desta decisão, e a classe pode estar sem os recursos intermediários (por exemplo, agravo interno ou embargos de declaração); a citação pronta não tem esses dados. Confira no portal do tribunal antes de citar.
data_incoerente
A fonte trouxe data de julgamento posterior à data de publicação desta decisão; a data de julgamento não foi informada na citação. Confira no portal do tribunal antes de citar.
legado_sem_copia_bruta
Texto vindo da base anterior, sem cópia bruta guardada; confira no portal do tribunal antes de citar.
regime_anterior
Julgado sob diploma já substituído (CPC de 1973 ou Código Civil de 1916); confira a vigência da norma antes de citar.
possivel_transcricao_nao_marcada
Sem marca de transcrição, o trecho vem logo depois de uma expressão que costuma introduzir citação (como "ensina", "verbis" ou "nesse sentido") ou dentro de aspas abertas antes dele; pode não ser fala deste tribunal. Leia o inteiro teor antes de atribuí-lo ao tribunal.
marcacao_de_transcricoes_parcial
Neste tribunal, a marcação de transcrições de terceiros ainda é parcial; um trecho fora de qualquer marca pode ser transcrição. Leia o inteiro teor antes de atribuí-lo ao tribunal.
monocratica_suprimida_por_acordao
Havia decisão monocrática do mesmo processo; prevaleceu o acórdão, que a substitui.
adverso_indisponivel
A separação em adverso não foi feita nesta consulta; decisões contrárias à posição defendida podem estar em resultados.
orcamento_cortou_resultados
A resposta excedeu o tamanho máximo e resultados do fim da lista foram retirados inteiros.
ocorrencias_multiplas
O trecho aparece mais de uma vez nesta decisão; a posição devolvida é a primeira, e "ocorrencias" diz quantas são.
tribunal_fora_da_cobertura
O tribunal do identificador ainda não está no acervo.
periodo_fora_da_cobertura
A data da decisão está fora do período que o acervo cobre para este tribunal.
documento_nao_indexado
A decisão ainda não consta do acervo servido; confira no portal do tribunal.
digito_verificador_incorreto
O dígito verificador do número não confere; confira o número digitado.

Quando algo não funciona

  • A Precedent AI aparece com “Conectar” ou “Reconectar”. A entrada na sua conta não chegou ao fim. Clique de novo, entre com a sua conta da Precedent AI e autorize o acesso.
  • A resposta fala em limite do plano. Os créditos do período acabaram. O consumo está no painel, em Plano.
  • A busca não encontrou nada. Uma busca vazia não quer dizer que não exista precedente: pode ser que o acervo não cubra aquele tribunal ou aquele período. Pergunte à sua IA o que o acervo cobre e reformule a tese.
  • Quer desligar ou refazer a conexão. Em Conexões, no painel, você revoga o acesso de um assistente; depois é só conectar de novo.
  • Nada disso resolveu. Escreva para suporte@precedentai.com.br com o dia e a hora da consulta e a ferramenta que a sua IA chamou. Veja Suporte.

Detalhes técnicos

https://mcp.precedentai.com.br/mcp
  • Protocolo “MCP”, pelo transporte Streamable HTTP.
  • Autenticação OAuth 2.1 com PKCE, registro dinâmico de cliente e Client ID Metadata Documents. Escopo: consultar.
  • Todas as ferramentas são marcadas como somente leitura, menos vigiar e reportar, que registram o pedido.

O tratamento de dados está na Política de privacidade.