PJe-Calc MCP

PJe-Calc MCP

プロジェクトを支援する

コーヒーをごちそうしてください
_{Pix QRコード：銀行アプリを開き、Pix > QRコードを読み取るを選択して、カメラをかざしてください。}

上の画像はPix QRコードです。このツールで時間を節約できた場合は、コーヒー1杯分の支援をご検討ください。ご支援は、プロジェクトを最新かつ稼働した状態に保つために役立ちます。PJe-Calcやテーブルの新バージョンへの対応、実際の計算で見つかった不具合の修正、新しい計算種別の追加などに活用されます。

お問い合わせ、アイデア、不具合の報告、ご提案はこちら： [email protected]

---

Claude Desktop、Claude Code、Codex、Cursor、VS Codeなど、お使いのコンピューターにインストールされたAI アシスタントを、労働裁判所公式の計算プログラムである PJe-Calc Cidadão に接続します。

判決文と訴訟書類をアシスタントに渡すと、PJe-Calc内で労働計算全体を作成します。あとは内容を確認して、清算をクリックするだけです。

ブラウザーで開くAIチャット（claude.ai、chatgpt.com、Gemini、Copilotのウェブ版など）や、スマートフォンアプリでは動作しません。アシスタントは、PJe-CalcがインストールされているWindowsコンピューターと同じコンピューター上で実行する必要があります。動作する環境と動作しない環境をご覧ください。

**補助ツールです。**計算はPJe-Calc自体が行いますが、入力する内容は、提供された情報をもとにアシスタントが判断します。訴訟で使用する前に、必ず結果を確認してください。アシスタントには、採用した前提と、書類から明確に読み取れなかった点を示させてください。

最先端のAIモデルを使用してください。数百ページに及ぶ訴訟記録、変更された判決、日々のタイムカードなどを読み解くには、利用可能な最も高性能なモデルが必要です。CodexではGPT-6 Luna以上、ClaudeではClaude Sonnet 5.5以上（Claude Opus 5.5など）、その他のアシスタントでは同世代のモデルを使用してください。使用するモデルをご覧ください。

最も簡単な方法：エージェントにリンクを貼り付ける

Claude Code、Claude Desktop、Codex、Cursor、Copilot搭載のVS Codeなど、コンピューターにインストールされたAI エージェントをすでに使用している場合は、リンクを貼り付けるだけです。

https://github.com/lucianumm/PJeCalcMCP

たとえば、次のように依頼します。*「このMCPをインストールして設定してください：https://github.com/lucianumm/PJeCalcMCP」*。エージェントが以下の[エージェント向けの手順（自動インストール）](#instruções-para-o-agente-instalação-automática)に従って、ツールをダウンロード、インストール、登録します。

ブラウザーで開いたチャット（claude.ai、chatgpt.comなど）にリンクを貼り付けても、何もインストールされません。そのチャットは企業のサーバー上で動作しているため、お使いのコンピューターにはアクセスできません。プロジェクトについて説明することはできますが、PJe-Calcのダウンロード、インストール、操作はできません。コンピューター上にエージェントをまだお持ちでない場合は、動作する環境の表をご覧いただくか、エージェントが不要な手動インストールをご利用ください。

**重要：**コンピューターに PJe-Calc Cidadão 2.16をインストール（ダウンロードして展開）しておく必要があります。このツールは、お使いのコンピューター上のPJe-Calcを操作するものであり、プログラムの代わりになるものでも、プログラムを同梱するものでもありません。PJe-Calcがなければ、何も動作しません。

できること

• PJe-Calcで計算全体を作成します。
  • 事件および当事者の情報、契約日、給与。
  • 欠勤、休暇、タイムカード（勤務時間に基づく時間外労働を含む）。
  • 項目と反映額。書類で求められる場合は月ごとの金額も含みます（各給与明細で支払われた金額、月ごとの数量）。
  • PJe-Calcのテーブルに基づく最低賃金と交通費。
  • FGTS、INSS、所得税、年金、企業年金、家族手当、失業保険。さらに、発生記録画面の項目別調整（FGTSの算定基礎額と預入額、INSSの給与と納付済み保険料。まとめての調整も可能）。
  • 弁護士報酬（選択した項目に対する報酬を含む）、罰金、訴訟費用（定額費用、訴訟記録、保管費用を含む）、通貨調整、利息。
