pAIdegua Agent

Documentação

Use o pAIdegua dentro do Claude ou do ChatGPT: copie o endereço, cole como conector, entre com a sua conta.

Conectar no Claude ou no ChatGPT Comece aqui

Uma vez só. Sem API key do MCP e sem instalar nada.

Antes, você precisa de uma conta aqui, com o acesso ao PJe e a API key de IA (OpenAI) cadastrados. Pedir acesso

Onde você usa?

No claude.ai. Vale também no celular e no Cowork.

  1. No claude.ai, abra Configurações › Conectores › Adicionar conector personalizado.
  2. Dê o nome PJe e cole o endereço abaixo. Se pedir OAuth client, marque Register automatically.
  3. Clique em Conectar, entre com o seu e-mail e senha daqui e clique em Autorizar.
Endereço do conector https://pje-mni-mcp-production.up.railway.app/mcp

No chatgpt.com, com o Modo de desenvolvedor ligado.

  1. No ChatGPT, abra Configurações › Apps e conectores › Configurações avançadas e ligue o Modo de desenvolvedor.
  2. Em Apps e conectores, clique em Criar, cole o endereço abaixo e escolha OAuth.
  3. Entre com o seu e-mail e senha daqui e clique em Autorizar.
Endereço do conector https://pje-mni-mcp-production.up.railway.app/mcp

Onde achar o endereço

No Painel, no cartão “Usar no Claude ou no ChatGPT”, com o botão Copiar.

O cartão “Usar no Claude ou no ChatGPT” do Painel: o selo “Ligado no ChatGPT e no Claude”, a frase “Cole como conector e entre com o seu e-mail e senha daqui”, o endereço do MCP com o botão Copiar e o link “Passo a passo por programa”.
O cartão no Painel.

Como saber que ligou

Em Configuração › Servidor MCP, o programa aparece como Ligado. É lá também que se desliga.

A lista “Ligados pelo login” em Configuração › Servidor MCP: ChatGPT (chatgpt.com, usado hoje) e Claude (claude.ai, usado hoje), cada um com o selo Ligado e o menu ⋯.
Ligados pelo login, em Configuração › Servidor MCP.
O mesmo passo a passo dentro do sistema

Em Configuração › Servidor MCP, “Passo a passo por programa” mostra estes passos com o endereço para copiar.

O “Passo a passo por programa” com “Claude no navegador” escolhido: os três passos (Configurações › Conectores › Adicionar conector personalizado; nome PJe e o endereço; Conectar, entrar e Autorizar) e o endereço do conector com Copiar.
O passo a passo do Claude em Configuração › Servidor MCP.
O cartão “Conexão” em Configuração › Servidor MCP: o endereço do MCP com Copiar, a API key do MCP mascarada com o selo Pronta e os limites dos outros programas.
A conexão em Configuração › Servidor MCP. A API key só serve aos outros programas.

O que pedir

Escreva como pediria a um colega, com o número do processo. O assistente escolhe as ferramentas e cita a peça e a folha.

“Em que pé está o processo 0805678-22.2025.4.05.8100? Quem deve agir agora?”

mapear_processo · perguntar_peca

“O INSS já foi citado nesse processo? Em que data?”

consultar_intimacoes

“Conte 15 dias úteis a partir da intimação de 3 de novembro.”

contar_prazo

“Atualize R$ 12.500,00 pelo IPCA-E desde março de 2021, com juros de 1% ao mês.”

calcular_correcao_monetaria

“Traga julgados das Turmas Recursais da 5ª Região sobre aposentadoria especial de vigilante.”

trf5_buscar_jurisprudencia

“Minute o despacho com base nas minhas peças-modelo.”

buscar_modelos · ler_modelo

“Faça a triagem destes 30 processos e me mostre os que pedem atenção.”

criar_triagem · comecar_triagem

No Claude e no ChatGPT, o mapa, a peça, a linha do tempo e a busca nos autos abrem como telas dentro da conversa.

2º grau: diga “no 2º grau”. O número CNJ não indica a instância.

As ferramentas

53 ferramentas, por assunto. Você não as chama pelo nome: pede, e o assistente escolhe.

