TradeCheck Local Invoice Review

TradeCheck MCP · 0.2.0 beta

輸入業者や購買チーム向けの、ローカルで使用する請求書レビュー用ツールです。1件の発注書、1件の仕入先請求書、提供された過去の請求書履歴を照合し、送信されていない仕入先への確認文を作成します。MCP を通じて利用できる決定論的なレビューエンジンと、ガイド付きエージェントプロンプトを提供します。ホスト型モデル、OCR サービス、ERP 連携、自律的に支払いを行うエージェントではありません。

ブラウザーのワークベンチをお試しください：https://rfqdesk.agiscorecard.com/agent

まずはこちら

1. Node.js 22 以降をインストールします。サイトからベータ版アーカイブをダウンロードして展開します。
2. 展開した tradecheck-mcp ディレクトリでターミナルを開きます。固定された依存関係をインストールし、同梱のビルドをテストします。

npm ci --ignore-scripts --no-audit --no-fund
npm test
npm run demo

デモでは、stdio を介して実際の MCP クライアントに接続し、架空の注文を読み込みます。符号付き価格差 EUR 44.00 と、累積数量 注文数 300 に対して 320 を検出します。これらは架空の差異であり、回収された金額ではありません。

3. MCP 対応のデスクトップアシスタントにサーバーを登録します。Claude Code の場合は、実際の絶対パスに置き換えてください。

claude mcp add tradecheck -- node /absolute/path/tradecheck-mcp/dist/server.js

Claude Code で /mcp を実行し、TradeCheck のツールが4つ表示されることを確認します。Cursor の場合は、MCP 設定に次のエントリーを追加します。

{"mcpServers":{"tradecheck":{"command":"node","args":["/absolute/path/tradecheck-mcp/dist/server.js"]}}}

Windows では、C:/Users/you/tradecheck-mcp/dist/server.js のような絶対パスを使用してください。デスクトップアプリから node が見つからない場合は、実行ファイルの絶対パスを使用します。このサーバーはローカルの stdio を使用し、リモート URL ではありません。

4. アシスタントに次のように尋ねます。「TradeCheck の review_supplier_invoice プロンプトを使ってください。まず架空の例を表示してください。次に、PO と請求書の準備を手伝ってください。抽出された項目を私と確認してから、二者間のレビューと、送信前の仕入先への確認文を作成してください。」

ホスト側でプロンプトが表示されない場合は、AGENT-WORKFLOW.md を貼り付けてください。PDF や画像の添付ファイルを読み取れるかどうかはホストによって異なります。このパッケージでは OCR を行いません。抽出品質に関するモデル評価は完了していません。実際の SDK クライアントとの往復テストは実施済みですが、このリリースで記載されているデスクトップホストを個別にテストしたわけではありません。

利用可能なツール

ツール	入力	出力
tradecheck_import_tables	PO／請求書のヘッダーメタデータ、CSV／TSV テキスト、明示的なゼロベースの列マッピング	未レビューの構造化データ、過去の履歴は不明
tradecheck_example	{}	固定された架空の入力と仕様
tradecheck_reconcile	{data, offset?:0, limit?:20}	概要、指摘事項のページ、指摘事項の総数、次のオフセット
tradecheck_supplier_draft	{data, language?:"en"}	例外／不足項目を最大20件含む、未送信の件名と本文

対象範囲については tradecheck://contract を参照してください。項目を捏造せず、サンプル JSON を使用してください。小数は文字列にする必要があります。不明な必須金額は解決する必要があります。空欄はゼロではありません。過去の請求書が欠けている可能性がある場合は、history_status:"unknown" のままにしてください。extraction_reviewed:true に設定するのは、担当者が元の書類と照らし合わせて項目を確認した後に限ります。

チェック内容

PO／仕入先識別子の完全一致、通貨の整合性、明示的な PO 明細のマッピング、SKU と単位、単価の変更、累積納入数量、納入済み ID の重複、明細／小計／ヘッダーの計算をチェックします。正当な分割請求は情報として示されます。すべての計算では、整数の小数スケールと、明細ごとの四捨五入（ちょうど半分は切り上げ）を使用します。金額の合計は小数点以下2桁、JPY の場合は整数で表示します。数量は小数点以下3桁、単価は小数点以下4桁に対応します。