• 執行時には、支払い（預入金、支払命令）に基づいて認可済みの計算を更新し、弁護士報酬、罰金、扶養料、執行費用（行為ごとの費用、訴訟記録、保管費用）、前払い債権または少額支払請求（RPV）も更新します。また、PJe-Calc以外で作成した計算（外部計算）も更新します。複数の計算を一度に実行できます（申立人ごと、または債務者ごと）。
• 書類の読み取りを支援します。ページ（画像として確認する必要があるスキャンページを含む）の一覧を作成し、PDFからテキストを抽出し、スキャンページの画像をアシスタントが確認できるようにします。また、転記された給与明細、タイムカード、FGTS明細、TRCTを検証します（合計、欠落月、あり得ない記録）。さらに、AuditorProcessualによる読み取りも活用します。PJeのフッターに基づいて書類とページを分類し、勤務時間、給与明細、契約上のイベントを整理済みの状態で取り込みます。
• 計算前に、事件全体の鑑定監査を行います。訴状の各請求から確定した最終命令まで、月ごとの財務書類、日ごとのタイムカード、PJe-Calcの各タブの設定を確認し、欠落や矛盾を指摘します。
• 清算前に、事件を担当する裁判所に合わせてPJe-Calcの指数テーブルを更新します。
• PJe-Calcの計算結果を検証します。項目、利息、FGTS、INSS、所得税、弁護士報酬、訴訟費用を独自に再計算し、プログラムのレポートと1セント単位で比較します。また、項目の合計、マイナス値、計算されなかった項目、システムが適用した基準、PJe-Calc自体の検証ルールも確認します。
• 他の計算（鑑定人、当事者、または別のシナリオによる計算）と比較します。PDFレポートや転記された計算も対象となり、差異の原因をそれぞれ示します。
• どのPJe-Calc 2.16でも開いてそのまま清算できる計算ファイル（-PRONTO.PJC）を作成します。清算後は、PJe-Calcの完全なレポートPDF（-RELATORIO.pdf）も作成します。レポートには、計算に該当するセクションのみが含まれ、概要、データ、欠勤と休暇、給与履歴、タイムカード、各項目の算定基礎額・除数・乗数・数量（日数と時間）、利息、FGTS、社会保険料、所得税、弁護士報酬、訴訟費用、根拠が記載されます。

すべての処理はお使いのコンピューター上で実行されます。PJe-Calcはバックグラウンドで起動・操作されるため、ご自身で操作する必要はありません。また、このツールによって事件のデータが第三者に送信されることはありません。使用するAIアシスタントには、そのアシスタント独自のルールが適用されます。

対応している環境と対応していない環境

コンピューター上のエージェントが必要な理由

このツールはMCP サーバーです。MCP（Model Context Protocol） は、AI アシスタントがコンピューター上のプログラムを利用できるようにする標準規格です。ここでは、 アシスタントはサーバーを使って次のことを行います。

• お使いのコンピューターにインストールされた PJe-Calc を開き、バックグラウンドで操作する；
• フォルダー内にある事件関連の書類を読み取る；
• 計算を作成、インポート、精算、エクスポートする；
• .PJC ファイルとレポートをディスクに保存する。

そのため、アシスタントは PJe-Calc がインストールされているものと同じ Windows コンピューターに インストールされ、起動しているプログラムであり、ローカル MCP サーバーに対応している必要があります。企業の Web サイト上で動作するチャットからはお使いのコンピューターが見えないため、PJe-Calc やそのファイルは 存在しないのと同じです。

利用可能（Windows にインストールするアシスタント）

