Servidor MCP de BuchhaltungsButler

Un servidor Model Context Protocol (MCP) para la API de BuchhaltungsButler. Con él puedes utilizar BuchhaltungsButler directamente desde Claude Desktop, ChatGPT o cualquier otro cliente MCP.

Requisitos previos

• Node.js ≥ 18

• Acceso a la API de BuchhaltungsButler (API Client + API Secret + API Key de un cliente)

Related MCP server: MonKey Office MCP Server

Instalación

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

Configuración

Se necesitan las siguientes variables de entorno:

Opcional:

Uso en Claude Desktop

1. Abre la configuración de Claude Desktop:

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

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

2. Añade el servidor:

{
  "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. Reinicia Claude Desktop.

Uso en ChatGPT / otros clientes

Este servidor utiliza el transporte MCP-Stdio, que es compatible de forma nativa con Claude Desktop. Para ChatGPT u otros clientes se necesita un puente de cliente MCP (p. ej. mcp-proxy) para traducir Stdio a SSE/WebSocket:

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

Herramientas disponibles

• Recibos: list_receipts, get_receipt, create_receipt, upload_receipt, delete_receipt

• Transacciones: list_transactions, get_transaction, create_transaction, assign_receipt_to_transaction, unassign_receipt_from_transaction

• Facturas: create_invoice, create_invoice_draft

• Asientos: list_postings, create_free_posting

• Datos maestros: list_debtors, list_creditors, list_posting_accounts, create_debtor, create_creditor

• Otros: list_accounts, add_comment, list_cost_locations, create_cost_location

La documentación completa de la API se encuentra como api-spec.json en el proyecto y se puede contrastar con los docs oficiales de la API de BuchhaltungsButler.

Seguridad

• El API Client y el Secret son confidenciales. No los guardes en el repositorio, sino solo en la configuración de Claude Desktop o en variables de entorno.

• El .gitignore excluye node_modules/, dist/ y .env.

Desarrollo

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

Licencia

MIT