FerramentaO que faz
Abrir e ler o processo · Comece pelo mapa; depois pergunte ou leia a peça.
mapear_processoAbre o processo: as peças na ordem de leitura, as partes com OAB e os últimos atos.
perguntar_pecaPergunta às peças e devolve só a resposta, com documento e folha. Usa a sua API key da OpenAI.
ler_pecaLê uma peça inteira, pelo nome (“a sentença”) ou pela folha, para citar ou redigir.
buscar_nos_autosProcura um dado espalhado pelos autos, como um endereço ou um telefone.
consultar_capaA capa completa: partes, endereços, assuntos e todas as movimentações.
sumarizar_processoUm resumo curto: a capa, as partes e as últimas cinco movimentações.
listar_mandadosOs mandados expedidos e as certidões do oficial de justiça.
validar_numero_processoConfere o número CNJ e completa o número pela metade com o seu histórico.
Intimações e Diário · Antes de afirmar que alguém foi intimado.
consultar_intimacoesIntimações, citações e ciências do processo, com a data de cada uma.
buscar_no_diarioO que saiu publicado no Diário de Justiça Eletrônico Nacional (DJEN), de qualquer tribunal.
Prazos e cálculos · A conta é do sistema, nunca de cabeça.
contar_prazoConta o prazo, pula os dias sem expediente com a fonte legal e diz se já venceu.
calcularCalculadora exata em reais: soma, diferença, porcentagem, sem erro de centavo.
calcular_correcao_monetariaCorreção pelos índices oficiais do Banco Central, com juros, multa e honorários.
calcular_jefAs contas do Juizado: a alçada em salários mínimos, a idade da procuração e do comprovante.
calcular_execucao_fiscalAs contas da execução fiscal: o total, o baixo valor e o alerta de prescrição de cada CDA.
calcular_prescricao_penalA prescrição penal, com os marcos do art. 117 e as suspensões, e a memória de cálculo.
Jurisprudência · Não precisa do PJe.
pdpj_buscar_precedentesPrecedentes do Banco Nacional de Precedentes do CNJ: súmulas, temas, IRDR, repetitivos.
trf5_buscar_jurisprudenciaJulgados do TRF5, das Turmas Recursais e da TRU da 5ª Região, na Julia.
trf5_ler_jurisprudenciaO inteiro teor de um julgado da Julia, com a referência para citar.
trf5_opcoes_jurisprudenciaOs relatores e os órgãos julgadores, para filtrar a busca na Julia.
Peças-modelo · As peças que você cadastrou aqui.
buscar_modelosAcha pelo sentido as suas peças-modelo. O assistente a chama antes de redigir.
ler_modeloLê uma peça-modelo, como referência para a minuta.
Triagem em lote · As mesmas perguntas em muitos processos de uma vez.
listar_modelos_de_triagemOs modelos de triagem (as perguntas da IA) e se a conta já pode começar.
salvar_modelo_de_triagemCria ou edita um modelo de triagem.
apagar_modelo_de_triagemApaga um modelo de triagem seu. As triagens já feitas não mudam.
criar_triagemRecebe a lista de processos e devolve a conferência, com o custo estimado.
comecar_triagemComeça a triagem conferida: a IA da sua conta lê cada processo no PJe e escreve a ficha.
controlar_triagemPausa, retoma, cancela, tenta de novo as falhas ou renomeia a triagem.
listar_triagensAs suas triagens, com o andamento, o tempo e o custo.
ler_triagemO painel de uma triagem: os números e a lista de processos, com filtro.
ler_ficha_da_triagemA ficha de um processo da triagem: o resultado, o que fazer e as peças.
marcar_conferidasMarca fichas como conferidas, como o botão do site.
baixar_triagemO link da planilha (ou do Word) da triagem, válido por 6 horas.
apagar_triagemApaga triagens. Minutas, conversas e tarefas ficam. Não se desfaz.
Ficha, caderno e tarefas · O que você já apurou fica guardado.
ler_ficha_do_processoO que já se apurou no processo numa análise anterior.
gravar_ficha_do_processoGrava o que se apurou, para a próxima análise partir daí.
ler_cadernoLê o caderno do processo: notas, trechos destacados e ligações.
anotar_no_cadernoAcrescenta blocos ao caderno, marcados como criados pelo agente.
limpar_cadernoApaga blocos do caderno; os que você criou, só se você pedir.
criar_tarefaCria uma tarefa de acompanhamento no seu quadro.
listar_tarefasO que está pendente no seu quadro de tarefas.
atualizar_tarefaEdita uma tarefa: título, coluna, prazo, urgência e etiquetas.
marcar_itensMarca e desmarca itens do checklist de uma tarefa.
Conversas do chat daqui · O que você conversou com o agente deste site.
listar_conversasAs suas conversas no chat daqui, da mais recente para a mais antiga.
ler_conversaAs mensagens de uma conversa do chat.
buscar_no_historicoProcura no texto das suas conversas passadas.
listar_processos_recentesOs processos sobre os quais você conversou por último.
listar_pastasAs pastas das suas conversas.
criar_pastaCria uma pasta para as conversas.
renomear_conversaTroca o título de uma conversa.
renomear_pastaTroca o nome ou a cor de uma pasta.
organizar_conversasMove conversas entre pastas, arquiva ou restaura, em lote.
Conta
minha_assinaturaA situação da sua conta.
Mais 12: por documento e antigas