アシスタント	内容	ダウンロード先（公式サイト）	MCP の接続方法
Claude Desktop	Anthropic の Windows 用アプリケーション。チャットとコードタブを備えています	https://claude.com/download	ワンクリック拡張機能（.mcpb）またはインストーラー
Claude Code	ターミナル、VS Code と JetBrains、Claude Desktop で使える Anthropic のエージェント	https://claude.com/product/claude-code（MCP のドキュメント：https://code.claude.com/docs/en/mcp）	インストーラーが自動で登録します（コマンド claude mcp add）
Codex	ターミナル、エディター拡張機能、アプリケーションで使える OpenAI のエージェント	https://github.com/openai/codex（ドキュメント：https://developers.openai.com/codex）	インストーラーが自動で登録します（~/.codex/config.toml）
Cursor	AI エージェントを備えたコードエディター	https://cursor.com/download（MCP のドキュメント：https://cursor.com/docs/mcp）	インストーラーが自動で登録します
VS Code とエージェントモードの GitHub Copilot	Microsoft のエディター	https://code.visualstudio.com（MCP のドキュメント：https://code.visualstudio.com/docs/agent-customization/mcp-servers）	インストーラーが自動で登録します
Windsurf（現在の名称は Devin Desktop）	AI エージェントを備えたエディター	https://devin.ai/desktop	インストーラーが Windsurf の設定に登録します。Devin Desktop に表示されない場合は、mcp-config.json を使って手動で登録してください

各アシスタントには独自のアカウントとプランの規則があります。各公式サイトでご確認ください。ローカル MCP サーバーに対応しているほかのプログラムも利用できます。登録例は mcp-config.json にあります。

利用不可

環境	理由
ブラウザー上の AI チャット：claude.ai、chatgpt.com、gemini.google.com、Web 版 Copilot など	企業のサーバー上で動作するため、お使いのコンピューターにも PJe-Calc にもアクセスできません
携帯電話やタブレットのアプリケーション（Claude、ChatGPT、Gemini など）	PJe-Calc はコンピューター上の Windows でのみ動作します
クラウド上で動作するエージェント：Web 版 Claude Code、クラウド版 Codex（ChatGPT の Web サイト経由）など	お使いの PJe-Calc やファイルのないリモート仮想マシン上で動作します
Web サイトまたはアプリケーション経由の ChatGPT	インターネット上で動作するコネクターにのみ対応しており、お使いのコンピューター上で動作する MCP サーバーには対応していません。OpenAI の製品では Codex をお使いください
macOS または Linux のコンピューター	このツールとインストーラーは、Windows 上の PJe-Calc 専用に作成、テストされています

また、コンピューターの電源が切れている場合やアシスタントを終了している場合も動作しません。アシスタントは、 あなたとの会話中に PJe-Calc を操作します。

使用するモデル

MCP は PJe-Calc の算術処理とルールを確認しますが、訴訟記録を読み、計算に何を含めるかを決めるのは AI モデルです。小型または高速なモデルはページを読み飛ばしたり、変更された判決を取り違えたり、日付を誤ったりします。精度を高めるには、次のモデルをおすすめします。

アシスタント	推奨モデル
Codex（OpenAI）	GPT-6 Luna 以降
Claude Desktop および Claude Code（Anthropic）	Claude Sonnet 5.5 以降（例：Claude Opus 5.5）
Cursor、Copilot 搭載の VS Code、Windsurf/Devin Desktop など	上記と同じ世代の、利用可能な最上位モデル

• アシスタントのモデル選択メニューでモデルを選んでください。推論レベル（「努力度」、reasoning effort）を設定できる場合は、訴訟記録を読み、計画を作成するために最高レベルを使用してください。
• 旧世代のモデルや「mini」「fast」バージョンは、計算の作成にはおすすめしません。せいぜい PJe-Calc に関する簡単な質問に使う程度です。
• どのモデルを使う場合も、ご自身で確認する必要があります。解釈プランは、計算前にアシスタントが理解した内容を確認するためのものです。

