PJeCalc MCP Server

PJe-Calc MCP

Apoie o projeto

A imagem acima é um QR Code Pix. Se esta ferramenta poupou seu tempo, considere apoiar com um café. A contribuição ajuda a manter o projeto atualizado e ativo: acompanhar as novas versões do PJe-Calc e das tabelas, corrigir falhas encontradas em cálculos reais e incluir novos tipos de cálculo.

Reclamações, ideias, falhas encontradas ou sugestões: contato@lumenaxis.dev.br

---

Conecta assistentes de inteligência artificial instalados no seu computador — Claude Desktop, Claude Code, Codex, Cursor, VS Code e outros — ao PJe-Calc Cidadão, o programa oficial de cálculos da Justiça do Trabalho.

Você entrega ao assistente a sentença e os documentos do processo. Ele monta o cálculo trabalhista inteiro dentro do PJe-Calc, e você só confere e clica em Liquidar.

Não funciona em chats de IA abertos no navegador (claude.ai, chatgpt.com, Gemini, Copilot na web...) nem em aplicativos de celular. O assistente precisa rodar no mesmo computador Windows em que o PJe-Calc está instalado. Veja onde funciona e onde não funciona.

Ferramenta de apoio. O cálculo é feito pelo próprio PJe-Calc, mas quem decide o que entra nele é o assistente, a partir do que você fornecer. Confira sempre o resultado antes de usar no processo. O assistente deve mostrar as premissas que adotou e o que não estava claro nos documentos.

Use um modelo de IA de ponta. A leitura de um processo inteiro (centenas de páginas, decisões que se reformam, cartões de ponto dia a dia) exige o modelo mais capaz que você tiver: GPT-6 Luna ou superior no Codex, Claude Sonnet 5.5 ou superior (como o Claude Opus 5.5) no Claude, e o equivalente de mesma geração nos outros assistentes. Veja qual modelo usar.

Jeito mais fácil: cole o link no seu agente

Se você já usa um agente de IA instalado no computador (Claude Code, Claude Desktop, Codex, Cursor, VS Code com Copilot...), basta colar o link nele:

https://github.com/lucianumm/PJeCalcMCP

Por exemplo: "Instale e configure este MCP para mim: https://github.com/lucianumm/PJeCalcMCP". O agente baixa, instala e registra a ferramenta seguindo as instruções para o agente abaixo.

Colar o link num chat aberto no navegador (claude.ai, chatgpt.com...) não instala nada: esse chat roda nos servidores da empresa e não tem acesso ao seu computador. Ele pode até explicar o projeto, mas não consegue baixar, instalar nem operar o PJe-Calc. Se você ainda não tem um agente no computador, veja a tabela em onde funciona ou use a instalação manual, que não precisa de agente nenhum.

Importante: é preciso ter o PJe-Calc Cidadão 2.16 instalado (baixado e extraído) no computador. Esta ferramenta opera o PJe-Calc da sua máquina: ela não substitui nem inclui o programa. Sem ele, nada funciona.

O que ele faz

• Monta o cálculo completo no PJe-Calc:
  • dados do processo e das partes, datas do contrato e salários;
  • faltas, férias e cartão de ponto (inclusive horas extras a partir da jornada);
  • verbas e reflexos, com valores mês a mês quando os documentos pedem (o pago de cada contracheque, a quantidade de um mês);
  • piso salarial e vale-transporte das tabelas do PJe-Calc;
  • FGTS, INSS, imposto de renda, pensão, previdência privada, salário-família, seguro-desemprego, com os ajustes por competência das telas de ocorrências (base e depósito do FGTS, salários e contribuições já recolhidas do INSS, inclusive em lote);
  • honorários (inclusive sobre verbas escolhidas), multas, custas (inclusive custas fixas, autos e armazenamento), correção monetária e juros.
