billing-docs

mcp-billing-docs

請求書と同じエンジンで、クレジットノートと発注書を作成します。

クライアントから作業を差し戻された場合や、二重請求をした場合は、クレジットノートを発行する必要があります。これは、取り消す請求書を明記し、請求時と同じ税率でVATを取り消して、請求額を差し引く書類です。サプライヤーに発注する場合は、何を、いくらで、いつまでに納品してほしいかを記載し、自社の詳細情報を載せた発注書が必要です。このサーバーは、mcp-invoice サーバーがすでに保持している請求書とクライアントを参照して、どちらの書類も作成します。また、クレジットノートで請求額を超える金額を返金することはできません。同じ書類を二度送信しようとすると、すでに存在する書類のIDが返され、処理は拒否されます。何にも紐付いていない書類は削除できるため、再送しても無料枠を消費しません。データはすべてお使いのマシンに保存されます。

@theluckystrike/mcp-invoice/lib を基盤として構築されています。金額、VAT、通貨、書式設定のコードは請求書サーバーのものを使い、二重に実装していないため、クレジットノートと取り消し対象の請求書は最小通貨単位まで一致します。

公式 MCP Registry に登録されています（io.github.theluckystrike/billing-docs-credit-notes-purchase-orders）。

@theluckystrike/mcp-billing-docs の npm 公開は保留中のため、現在 npx -y @theluckystrike/mcp-billing-docs を実行すると 404 が返されます。それまでは、.mcpb のワンクリックバンドル、またはリポジトリをクローンしてビルドする方法をご利用ください。

インストール

Claude Desktop（claude_desktop_config.json）：

{
  "mcpServers": {
    "billing-docs": {
      "command": "npx",
      "args": ["-y", "@theluckystrike/mcp-billing-docs"]
    }
  }
}

Claude Code：

claude mcp add billing-docs -- npx -y @theluckystrike/mcp-billing-docs

Cursor（.cursor/mcp.json）：

{
  "mcpServers": {
    "billing-docs": {
      "command": "npx",
      "args": ["-y", "@theluckystrike/mcp-billing-docs"]
    }
  }
}

このサーバーと併せて mcp-invoice を実行してください。このサーバーは、mcp-invoice サーバーの請求書とクライアントを読み取ります。また、両サーバーとも、会社名、住所、VAT ID、既定の通貨を共通の会社プロフィールから取得します。

ツール

ツール	内容
credit_note_create	請求書へのクレジットを作成します。全額、総額の指定、または数量を指定した項目単位に対応します
credit_note_list	すべてのクレジットノートを、通貨ごとのクレジット合計とともに表示します。請求書、クライアント、日付で絞り込めます
credit_note_get	1件のクレジットノートの全情報を取得します
credit_note_pdf	A4 PDFを作成します。タイトルは CREDIT NOTE で、取り消す請求書の番号を記載します（Pro）
credit_note_text	メールに貼り付けられるプレーンテキスト版を作成します
credit_note_delete	請求書に転記されておらず、レンダリングもされていないものを削除します。無料の月間枠が戻ります
purchase_order_create	発注書を作成します。項目、VAT、通貨、納品予定日を指定できます
purchase_order_list	状態（未完了、一部受領済み、受領済み）とともに、すべての発注書を表示します
purchase_order_get	受領記録を含む、1件の発注書の全情報を取得します
purchase_order_pdf	A4 PDFを作成します。タイトルは PURCHASE ORDER です（Pro）
purchase_order_text	サプライヤーに送るプレーンテキスト版を作成します
purchase_order_receive	発注書を全量または一部受領済みとして記録します
purchase_order_delete	受領記録もレンダリングもないものを削除します。無料の月間枠が戻ります
billing_docs_report	通貨ごとのクレジット額、通貨ごとの発注額、納期を過ぎた配送を表示します（Pro）
license_status、license_activate	Free または Pro のライセンス状態と、アップグレード方法を確認します

リソースは billing-docs://open-orders の1つ、プロンプトは chase_deliveries の1つです。

Free と Pro

	Free	Pro
1暦月あたりの書類数	5件。クレジットノートと発注書の合計	無制限
credit_note_delete、purchase_order_delete	はい：上限はストア内の件数でカウントされるため、削除すると枠が戻ります	はい
credit_note_text、purchase_order_text	はい、無制限	はい
全額・一部・明細ごとのクレジットノート、VAT、複数通貨、受領注文	はい	はい
credit_note_pdf、purchase_order_pdf	いいえ	はい。ロゴを追加でき、フッターのクレジット表示もありません
billing_docs_report	いいえ	はい

Pro を入手：https://mcp.zovo.one/buy/billing-docs（このサーバー単体は19ドルの一回払い、バンドルは39ドルです）。

数字で見る例

混合税率の請求書の一部を単一税率でクレジットすると、想定される端数処理の差を大きく上回る誤差が生じます。 コンサルティング料1,000.00ユーロ（税率23％）と印刷費500.00ユーロ（税率8％）の請求書は、合計1,770.00ユーロです。単一税率のクレジットノートと同じ方法で、その10％にあたる177.00ユーロをクレジットすると、税抜額は143.90ユーロ、VATは33.10ユーロになります。このサーバーは、請求書で実際に使われた税率ごとの合計額に応じてクレジット額を配分するため、税抜額は150.00ユーロ、VATは税率23％で23.00ユーロ、税率8％で4.00ユーロ、合計27.00ユーロになります。クライアントに表示される税込額はどちらの場合も同じです。VATの明細額には6.10ユーロの差が生じ、これはその額の22.6％にあたり、VAT申告書に記載される数値です。

test/unit.test.mjs で検証済み：「金額指定のクレジットノートでは、請求書のVAT税率ごとに税込額を配分し、各税率を再利用する」

プライバシー

すべてのデータはローカルに保存されます：${XDG_DATA_HOME:-~/.local/share}/mcp-servers/billing-docs/。アカウントもAPIキーもネットワーク通信も一切ありません。ライセンスキーはオフラインで検証されます。

theluckystrike が開発しました。サポート：[email protected]

MCP サーバーとしてこれらのドキュメントを使用する

GitMCP を使えば、どの MCP クライアント（Claude、Cursor、Windsurf、VS Code）からでも、このリポジトリのドキュメントをインストールなしで直接読み取れます：

• ドキュメント MCP URL：https://gitmcp.io/theluckystrike/mcp-billing-docs