動作確認の方法

1. インストール後、アシスタントを一度終了してから再起動します。
2. *「PJe-Calc MCP が動作しているか確認してください。」*と質問します。
3. アシスタントは、pjecalc_、calculo_、catalogo_... で始まるツール（例：pjecalc_status）を使用し、PJe-Calc が見つかったか、起動しているかを回答します。

アシスタントがこれらのツールを持っていないと答えた場合、MCP が読み込まれていません。**Conferir PJe-Calc MCP.bat**を実行して不足しているものを確認し、使用しているアシスタントが上記の表にあるものか確かめてください。

必要なもの

• Windows 搭載のコンピューター。
• 必須： PJe-Calc Cidadão 2.16 がインストール済みであること。つまり、ダウンロードして展開してある必要があります（第 8 地域の TRT の公式サイトから入手できます）。どのフォルダーに置いてもかまいません。インストーラーが自動で見つけます。
• MCP に対応した、コンピューターにインストール済みの AI アシスタント：Claude Desktop、Claude Code、Codex、Cursor、Copilot 搭載の VS Code、Windsurf/Devin Desktop（公式リンクを掲載した表を参照）。ブラウザー上のチャットは使用できません。

インストール方法

Claude Desktop の場合：ワンクリック拡張機能

1. リリースページから**pjecalc-mcp-<versão>.mcpb**ファイルをダウンロードします。
2. ファイルをダブルクリックします（または、Claude Desktop で設定 > 拡張機能を開き、ファイルをウィンドウにドラッグします）。その後、インストールを確認します。
3. 完了です。拡張機能の設定項目は任意です。PJe-Calc のフォルダー（空欄の場合、MCP が自動で見つけます）と生成した計算の保存先フォルダー（空欄の場合は ドキュメント\PJe-Calc MCP）を指定できます。

Claude Desktop には Node.js が付属しているため、PJe-Calc 以外にインストールするものはありません。

すべてのアシスタントの場合：Windows 用インストーラー

1. リリースページから .zip ファイルをダウンロードし、任意のフォルダーに展開します。
2. **Instalar PJe-Calc MCP.bat**をダブルクリックします。インストーラーは次の処理を行います。
   • コンピューターにない場合は、公式のポータブル版 Node.js をダウンロードします（Windows へのインストールや管理者パスワードは不要です）。
   • コンピューター内で PJe-Calc を検索します。複数のインストールが見つかった場合は、どれを使うか尋ねます。見つからない場合は、必要な手順を説明します。
   • MCP を登録するアシスタントを尋ね、各アシスタントの設定のバックアップを保存します。
   • 簡易テストを実行します。
3. アシスタントを一度終了してから再起動します。

フォルダー内のその他のファイル：

• **Conferir PJe-Calc MCP.bat**は、すべて正常に動作しているか、不足しているものがあるかを表示します。
• **Desinstalar PJe-Calc MCP.bat**は、アシスタントから登録を削除します。PJe-Calc と計算データには手を加えません。

エージェント向け手順（自動インストール）

ユーザーのためにこのツールをインストールする AI アシスタントの場合：

0. ユーザーのコンピューター上で動作しており、ディスクと Windows のターミナルにアクセスできること、およびローカル MCP サーバー（stdio）を受け入れることを確認してください。ブラウザー上のチャットまたはクラウド上のエージェントの場合は、インストールを試みないでください。コンピューターにインストールされたアシスタント（利用できる場所の表を参照）または手動インストールが必要であることをユーザーに説明してください。

1. PJe-Calc Cidadão 2.16 がインストールされていることを確認してください。 bin と tomcat を含むフォルダーにあり、第 8 地域労働裁判所（TRT）の公式サイトからダウンロードして展開されています。インストールされていない場合は、PJe-Calc をダウンロードして展開するようユーザーに依頼してください。インストールされていない状態で先に進まないでください。