対応通貨：USD、EUR、GBP、CAD、AUD、CNY、SGD、CHF、JPY。為替換算や単位換算は行いません。SKU が一致しても、PO 明細を推定することはできません。入力できるのは、PO／今回の明細が最大100行、過去の請求書が最大20件、過去の明細が最大1,000行です。レポートは指摘事項を最大25件ずつページ分割します。各指摘事項には、ソース位置情報を最大6件と、明示的な refs_omitted 件数が含まれます。ブラウザー／完全な JSON レポートには、提供されたすべての参照情報が保持されます。

結果に影響する制限

• 双方向照合では、納品、受領、品質、契約の受諾、通関、制裁措置、銀行口座情報、支払い適格性を確認できません。
• ソース参照と完全性は、呼び出し元の申告です。暗号学的な証拠でも、独立した文書検証でもありません。
• 負の値、クレジットノート、デポジット、割引、税額検証、別の丸め規則には対応していません。こうした文書には別のワークフローが必要です。
• 価格差異は、比較可能な照合済み明細行全体の符号付き合計であり、過払い額、節約額、回収額ではありません。
• 例外リストが空の場合、サポート対象の提供データに例外がないことだけを意味します。payment_authorized は常に false です。
• 中国語の下書きでは中国語の導入文を使用し、英語の診断行はそのまま保持します。アシスタントは、値と参照を保持しながら翻訳する場合があります。

プライバシーと運用

この MCP はネットワークへのリクエストを行わず、文書パスを読み取らず、文書を保存せず、テレメトリーも収集しません。呼び出し元が提供した値のみを処理します。AI アシスタントは、添付ファイルやツールデータをモデルプロバイダーに送信する場合があります。その場合、プロバイダーの料金とデータ規約が適用されます。公開ブラウザーデモはローカルで動作します。オプションのサイトイベントに文書データは含まれません。

有料サービスは有効になっていません。提案中の月額29ユーロのチームワークスペースは調査段階のみで、保存済み履歴、サプライヤーのマッピング、バッチ管理は利用できません。ベータ版の利用には LICENSE.txt が適用されます。依存関係のライセンスは THIRD-PARTY-NOTICES.txt に記載されています。

開発と検証

npm run build
npm test
npm run demo
npm run package

パッケージコマンドでは、テスト済みのビルド、フィクスチャ、ドキュメント、ソース、バージョンを固定した依存関係マニフェストを含む、明示的な許可リストをステージングします。リポジトリの内容、認証情報、node_modules、買い手の文書は除外されます。ダウンロードを SHA256SUMS と照合して検証してください。

プロトコルと小数の契約テストは、LLM、OCR、商用精度を測定するものではありません。含まれている場合は、独立した読み取り専用のプロトコルシナリオについて EVALUATION.md を参照してください。

v0.2 でのスプレッドシート入力

ヘッダーを含めて CSV またはタブ区切りのセルを貼り付けます。ブラウザーには5行とすべてのマッピングがプレビュー表示され、最大100行のデータがインポートされます。列は重複なく明示的にマッピングする必要があります。ファイル名と物理的な行ロケーターは保持されます。ヘッダーにある金額、通貨、サプライヤー、注文 ID はすべて必須です。ロケール固有の小数表記と数式は拒否されます。不明な料金がゼロで補完されることはありません。過去の履歴は不明として開始し、extraction_reviewed は false で開始します。照合する前に、元の文書と照らし合わせて確認してください。MCP は tradecheck_import_tables を介して同じテキストとゼロベースのマッピングを受け付けます。

リリースアーカイブでは、固定タイムスタンプと明示的なソース許可リストを使用します。リリース内容を変更する場合は、パッケージ／ダウンロードのバージョンを更新してください。監査レポートのスキーマはバージョン 0.1.0 のままです。パッケージバージョン 0.2.0 では、レポートのセマンティクスを変更せずに入力準備機能が追加されています。