PJeCalcMCP

# 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>
  <sub>QR Code <strong>Pix</strong>: abra o aplicativo do seu banco, escolha Pix &gt; Ler QR Code e aponte a câmera.</sub>
</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](mailto: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](#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](#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](#instruções-para-o-agente-instalação-automática) 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](#onde-funciona-e-onde-não-funciona) ou use a
[instalação manual](#como-instalar), 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](https://modelcontextprotocol.io))
é 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`](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 pu