2. 最新バージョンをダウンロードし、ユーザーのフォルダーに展開してください。 ファイル PJeCalcMCP-<versão>.zip は https://github.com/lucianumm/PJeCalcMCP/releases/latest にあります。git clone https://github.com/lucianumm/PJeCalcMCP でも構いません。

3. 展開したフォルダーでインストーラーを実行してください。

   • 対話形式の場合は、Instalar PJe-Calc MCP.bat と同様に、登録するアシスタントを尋ねます。

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

   • 質問を省略する場合は、事前に $env:INSTALADOR_SIM='1' を設定してください。検出されたすべてのアシスタントに登録されます。

   インストーラーは Node.js 20 以降を確保し（ない場合は公式ポータブル版をダウンロード）、PJe-Calc を検索し、設定のバックアップを作成してサーバーを登録し、テストを実行します。インストーラーが PJe-Calc を見つけられないフォルダーにある場合は、そのフォルダーを PJECALC_HOME に設定してください。

4. 代替方法：使用するアシスタントだけを登録します。 PJECALC_HOME が PJe-Calc を指すように設定し、MCP サーバー（stdio）node <pasta>\server\server.mjs を使用してください。mcp-config.json に Claude、Codex、Cursor、VS Code、Windsurf 用の例があります。Claude Code の場合： claude mcp add pjecalc --scope user -e PJECALC_HOME=<pasta do PJe-Calc> -- node <pasta>\server\server.mjs。

5. インストールを確認してください。 instalador\iniciar.ps1 conferir を実行し、アシスタントを再起動するようユーザーに依頼してください。

6. 計算を作成するには、SKILL.md に従ってください。 まず書類を求め（calculo_documentos_necessarios）、PJe-Calc のデータベースに計算を直接書き込まないでください。

使い方

アシスタントに通常どおり話しかけてください。たとえば：

PJe-Calc でこの判決の計算を作成してください。判決文、控訴審判決、給与明細、勤怠記録を添付します。

計算の前に全体を分析する場合は、次のように依頼してください：

この事件について完全な鑑定監査を行い、計画を提示してください。

アシスタントは次のことを行います：

1. 訴訟の段階と、関連する他の事件（以前の訴訟、集団訴訟、和解、司法再建など）を特定します。
2. 事件に必要な書類（判決文、控訴審判決、給与明細、勤怠記録、TRCT、FGTS 明細、他の事件の書類など）を求め、全期間が網羅されているか確認します。
3. スキャンされたページも含め、すべてのページを読み、不足している補足書類を求めます。
4. すべての決定（第一審裁判所、TRT、TST、STF、清算、執行）に基づいて債務名義を作成します。
5. 計算前に承認していただくため、解釈計画を提示します。
6. PJe-Calc で計算を作成し、管轄裁判所の指数テーブルを更新します。
7. 金額、確認した内容、完成したファイルを提示します。

執行の場合、たとえば次のように依頼できます：

添付ファイルの認可済み計算を本日まで更新し、300 ページの供託金と 330 ページの支払命令を控除して、執行費用を含めてください。

あとは PJe-Calc を開き、「最近の計算を開く」で計算を選択して確認し、操作 > 清算をクリックするだけです。

簡単に説明すると

PJe-Calcには、計算結果をエクスポートおよびインポートする公式機能（.PJCファイル）があります。このツールは、アシスタントが文書から抽出した情報をもとに、そのファイルを作成します。

このツールは、お使いのコンピューター上のPJe-Calcにファイルをインポートし、プログラム自体の画面を使って最終手順を実行します。具体的には、報酬項目の再生成、タイムカードの集計、テーブルの更新、清算、さらに執行時には更新分の清算を行います。そのため、すべての計算はPJe-Calcの公式エンジンで実行されます。

このツールで作成した計算結果を、PJe-Calcの画面上で手作業で作成した同じ計算結果と比較して検証しました。支払いを含む更新や外部計算も検証対象です。結果は1セント単位まで一致しました。

よくある質問