• Na execução, atualiza o cálculo homologado com os pagamentos (depósitos, alvarás), os honorários, multas, pensão alimentícia e custas da execução (por ato, autos e armazenamento) e o precatório ou RPV, e atualiza também uma conta feita fora do PJe-Calc (Cálculo Externo). Faz vários cálculos de uma vez (um por reclamante ou por devedor).
• Ajuda a ler os documentos: lista as páginas (e as escaneadas, que precisam ser vistas como imagem), extrai o texto de PDFs e as imagens das páginas escaneadas para o assistente enxergar, e confere holerites, cartões de ponto, extrato do FGTS e TRCT transcritos (somas, meses faltantes, marcações impossíveis).
• Faz a auditoria pericial integral do processo antes de calcular: cada pedido da inicial até o comando final transitado, os documentos financeiros mês a mês, os cartões de ponto dia a dia e a parametrização de cada aba do PJe-Calc, com as lacunas e contradições apontadas.
• Atualiza as tabelas de índices do PJe-Calc pelo tribunal do processo antes de liquidar.
• Confere o que o PJe-Calc calculou: refaz a conta por conta própria (verbas, juros, FGTS, INSS, IR, honorários, custas) e compara ao centavo com os relatórios do programa; confere a soma das verbas, os valores negativos, as verbas que ficaram sem cálculo, os critérios que o sistema aplicou e as regras de validação do próprio PJe-Calc.
• Compara com outra conta (do perito, da parte ou outro cenário), inclusive um relatório em PDF ou a conta transcrita, e mostra de onde vem cada diferença.
• Entrega um arquivo de cálculo (-PRONTO.PJC) que pode ser aberto em qualquer PJe-Calc 2.16 e liquidado direto, e, quando liquida, o relatório completo do PJe-Calc em PDF (-RELATORIO.pdf): resumo, dados, faltas e férias, histórico salarial, cartão de ponto, demonstrativo de cada verba com base, divisor, multiplicador e quantidade (dias e horas), juros, FGTS, contribuição social, IR, honorários, custas e justificativa, só com as seções que se aplicam ao cálculo.

Tudo roda no seu computador. O PJe-Calc é aberto e operado em segundo plano, sem você precisar mexer nele, e nenhum dado do processo é enviado a terceiros por esta ferramenta. O assistente de IA que você usar segue as regras dele.

Onde funciona e onde não funciona

Por que precisa de um agente no computador

Esta ferramenta é um servidor MCP. MCP (Model Context Protocol) é o padrão que permite a um assistente de IA usar programas que estão no seu computador. Aqui, o assistente usa o servidor para:

• abrir o PJe-Calc instalado na sua máquina e operá-lo em segundo plano;
• ler os documentos do processo que estão nas suas pastas;
• criar, importar, liquidar e exportar os cálculos;
• gravar os arquivos .PJC e os relatórios no seu disco.

Por isso, o assistente tem de ser um programa instalado e aberto no mesmo computador Windows em que está o PJe-Calc, e precisa aceitar servidores MCP locais. Um chat que roda no site de uma empresa não enxerga o seu computador: para ele, o PJe-Calc e os seus arquivos não existem.

Funciona (assistentes instalados no Windows)

Cada assistente tem as próprias regras de conta e de plano: confira no site dele. Qualquer outro programa que aceite servidores MCP locais também serve; os exemplos de registro estão em mcp-config.json.

Não funciona

Também não funciona com o computador desligado ou com o assistente fechado: o assistente opera o PJe-Calc enquanto conversa com você.

Qual modelo usar

O MCP confere a aritmética e as regras do PJe-Calc, mas quem lê o processo e decide o que vai para o cálculo é o modelo de IA. Modelos menores ou mais rápidos pulam páginas, confundem decisões reformadas e erram datas. Para maior precisão:

• Escolha o modelo no seletor do próprio assistente. Quando houver nível de raciocínio ("esforço", reasoning effort), use o mais alto para ler processos e montar o plano.
• Modelos de gerações anteriores ou versões "mini" e "rápidas" não são recomendados para montar cálculos; servem, no máximo, para perguntas simples sobre o PJe-Calc.
• Nenhum modelo dispensa a sua revisão: o plano de interpretação existe para você conferir o que o assistente entendeu antes de calcular.

Como saber se está funcionando

1. Depois de instalar, feche e abra o assistente de novo.
2. Pergunte: "Verifique se o PJe-Calc MCP está funcionando."
3. O assistente deve usar ferramentas que começam com pjecalc_, calculo_, catalogo_... (por exemplo, pjecalc_status) e responder se encontrou o PJe-Calc e se ele está aberto.

Se o assistente disser que não tem essas ferramentas, ele não carregou o MCP: rode Conferir PJe-Calc MCP.bat, que mostra o que falta, e confira se o assistente usado é um dos da tabela acima.

O que você precisa

• Um computador com Windows.
• Obrigatório: o PJe-Calc Cidadão 2.16 instalado, ou seja, baixado e extraído (disponível no site oficial do TRT da 8ª Região). Pode estar em qualquer pasta: o instalador encontra sozinho.
• Um assistente de IA instalado no computador e compatível com MCP: Claude Desktop, Claude Code, Codex, Cursor, VS Code com Copilot ou Windsurf/Devin Desktop (veja a tabela, com os links oficiais). Chats no navegador não servem.

Como instalar

No Claude Desktop: extensão de um clique

1. Baixe o arquivo pjecalc-mcp-<versão>.mcpb da página de versões.
2. Dê dois cliques no arquivo (ou, no Claude Desktop, abra Configurações > Extensões e arraste o arquivo para a janela) e confirme a instalação.
3. Pronto. Os campos da extensão são opcionais: a pasta do PJe-Calc (em branco, o MCP encontra sozinho) e a pasta dos cálculos gerados (em branco, Documentos\PJe-Calc MCP).

