PJe-Calc MCP

Apoie o projeto

<p align="center"> <img src="imagens/me-pague-um-cafe.png" alt="QR Code Pix para apoiar o projeto" width="220"><br> <strong>Me pague um Café</strong><br> _{QR Code <strong>Pix</strong>: abra o aplicativo do seu banco, escolha Pix &gt; Ler QR Code e aponte a câmera.} </p>

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). Aproveita também a leitura feita pelo AuditorProcessual: separa os documentos e as folhas pelo rodapé do PJe e traz a jornada, a folha de pagamento e os eventos do contrato já organizados.
• 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)

| assistente | o que é | onde baixar (site oficial) | como o MCP entra | |---|---|---|---| | Claude Desktop | aplicativo da Anthropic para Windows, com chat e a aba de código | https://claude.com/download | extensão de um clique (.mcpb) ou o instalador | | Claude Code | agente da Anthropic no terminal, no VS Code e JetBrains e no Claude Desktop | https://claude.com/product/claude-code (documentação do MCP: https://code.claude.com/docs/en/mcp) | o instalador registra sozinho (comando claude mcp add) | | Codex | agente da OpenAI no terminal, em extensões de editor e no aplicativo | https://github.com/openai/codex (documentação: https://developers.openai.com/codex) | o instalador registra sozinho (~/.codex/config.toml) | | Cursor | editor de código com agente de IA | https://cursor.com/download (documentação do MCP: https://cursor.com/docs/mcp) | o instalador registra sozinho | | VS Code com GitHub Copilot no modo agente | editor da Microsoft | https://code.visualstudio.com (documentação do MCP: https://code.visualstudio.com/docs/agent-customization/mcp-servers) | o instalador registra sozinho | | Windsurf, hoje chamado Devin Desktop | editor com agente de IA | https://devin.ai/desktop | o instalador registra na configuração do Windsurf; se não aparecer no Devin Desktop, registre à mão com o mcp-config.json |

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

| onde | por quê | |---|---| | Chats de IA no navegador: claude.ai, chatgpt.com, gemini.google.com, Copilot na web e semelhantes | rodam nos servidores da empresa e não têm acesso ao seu computador nem ao PJe-Calc | | Aplicativos de celular e tablet (Claude, ChatGPT, Gemini...) | o PJe-Calc só roda no Windows, no computador | | Agentes que rodam na nuvem: Claude Code na web, Codex na nuvem (pelo site do ChatGPT) e semelhantes | trabalham numa máquina virtual remota, sem o seu PJe-Calc e sem os seus arquivos | | ChatGPT, pelo site ou pelo aplicativo | só aceita conectores que ficam na internet, não servidores MCP que rodam no seu computador; da OpenAI, use o Codex | | Computador com macOS ou Linux | a ferramenta e o instalador foram feitos e testados só para o PJe-Calc no Windows |

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:

| assistente | modelo recomendado | |---|---| | Codex (OpenAI) | GPT-6 Luna ou superior | | Claude Desktop e Claude Code (Anthropic) | Claude Sonnet 5.5 ou superior (por exemplo, Claude Opus 5.5) | | Cursor, VS Code com Copilot, Windsurf/Devin Desktop e outros | o modelo de ponta disponível, da mesma geração dos acima |

• 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