BuchhaltungsButler MCP サーバー

Model Context Protocol (MCP) サーバーで、BuchhaltungsButler API 用です。これにより、Claude Desktop、ChatGPT、またはその他の MCP クライアントから直接 BuchhaltungsButler を利用できます。

前提条件

• Node.js ≥ 18

• BuchhaltungsButler API アクセス（API クライアント + API シークレット + 顧客の API キー）

Related MCP server: MonKey Office MCP Server

インストール

git clone <repo-url>
cd buchhaltungsbutler-mcp
npm install
npm run build

設定

以下の環境変数が必要です:

任意:

Claude Desktop での使用方法

1. Claude Desktop の設定を開きます:

   • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

   • Windows: %APPDATA%\Claude\claude_desktop_config.json

2. サーバーを追加します:

{
  "mcpServers": {
    "buchhaltungsbutler": {
      "command": "node",
      "args": ["/absoluter/pfad/zu/buchhaltungsbutler-mcp/dist/index.js"],
      "env": {
        "BUCHHALTUNGSBUTLER_API_CLIENT": "dein-api-client",
        "BUCHHALTUNGSBUTLER_API_SECRET": "dein-api-secret",
        "BUCHHALTUNGSBUTLER_API_KEY": "kunden-api-key"
      }
    }
  }
}

3. Claude Desktop を再起動します。

ChatGPT / 他のクライアントでの使用方法

このサーバーは Claude Desktop がネイティブにサポートする MCP 標準入出力トランスポートを使用します。ChatGPT や他のクライアントでは、標準入出力を SSE/WebSocket に変換するために MCP クライアントブリッジ（例: mcp-proxy）が必要です:

npx mcp-proxy node /absoluter/pfad/zu/buchhaltungsbutler-mcp/dist/index.js

利用可能なツール

• 請求書: list_receipts, get_receipt, create_receipt, upload_receipt, delete_receipt

• 取引: list_transactions, get_transaction, create_transaction, assign_receipt_to_transaction, unassign_receipt_from_transaction

• 請求書: create_invoice, create_invoice_draft

• 転記: list_postings, create_free_posting

• マスターデータ: list_debtors, list_creditors, list_posting_accounts, create_debtor, create_creditor

• その他: list_accounts, add_comment, list_cost_locations, create_cost_location

完全な API ドキュメントは api-spec.json としてプロジェクトに含まれており、公式の BuchhaltungsButler API ドキュメント と照合できます。

セキュリティ

• API クライアントとシークレットは機密情報です。リポジトリには保存せず、Claude Desktop の設定または環境変数にのみ保存してください。

• .gitignore は node_modules/、dist/、.env を除外します。

開発

npm run dev     # TypeScript im Watch-Modus
npm run build   # Einmalig bauen
npm start       # Server starten

ライセンス

MIT