BuchhaltungsButler MCP 서버

BuchhaltungsButler API를 위한 Model Context Protocol (MCP) 서버입니다. 이를 통해 Claude Desktop, ChatGPT 또는 다른 MCP 클라이언트에서 직접 BuchhaltungsButler를 사용할 수 있습니다.

사전 요구 사항

• 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 / 기타 클라이언트에서 사용

이 서버는 Claude Desktop에서 기본적으로 지원되는 MCP-Stdio 전송을 사용합니다. ChatGPT 또는 다른 클라이언트의 경우, Stdio를 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 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