ブラウザーからChatGPT、Claude、Geminiを使って利用できますか？ いいえ。ブラウザー上のチャットやスマートフォンアプリは企業のサーバー上で動作するため、PJe-Calcや文書があるお使いのコンピューターにはアクセスできません。Windowsにインストールしたアシスタントを使用してください。Claude Desktop、Claude Code、Codex、Cursor、Copilotを搭載したVS Code、またはWindsurf/Devin Desktopが利用できます（リンクは表を参照）。

ChatGPTのアカウントを持っています。利用できますか？ ChatGPTのウェブサイトまたはアプリからは利用できません。OpenAIの製品で利用できるのは、コンピューターにインストールするCodex（https://github.com/openai/codex）です。ウェブサイトから開くクラウド版のCodexも、リモートマシン上で動作するため利用できません。

Claudeのアカウントを持っています。利用できますか？ はい。コンピューターにインストールしたClaude Desktop（https://claude.com/download）または**Claude Code**（https://claude.com/product/claude-code）から利用できます。claude.aiのウェブサイト、スマートフォンアプリ、ウェブ版のClaude Codeからは利用できません。

プログラミングの知識は必要ですか？ いいえ。インストール後は、通常どおりアシスタントと会話するだけです。Claude CodeとCodexはターミナル上で実行できますが、アプリやエディター拡張機能もあります。Claude Desktopは一般的なアプリケーションです。

PJe-Calcはどこから探しますか？ 次の順に探します。

1. 前回選択したフォルダー
2. 起動中のPJe-Calc
3. ツールを展開したフォルダー
4. Downloads、Área de Trabalho、Documentos、Arquivos de Programas、およびディスクのルートフォルダー

PJe-Calcのフォルダーを変更した場合は、自動的に再検索します。

インターネット接続は必要ですか？ インストール時にNode.jsをダウンロードするときと、PJe-Calcのインデックステーブルを更新するときにのみ必要です。

複数のアシスタントで使えますか？ はい。選択したすべてのアシスタントにインストーラーが登録します。

結果は保証されますか？ いいえ。PJe-Calcは入力された情報を正しく計算しますが、判決や文書の解釈はご自身で確認する必要があります。確認しやすいよう、計算の各情報は、根拠となった文書および決定の該当箇所にひも付けられます。また、ツールは計算の進捗状況を次のように示します。

• アプリケーションで受理済み：PJe-Calcが受理しました。
• 計算済み：数値を確認済みです。計算されていない報酬項目がないことも確認しています。
• シミュレーション：まだ決定されていない仮定に基づく計算です（例：異議が申し立てられている領収書）。
• 監査済み：各項目の根拠が証拠および適用される決定で確認され、未解決の疑問がなく、警告が確認され、計画がご自身に承認されています。
• 暫定：まだ不服申立ての対象となる決定がある場合に付けられます。

いずれの場合も、最終確認はご自身で行ってください。また、計算には使用したバージョンとデータの記録が残るため、後から再現できます。

手順の場所

• SKILL.md：計算の最初から最後まで、アシスタントが従うルール。
• references/：受け付けるすべてのフィールド、データ仕様、鑑定監査の手順、および項目別の確認事項（文書の読み取り、勤務時間、支払い、FGTSと税金、更新、執行、参照計算）。
• exemplos/：モデルとして使える、完成済みの計算例。
• scripts/：テスト。

クレジット

Lucianum が作成・保守しています — Instagram @lucianum · GitHub @lucianumm

免責事項

独立したプロジェクトであり、労働裁判所とは関係ありません。PJe-Calc Cidadão はこのリポジトリには含まれていないため、公式サイトからダウンロードしてください。

ライセンス

Copyright (C) 2026 Lucianum.

GNU Affero General Public License v3.0（AGPL-3.0）のもとで配布されています。自由に使用、調査、改変、再配布できます。改変版を配布する場合、またはネットワーク経由でサービスとして提供する場合は、同じライセンスのもとでソースコードを公開する必要があります。