O Claude Desktop já traz o Node.js; não é preciso instalar mais nada além do PJe-Calc.

Em qualquer assistente: instalador para Windows

1. Baixe o arquivo .zip da página de versões e extraia em qualquer pasta.
2. Dê dois cliques em Instalar PJe-Calc MCP.bat. O instalador:
   • baixa o Node.js portátil oficial se ele não estiver no computador (sem instalar nada no Windows e sem pedir senha de administrador);
   • procura o PJe-Calc no computador. Se houver mais de uma instalação, pergunta qual usar; se não houver nenhuma, explica o que fazer;
   • pergunta em quais assistentes registrar e guarda uma cópia de segurança das configurações deles;
   • faz um teste rápido.
3. Feche e abra o assistente de novo.

Outros arquivos da pasta:

• Conferir PJe-Calc MCP.bat mostra se está tudo funcionando e o que falta.
• Desinstalar PJe-Calc MCP.bat tira o registro dos assistentes. O PJe-Calc e os seus cálculos não são tocados.

Instruções para o agente (instalação automática)

Se você é um assistente de IA instalando esta ferramenta para o usuário:

1. Confirme que você roda no computador do usuário, com acesso ao disco e ao terminal do Windows, e que aceita servidores MCP locais (stdio). Se você é um chat no navegador ou um agente na nuvem, não tente instalar: explique ao usuário que ele precisa de um assistente instalado no computador (tabela em onde funciona) ou da instalação manual.

2. Confirme que o PJe-Calc Cidadão 2.16 está instalado. Ele fica numa pasta que tem bin e tomcat, baixada e extraída do site oficial do TRT da 8ª Região. Se não estiver, peça ao usuário que baixe e extraia o PJe-Calc. Não continue sem ele.

3. Baixe a versão mais recente e extraia numa pasta do usuário. O arquivo PJeCalcMCP-<versão>.zip está em https://github.com/lucianumm/PJeCalcMCP/releases/latest. Também serve git clone https://github.com/lucianumm/PJeCalcMCP.

4. Rode o instalador na pasta extraída.

   • Interativo, igual a Instalar PJe-Calc MCP.bat: pergunta em quais assistentes registrar.

     powershell -NoProfile -ExecutionPolicy Bypass -File instalador\iniciar.ps1 instalar
     

   • Sem perguntas: defina antes $env:INSTALADOR_SIM='1'. Ele registra em todos os assistentes encontrados.

   O instalador garante o Node.js 20 ou mais novo (baixa o portátil oficial se faltar), localiza o PJe-Calc, registra o servidor com cópia de segurança das configurações e faz um teste. Se o PJe-Calc estiver numa pasta que ele não encontre, defina PJECALC_HOME com essa pasta.

5. Alternativa: registre só o seu próprio assistente. Use o servidor MCP (stdio) node <pasta>\server\server.mjs, com PJECALC_HOME apontando para o PJe-Calc. O mcp-config.json tem exemplos para Claude, Codex, Cursor, VS Code e Windsurf. No Claude Code: claude mcp add pjecalc --scope user -e PJECALC_HOME=<pasta do PJe-Calc> -- node <pasta>\server\server.mjs.

6. Confira a instalação. Rode instalador\iniciar.ps1 conferir e peça ao usuário que reabra o assistente.

7. Para montar cálculos, siga o SKILL.md. Comece pedindo os documentos (calculo_documentos_necessarios) e nunca grave cálculos direto no banco do PJe-Calc.

Como usar

Converse normalmente com o assistente, por exemplo:

Monte no PJe-Calc o cálculo desta sentença. Seguem a sentença, o acórdão, os holerites e os cartões de ponto.

Ou, para uma análise completa antes de calcular:

Faça a auditoria pericial integral deste processo e me mostre o plano.

O assistente:

1. identifica a fase do processo e os outros processos ligados a ele (ação anterior, coletiva, acordo, recuperação judicial...);
2. pede os documentos que o caso exige (sentença, acórdãos, holerites, cartões de ponto, TRCT, extrato do FGTS, documentos dos outros processos...) e confere se cobrem todo o período;
3. lê todas as páginas, inclusive as escaneadas, e pede os complementos que faltarem;
4. monta o título a partir de todas as decisões (vara, TRT, TST, STF, liquidação e execução);
5. mostra um plano de interpretação para você aprovar antes de calcular;
6. monta o cálculo no PJe-Calc e atualiza as tabelas de índices do seu tribunal;
7. mostra os valores, o que foi conferido e o arquivo pronto.

Na execução, por exemplo:

Atualize até hoje o cálculo homologado (arquivo anexo), abatendo o depósito de fl. 300 e o alvará de fl. 330, e inclua os honorários da execução.

Depois é só abrir o PJe-Calc, escolher o cálculo em "Abrir Cálculos Recentes", conferir e clicar em Operações > Liquidar.

Como funciona, em poucas palavras

O PJe-Calc tem uma função oficial de exportar e importar cálculos (arquivos .PJC). Esta ferramenta monta esse arquivo a partir do que o assistente extraiu dos documentos.

Ela importa o arquivo no PJe-Calc do seu computador e usa as próprias telas do programa para os passos finais: regerar as verbas, apurar o cartão de ponto, atualizar tabelas, liquidar e, na execução, liquidar a atualização. Assim, todas as contas são feitas pelo motor oficial do PJe-Calc.

A ferramenta foi testada comparando cálculos montados por ela com os mesmos cálculos feitos à mão na tela do PJe-Calc, inclusive atualizações com pagamentos e cálculos externos. Os resultados foram idênticos, centavo por centavo.

Perguntas frequentes

Funciona no ChatGPT, no Claude ou no Gemini pelo navegador? Não. Chats no navegador e aplicativos de celular rodam nos servidores da empresa e não alcançam o seu computador, onde estão o PJe-Calc e os documentos. Use um assistente instalado no Windows: Claude Desktop, Claude Code, Codex, Cursor, VS Code com Copilot ou Windsurf/Devin Desktop (links na tabela).

Tenho conta no ChatGPT. Posso usar? Pelo site ou aplicativo do ChatGPT, não. Da OpenAI, o que funciona é o Codex instalado no computador (https://github.com/openai/codex). O Codex na nuvem, aberto pelo site, também não serve, porque roda numa máquina remota.

Tenho conta no Claude. Posso usar? Sim, pelo Claude Desktop (https://claude.com/download) ou pelo Claude Code (https://claude.com/product/claude-code), instalados no computador. Pelo site claude.ai, pelo aplicativo de celular ou pelo Claude Code na web, não.

Preciso saber programar? Não. Depois de instalado, você conversa normalmente com o assistente. O Claude Code e o Codex podem rodar no terminal, mas também têm aplicativo ou extensão de editor; o Claude Desktop é um aplicativo comum.

Onde ele procura o PJe-Calc? Nesta ordem:

1. na pasta escolhida da última vez;
2. no PJe-Calc que estiver aberto;
3. na pasta onde a ferramenta foi extraída;
4. em Downloads, Área de Trabalho, Documentos, Arquivos de Programas e na raiz dos discos.

Se você mudar o PJe-Calc de pasta, ele procura de novo sozinho.

Precisa de internet? Só para baixar o Node.js na instalação e para atualizar as tabelas de índices do PJe-Calc.

Posso usar com mais de um assistente? Sim. O instalador registra em todos os que você escolher.

O resultado é garantido? Não. O PJe-Calc calcula corretamente o que foi informado, mas a interpretação da sentença e dos documentos precisa ser conferida por você. Para facilitar, cada informação do cálculo fica ligada ao documento e ao trecho da decisão de onde saiu, e a ferramenta informa em que ponto o cálculo está:

• aceito pelo aplicativo: o PJe-Calc aceitou;
• calculado: os números foram conferidos, inclusive se nenhuma verba ficou sem cálculo;
• simulação: a conta depende de uma hipótese ainda não decidida (por exemplo, um recibo contestado);
• auditado: cada item tem origem na prova e na decisão que vale, sem dúvidas abertas, com os alertas revisados e o plano aprovado por você;
• provisório: marcado quando ainda há decisão sujeita a recurso.

Em todos os casos, a revisão final é sua. O cálculo também deixa um registro com as versões e os dados usados, para poder ser reproduzido depois.

Onde estão as instruções

• SKILL.md: as regras que o assistente segue, do começo ao fim do cálculo.
• references/: todos os campos aceitos, o contrato de dados, o roteiro de auditoria pericial e as conferências por assunto (leitura, jornada, pagamentos, FGTS e tributos, atualização, execução, conta de referência).
• exemplos/: cálculos completos prontos para usar como modelo.
• scripts/: os testes.

Créditos

Criado e mantido por Lucianum — Instagram @lucianum · GitHub @lucianumm

Aviso

Projeto independente, sem vínculo com a Justiça do Trabalho. O PJe-Calc Cidadão não faz parte deste repositório e deve ser baixado no site oficial.

Licença

Copyright (C) 2026 Lucianum.

Distribuído sob a GNU Affero General Public License v3.0 (AGPL-3.0). Você pode usar, estudar, modificar e redistribuir livremente. Quem distribuir uma versão modificada, ou oferecê-la como serviço pela rede, deve publicar o código-fonte sob a mesma licença.