No PJe, uma peça pode ter vários documentos (páginas). Estas trabalham por documento ou são anteriores à leitura por peças.

FerramentaO que faz
Por documento · Quando já se tem o número de um documento avulso.
consultar_peticao_inicialOs dados da petição inicial e dos anexos, sem o texto.
listar_documentos_para_leituraA lista de documentos (páginas), com a posição e o formato.
filtrar_documentos_por_tipoOs documentos de um tipo, como “sentença” ou “laudo”.
extrair_texto_documentoO texto de um documento cujo número você já tem.
extrair_textos_documentosO texto de até quatro documentos de uma vez.
baixar_documentoO arquivo original (PDF, HTML ou RTF), para salvar.
Antigas · Ficam por compatibilidade; as de cima fazem melhor.
consultar_processoA capa, as movimentações e os documentos, no formato cru do PJe.
listar_documentos_idsOs números de todos os documentos, sem mais nada.
preparar_roteiro_leituraUma ordem de leitura por documento.
ler_ultimos_documentosO texto dos últimos documentos.
ler_documentos_iniciaisO texto dos primeiros documentos.
meu_saldo_creditosO nome antigo de minha_assinatura.

Onde funciona

O tribunal sai do número do processo. A consulta usa o seu login do PJe de cada tribunal.

TRF5JFCE, JFPE, JFAL, JFSE, JFRN e JFPB · 1º grauFunciona
TRF5, 2º grauConfigurado, ainda em testeEm teste
EstaduaisTambém tribunais estaduais com PJe, com a conta de láConsulte antes

Como o PJe é lido: pelo MNI, o canal oficial do CNJ para trocar dados de processo. Não é robô nem cópia de tela, e a senha de um tribunal nunca vai a outro. Outro tribunal só funciona depois de testado: confirme antes com a equipe.

Dúvidas

Preciso da API key do MCP no Claude ou no ChatGPT?

Não. Entre com o e-mail e a senha daqui. O acesso ao PJe e a API key de IA vêm da sua conta.

No ChatGPT não aparece “Criar”.

Ligue o Modo de desenvolvedor em Configurações › Apps e conectores › Configurações avançadas.

Para que serve a API key de IA da conta?

Para perguntar às peças (perguntar_peca, com a da OpenAI), para a triagem em lote e para a busca das peças-modelo pelo sentido. Sem ela, o assistente lê a peça inteira com a ler_peca. Cadastre em PJe e API keys.

A resposta demorou ou parou no meio.

Processo grande e PDF escaneado levam minutos. Peça de novo: a leitura fica guardada por 24 horas, e a segunda vez é rápida.

E processo em segredo de justiça?

Segue a regra que o administrador definiu: sai normal, é recusado ou sai com os nomes trocados por pseudônimos.

Como desligar?

Em Configuração › Servidor MCP, “Ligados pelo login”: no ⋯ do programa, Desligar.

Outros programas

Claude Code, Claude Desktop pelo arquivo, Cursor, Codex e OpenCode entram com a API key do MCP, não com o login.

A configuração com a API key

A API key do MCP se gera em API keys, depois de entrar. Com o PJe cadastrado na conta, o bloco fica só com ela.

Aumente o tempo de espera do programa. Uma leitura com OCR pode levar minutos (até 420 s por chamada); o Claude Code e o Codex cortam em 60 s, e o erro parece servidor fora do ar. Os blocos abaixo já sobem o teto — mantenha as linhas.

Configuração por programa

No terminal. É add-json, e não --header, porque só assim dá para definir o timeout.

claude mcp add-json --scope user pje-mni '{
  "type": "http",
  "url": "https://pje-mni-mcp-production.up.railway.app/mcp",
  "timeout": 600000,
  "headers": {
    "Authorization": "Bearer SUA_API_KEY",
    "X-MNI-CPF-TRF5": "SEU_CPF_PJE",
    "X-MNI-SENHA-TRF5": "SUA_SENHA_PJE",
    "X-MISTRAL-API-KEY": "SUA_CHAVE_MISTRAL_PARA_PDF",
    "X-OPENAI-API-KEY": "SUA_CHAVE_OPENAI_PARA_PERGUNTAR_PECA"
  }
}'

