BuchPilot MCP – sevDesk & Lexoffice for n8n/AI

BuchPilot MCP サーバー

DACH 向けの会計 MCP サーバー — Claude、Cursor、または MCP 互換クライアントから、連絡先、請求書、領収書、見積書を直接管理できます。

概要

BuchPilot MCP は、会計システム（現在は Lexoffice）を AI アシスタントに接続する Model Context Protocol サーバーです。自然言語で請求書の作成、連絡先の管理、支払い遅延の確認ができます。Claude Desktop、Cursor、またはその他の MCP クライアントから直接利用できます。

機能

• 15 個のツールで会計業務を包括的に自動化
• 連絡先の作成、取得、一覧表示、更新
• 請求書の作成、取得、一覧表示、更新、PDF のダウンロード
• 領収書の作成、取得、一覧表示（仕入請求書、クレジットノート）
• 見積書の作成、取得
• 金額と支払期日超過日数を含む支払期日超過の請求書
• バックエンドアーキテクチャ — 現在は Lexoffice に対応。sevDesk、Billomat などにも拡張可能
• プラグイン対応 — E-Invoice MCP ツール（einvoice-mcp）を統合可能
• データベースも状態管理も不要 — 純粋な API プロキシ

インストール

前提条件

• Node.js >= 18
• API キーを持つ Lexoffice アカウント

npm（グローバル）

npm install -g buchpilot-mcp

ソースから

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

設定

以下のいずれかの場所に設定ファイル .buchpilot.json を作成します。

1. 環境変数 BUCHPILOT_CONFIG で指定したパス
2. ~/.buchpilot.json（ホームディレクトリ）
3. ./.buchpilot.json（現在のディレクトリ）

.buchpilot.json の内容

{
  "backends": {
    "lexoffice": {
      "api_key": "DEIN_LEXOFFICE_API_KEY"
    }
  },
  "default_backend": "lexoffice"
}

Lexoffice API キーの作成

1. Lexoffice Public API にアクセスします
2. API-Key erstellen をクリックします
3. キーをコピーして .buchpilot.json に貼り付けます

セキュリティに関する注意： API キーを Git に保存しないでください。.buchpilot.json を .gitignore に追加してください。

使い方

サーバーの起動（スタンドアロン）

# Nach npm install -g:
buchpilot-mcp

# Oder von Source:
npm start

# Entwicklung mit Auto-Reload:
npm run dev

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

Claude Desktop で使用する

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

概要 — claude_desktop_config.json に以下を追加します。

{
  "mcpServers": {
    "buchpilot": {
      "command": "npx",
      "args": ["-y", "buchpilot-mcp"],
      "env": {
        "BUCHPILOT_CONFIG": "/Users/DEIN_NAME/.buchpilot.json"
      }
    }
  }
}

使用例（Claude への自然言語での指示）

サーバーの設定後、たとえば次のように Claude に尋ねることができます。

• 「Beispiel GmbH の連絡先を、メールアドレス [email protected] で作成して」
• 「未払いの請求書をすべて表示して」
• 「連絡先 XYZ 宛てに、1 時間あたり 150 EUR のコンサルティング 10 時間分の請求書を作成して」
• 「支払期日を過ぎている請求書はどれ？」
• 「請求書 ABC の PDF をダウンロードして」
• 「月額 49 EUR のライセンス 5 件の見積書を作成して」

ツールリファレンス

パラメーター、入力例、出力例を含む 15 個すべてのツールの完全なリファレンスは、docs/tool-reference.md を参照してください。

概要

ツール	説明
create_contact	新しい連絡先を作成（個人または会社）
get_contact	ID で連絡先を取得
list_contacts	フィルターを指定して連絡先を一覧表示
update_contact	連絡先を更新
create_invoice	明細項目を含む新しい請求書を作成
get_invoice	ID で請求書を取得
list_invoices	請求書を一覧表示（ステータスでフィルター可能）
get_invoice_pdf	請求書を PDF としてダウンロード（Base64）
update_invoice	下書きの請求書を更新
create_voucher	新しい領収書を作成
get_voucher	ID で領収書を取得
list_vouchers	領収書を一覧表示
create_quotation	明細項目を含む新しい見積書を作成
get_quotation	ID で見積書を取得
get_overdue_invoices	分析情報付きで支払期日を過ぎた請求書を取得

E-Invoice 統合

BuchPilot MCP は、オプションで E-Invoice MCP パッケージを統合し、会計システムから XRechnung と ZUGFeRD を直接生成できます：

// In deinem eigenen MCP-Server:
import { registerEInvoiceTools } from "einvoice-mcp";
registerEInvoiceTools(server);
// Ergebnis: 15 + 4 = 19 Tools

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

「No .buchpilot.json found」

サーバーが設定ファイルを見つけられません。ホームディレクトリに .buchpilot.json を作成してください：

echo '{"backends":{"lexoffice":{"api_key":"DEIN_KEY"}},"default_backend":"lexoffice"}' > ~/.buchpilot.json

Lexoffice で「401 Unauthorized」が発生する

• API キーが .dachflow.json に正しく設定されていますか？
• キーはまだ有効ですか？Lexoffice Public API で確認してください。
• API キーには有効期限がある場合があります。必要に応じて新しいキーを作成してください。

「429 Too Many Requests」

Lexoffice では、1 秒あたり最大 2 件のリクエストが許可されています。多くの操作を連続して実行する場合は、リクエストの間隔を少し空けてください。

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

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

請求書を更新できない

更新できるのは、ステータスが draft（下書き）の請求書のみです。確定済みの請求書は変更できません。

バックエンド「sevDesk」が利用できない

現在、バックエンドとしてサポートされているのは Lexoffice のみです。sevDesk のサポートは予定されています。sevDesk には n8n ノード（n8n-nodes-buchpilot）を使用できます。

ライセンス

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

作者

MaKri — GitHub