AP Invoice Exception Review MCPB

Claude Desktopで使う、買掛請求書レビューのMCPBデモです。請求書、発注書、納品書/検収書のPDFをClaude OCRで読み取り、MCPB側の決定論的ルールで3-way match、取引先確認、重複確認、税額確認を行います。

This is a Claude Desktop MCPB demo for accounts payable invoice review. Claude reads the PDF forms with vision/OCR, then the MCPB applies deterministic AP rules and returns the payment decision, evidence, next actions, and draft-only payload summaries.

デモを使う人へ

最初に読む文書:

• 日本語デモ手順
• Validation / 検証手順

配布・インストールするファイル:

dist/ap-invoice-review.mcpb

このデモは架空データ専用です。freee、kintone、ERP、銀行、支払システムへの本書き込みは行いません。結果には必ず write_performed=false を含めます。

クイック確認

開発PCでMCPBを再生成し、リリース前検証をまとめて実行します。

make install
make validate-mcpb-release

make validate-mcpb-release には、lint、typecheck、全pytest、MCPB再生成、bundle内容検証、sidecar禁止、OCR smoke、E2E OCR flow、MCP smoke、公式MCPB manifest validationが含まれます。

Claude Desktopでの基本プロンプト

MCPBをClaude Desktopにインストールした後、新しいチャットで次のように依頼します。

AP Invoice Review MCPBを使って、デモワークスペースを作成し、case-a-pay-readyをレビューしてください。PDFをOCRして、判定・根拠・次アクション・write_performed=falseを日本語で返してください。

他のケース:

case-b-po-mismatchをレビューしてください
case-c-duplicateをレビューしてください
case-d-vendor-reviewをレビューしてください
case-e-grn-mismatchをレビューしてください
case-f-tax-reviewをレビューしてください

/ap-review case-a が使える環境では、それを使っても構いません。Claude Desktop/Coworkのバージョンによってslash command表示が異なる場合は、上の自然文プロンプトを使ってください。

デモケース

Case	Expected result	Meaning
case-a-pay-ready	PAY_READY_CANDIDATE	支払候補
case-b-po-mismatch	REFER_PO_MISMATCH	PO金額差異
case-c-duplicate	REFER_DUPLICATE_REVIEW	重複請求疑い
case-d-vendor-review	REFER_VENDOR_REVIEW	取引先マスタ確認
case-e-grn-mismatch	REFER_GRN_MISMATCH	検収数量不足
case-f-tax-review	REFER_TAX_REVIEW	税額確認

主要MCPツール

通常のデモでは、Claudeが以下の流れでツールを呼びます。

ap_invoice_setup_demo_workspace
ap_invoice_review_demo_case
Claude OCR
ap_invoice_submit_ocr_result
ap_invoice_review_from_ocr_result
ap_invoice_build_resolution_pack

フォルダを指定する場合は ap_invoice_prepare_ocr_run から始まります。

文書構成

利用者向け文書は docs/ 直下に置いています。長い実装仕様、過去のhandoff、作業メモは docs/archive/ に退避しています。MCPB成果物にはarchive文書を含めません。