No Windows, as aspas dessa linha dão trabalho: cole o mesmo objeto no ~/.claude.json, dentro de "mcpServers".

macOS e Linux · Claude Desktop: claude_desktop_config.json · Cursor: ~/.cursor/mcp.json

{
  "mcpServers": {
    "pje-mni": {
      "type": "http",
      "url": "https://pje-mni-mcp-production.up.railway.app/mcp",
      "headers": {
        "Authorization": "Bearer SUA_API_KEY",
        "X-MNI-CPF-TRF5": "SEU_CPF_PJE",
        "X-MNI-SENHA-TRF5": "SUA_SENHA_PJE",
        "X-MISTRAL-API-KEY": "SUA_CHAVE_MISTRAL_PARA_PDF",
        "X-OPENAI-API-KEY": "SUA_CHAVE_OPENAI_PARA_PERGUNTAR_PECA"
      }
    }
  }
}

Claude Desktop no Windows, via mcp-remote (precisa do Node.js) · %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "pje-mni": {
      "command": "cmd",
      "args": [
        "/c", "npx", "mcp-remote",
        "https://pje-mni-mcp-production.up.railway.app/mcp",
        "--header", "Authorization: Bearer SUA_API_KEY",
        "--header", "X-MNI-CPF-TRF5: SEU_CPF_PJE",
        "--header", "X-MNI-SENHA-TRF5: SUA_SENHA_PJE",
        "--header", "X-MISTRAL-API-KEY: SUA_CHAVE_MISTRAL_PARA_PDF",
        "--header", "X-OPENAI-API-KEY: SUA_CHAVE_OPENAI_PARA_PERGUNTAR_PECA"
      ]
    }
  }
}

⚠️ O cmd troca %…% por variável de ambiente: senha do PJe com % vai no painel (Configuração › PJe e API keys), e o bloco fica só com o Authorization.

~/.codex/config.toml · os segredos vão por env_http_headers, que recebe o NOME da variável (o valor não fica no arquivo)

[mcp_servers.pje-mni]
url = "https://pje-mni-mcp-production.up.railway.app/mcp"
bearer_token_env_var = "PJE_MNI_API_KEY"
startup_timeout_sec = 30
tool_timeout_sec = 600
http_headers = { "X-MNI-CPF-TRF5" = "SEU_CPF_PJE" }
env_http_headers = { "X-MNI-SENHA-TRF5" = "PJE_MNI_SENHA", "X-MISTRAL-API-KEY" = "PJE_MISTRAL_API_KEY", "X-OPENAI-API-KEY" = "PJE_OPENAI_API_KEY" }

E as variáveis no seu shell (~/.bashrc, ~/.zshrc):

export PJE_MNI_API_KEY=...          # a API key criada no painel
export PJE_MNI_SENHA=...            # sua senha do PJe
export PJE_MISTRAL_API_KEY=...      # leitura de PDF
export PJE_OPENAI_API_KEY=sk-...    # só perguntar_peca

O prefixo PJE_ evita colisão: OPENAI_API_KEY cru é a variável que o próprio Codex lê para se autenticar — exportá-la pode mudar o login dele e quem paga a conta.

opencode.json (projeto) ou ~/.config/opencode/opencode.json

{
  "mcp": {
    "pje-mni": {
      "type": "remote",
      "url": "https://pje-mni-mcp-production.up.railway.app/mcp",
      "headers": {
        "Authorization": "Bearer SUA_API_KEY",
        "X-MNI-CPF-TRF5": "SEU_CPF_PJE",
        "X-MNI-SENHA-TRF5": "SUA_SENHA_PJE",
        "X-MISTRAL-API-KEY": "SUA_CHAVE_MISTRAL_PARA_PDF",
        "X-OPENAI-API-KEY": "SUA_CHAVE_OPENAI_PARA_PERGUNTAR_PECA"
      }
    }
  }
}

Os cabeçalhos: só o Authorization é obrigatório quando o PJe e as chaves estão na conta (PJe e API keys); os outros trocam a chave só naquele programa. X-OCR-PROVIDER (mistral, tecjustica ou local) escolhe a leitura de PDF; X-OPENAI-API-KEY só a perguntar_peca lê.