BuchhaltungsButler MCP-сервер

Сервер Model Context Protocol (MCP) для BuchhaltungsButler API. С его помощью можно использовать BuchhaltungsButler прямо из Claude Desktop, ChatGPT или любого другого MCP-клиента.

Требования

• Node.js ≥ 18

• Доступ к BuchhaltungsButler API (API Client + API Secret + API Key клиента)

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 / других клиентах

Этот сервер использует MCP-транспорт Stdio, который нативно поддерживается Claude Desktop. Для ChatGPT или других клиентов требуется MCP-клиентский мост (например, mcp-proxy) для преобразования Stdio в SSE/WebSocket:

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 Docs.

Безопасность

• API Client и Secret являются конфиденциальными. Не храните их в репозитории, только в конфигурации Claude Desktop или в переменных окружения.

• Файл .gitignore исключает node_modules/, dist/ и .env.

Разработка

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

Лицензия

MIT