EInvoice MCP – XRechnung & ZUGFeRD for DACH

E-Invoice MCP サーバー

DACH地域向けのE-Rechnung用MCPサーバー — XRechnungの作成、検証、データ抽出に対応します。Claude、Cursor、その他のMCPクライアントから直接利用できます。

これは何ですか？

E-Invoice MCPは、ドイツのXRechnung標準に準拠したE-Rechnungの作成と検証を行うModel Context Protocolサーバーです。2027年から、ドイツのすべての企業はE-Rechnungを送信できる必要があります。このツールを使えば、準備を整えられます。

Claudeに「Beispiel GmbH宛てに、10時間分のコンサルティングの請求書を作成して」と伝えるだけで、有効なXRechnungをUBL 2.1 XML形式で受け取れます。

機能

• XRechnungの作成 — 構造化データから有効なUBL 2.1 XMLを作成します（EN 16931 + XRechnung 3.0.2）
• E-Rechnungの検証 — 構文、必須項目、ドイツのビジネスルール（BR-DE）を確認します
• データの抽出 — UBLまたはCIIのXMLから構造化データを読み取ります
• フォーマット情報 — 必須項目、税区分、単位コード、期限のリファレンスです
• 自動計算 — 税抜金額、税込金額、税額を自動計算します
• プラグイン対応 — 単独で実行することも、BuchPilot MCPサーバーに統合することもできます
• 外部サービス不要 — すべてローカルで動作し、APIキーは必要ありません
• ネイティブ依存関係なし — Node.jsを搭載したあらゆるシステムで動作します

法定期限

日付	内容
01.01.2025	すべての企業がE-Rechnungを受信できる必要があります
31.12.2026	PDF請求書は、受取人の同意がある場合のみ許可されます
01.01.2027	売上高が800,000 EURを超える企業は、E-Rechnungを送信する必要があります
01.01.2028	すべての企業がE-Rechnungを送信する必要があります

不備のあるE-Rechnungは、仕入税額控除の喪失（さらに6%の利息）につながる可能性があります。

インストール

前提条件

• Node.js >= 18

npm（グローバル）

npm install -g einvoice-mcp

ソースからインストール

git clone https://github.com/makririch/einvoice-mcp.git
cd einvoice-mcp
npm install
npm run build

設定

このMCPサーバーには設定は不要です。APIキーや外部サービスは必要なく、すべてローカルで動作します。

使い方

サーバーを起動（単独実行）

# Nach npm install -g:
einvoice-mcp

# Oder von Source:
npm start

# Entwicklung mit Auto-Reload:
npm run dev

サーバーはstdio経由で動作し、MCPメッセージを待ち受けます。

Claude Desktopで使用する

詳しい手順については、Claude Desktopセットアップガイドを参照してください。

簡単な手順 — claude_desktop_config.jsonに追加します。

{
  "mcpServers": {
    "einvoice": {
      "command": "npx",
      "args": ["-y", "einvoice-mcp"]
    }
  }
}

Claudeへの自然言語での指示例

サーバーを設定したら、たとえば次のようにClaudeに尋ねられます。

• 「Beispiel GmbH宛てに、1時間あたり150 EURで10時間分のコンサルティングのXRechnungを作成して」
• 「このXMLファイルは有効なXRechnungですか？」
• 「このXMLから請求書データを抽出して」
• 「XRechnungに必要な必須項目を教えて」
• 「税区分にはどのようなものがあり、それぞれどのような意味ですか？」
• 「私の会社はいつまでにE-Rechnungを送信できるようにする必要がありますか？」

クイックスタート

「5分で初めてのXRechnungを作成する」ための手順ガイドは、docs/quickstart.mdにあります。

ツールリファレンス

4つのツールすべてのパラメーター、入力例、出力例を含む完全なリファレンスは、docs/tool-reference.mdにあります。

概要

ツール	説明
create_xrechnung	構造化データからXRechnung（UBL 2.1 XML）を作成します
validate_invoice	E-RechnungのXMLを検証します（構文 + BR-DEビジネスルール）
extract_data	UBLまたはCIIのXMLから構造化データを抽出します
get_format_info	フォーマット、必須項目、コード、期限のリファレンスです

BuchPilotとの統合

E-Invoice MCPは、BuchPilot MCP Serverのプラグインとして統合できます。

import { registerEInvoiceTools } from "einvoice-mcp";
registerEInvoiceTools(server);

組み合わせ: BuchPilotでLexofficeの請求書を作成 -> データを抽出 -> XRechnungを生成 -> E-Rechnungの完成

サポート対象の規格

規格	バージョン	ステータス
XRechnung	3.0.2	作成 + 検証
EN 16931	—	XRechnungの基礎
UBL 2.1	—	XRechnungのXML構文
CII (Cross Industry Invoice)	—	抽出（読み取り）
ZUGFeRD / Factur-X	2.3	抽出（読み取り）、作成予定

FAQ / トラブルシューティング

「XMLを解析できませんでした」

• XMLの整形式は正しいですか？（すべてのタグが正しく閉じられていますか？）
• 実際にUBLまたはCIIの請求書ですか？（ルート要素は<Invoice>または<CrossIndustryInvoice>である必要があります）
• エンコーディングはUTF-8ですか？

検証で「BR-DE-13: Buyer Referenceは必須です」というエラーが表示される

購入者参照（BT-10）はXRechnungで必須です。公的機関宛ての請求書では、これはLeitweg-IDです。B2B請求書では任意の参照（注文番号など）を指定できます。

{
  "buyerReference": "04011000-12345-67"
}

検証で「BR-DE-21: 電話番号が推奨されます」という警告が表示される

これは警告であり、エラーではありません。請求書は引き続き有効です。ただし、互換性を最大限に高めるため、販売者の電話番号を指定することをおすすめします。

税区分にはどのようなものがありますか？

コード	名前	説明	税率
S	標準	通常の税率	19%、7%
Z	ゼロ税率	0%（例：VAT免税の域内取引）	0%
E	非課税	例：UStG第19条に基づく小規模事業者	0%
AE	リバースチャージ	受領者の納税義務（UStG第13b条）	0%
K	域内取引	免税の域内供給	0%

単位コードにはどのようなものがありますか？

コード	名前	説明
H87	個	個々の単位（デフォルト）
HUR	時間	労働時間
DAY	日	労働日
MON	月	暦月
KGM	キログラム	重量
MTR	メートル	長さ
LTR	リットル	体積
MTK	平方メートル	面積
SET	セット／パッケージ	ひとまとめにしたもの
C62	単位（汎用）	一般的な数量単位

サーバーは起動するが、Claudeがツールを認識しない

• claude_desktop_config.jsonが正しいことを確認してください
• 設定変更後にClaude Desktopを再起動してください
• ログを確認してください：~/Library/Logs/Claude/mcp.log（macOS）

ライセンス

MIT — 商用利用も含め、自由に利用できます。

作者

MaKri — GitHub