@treebeam/mcp

MCP (Model Context Protocol) Server für TreeBeam — eine Plattform für Finanzmanagement und Buchhaltung. Dieser Server ermöglicht es KI-Assistenten, über jeden MCP-kompatiblen Client mit Ihren TreeBeam-Organisationen und -Projekten zu interagieren.

Voraussetzungen

• Node.js 18 oder neuer — Wie man Node.js installiert

• Git (nur erforderlich bei Installation aus dem Quellcode) — Wie man Git installiert

• Claude Code (falls als KI-Assistent verwendet) — Wie man Claude Code installiert

• Ein TreeBeam-Konto — registrieren Sie sich unter treebeam.com

Neu bei diesen Tools? Jeder der obigen Links enthält eine leicht verständliche Anleitung, die Sie Schritt für Schritt durch die Installation führt.

Related MCP server: freee Accounting MCP Server

Installation

npm (empfohlen)

npm install -g @treebeam/mcp

Aus dem Quellcode

git clone https://github.com/treebeam-code/tb-mcpserver.git
cd tb-mcpserver
npm install

Authentifizierung

Der Server verwendet den OAuth 2.0 Device Flow zur Authentifizierung. Token werden sicher im Schlüsselbund Ihres Betriebssystems gespeichert (macOS Keychain, Windows Credential Vault oder Linux Secret Service). Sobald die Authentifizierung erfolgt ist, werden die Token zwischengespeichert und automatisch aktualisiert.

In Ihrem KI-Assistenten (empfohlen)

Der einfachste Weg zur Authentifizierung ist direkt innerhalb Ihrer KI-Konversation. Bitten Sie den Assistenten einfach, sich bei TreeBeam anzumelden — er verwendet das Tool treebeam_login, um den Device Flow zu starten, stellt Ihnen einen Link zur Verfügung und erledigt den Rest automatisch. Es sind keine Terminalbefehle erforderlich.

Sie können den Assistenten auch jederzeit bitten, Ihren Authentifizierungsstatus zu überprüfen oder sich abzumelden, indem Sie die Tools treebeam_auth_status und treebeam_logout verwenden.

Befehlszeile (Alternative)

Wenn Sie sich lieber außerhalb Ihres KI-Clients authentifizieren möchten, können Sie die CLI direkt verwenden:

treebeam-mcp login       # Opens browser to complete sign-in
treebeam-mcp status      # Check current auth status
treebeam-mcp logout      # Remove stored credentials

Wenn Sie aus dem Quellcode ausführen, ersetzen Sie treebeam-mcp in den obigen Befehlen durch npm run.

Client-Konfiguration

Fügen Sie den TreeBeam MCP-Server zur Konfigurationsdatei Ihres Clients hinzu. Die JSON-Struktur ist über alle Clients hinweg identisch — nur der Speicherort der Datei unterscheidet sich.

Speicherorte der Konfigurationsdatei:

Bei globaler Installation via npm:

{
  "mcpServers": {
    "treebeam": {
      "command": "treebeam-mcp"
    }
  }
}

Bei Ausführung aus dem Quellcode:

{
  "mcpServers": {
    "treebeam": {
      "command": "node",
      "args": ["/absolute/path/to/tb-mcpserver/src/index.js"]
    }
  }
}

Andere MCP-Clients

Jeder MCP-kompatible Client kann diesen Server verwenden. Konfigurieren Sie ihn als stdio-Transport — der Client startet den Prozess und kommuniziert über stdin/stdout.

Verfügbare Tools

Sobald die Verbindung hergestellt ist, stehen Ihrem KI-Assistenten die folgenden Tools zur Verfügung. Hier sind einige Highlights:

Der Server bietet insgesamt 47 Tools, die vollständige CRUD-Operationen für Entitäten, Konten, Kontengruppen, Perioden, unbereinigte Salden, Anpassungen, Anpassungspositionen und Entitätsbeziehungssätze abdecken. Jede Ressource unterstützt search_*, get_*, create_*, update_* und delete_* Operationen. Siehe src/tool.js für die vollständige Liste.

Die Authentifizierung erfolgt automatisch — falls Ihr Token während einer Sitzung abläuft, initiiert der Server eine erneute Authentifizierung via Device Flow.

Fehlerbehebung

"Not authenticated"-Fehler

Führen Sie treebeam-mcp login (oder npm run login aus dem Quellcode) aus, um sich erneut zu authentifizieren. Wenn das Problem weiterhin besteht, führen Sie zuerst treebeam-mcp logout aus, um veraltete Anmeldedaten zu löschen, und melden Sie sich dann erneut an.

Probleme mit dem Schlüsselbund-Zugriff

Der Server verwendet keytar für die Speicherung im OS-Schlüsselbund. Stellen Sie unter Linux sicher, dass libsecret installiert ist:

# Debian/Ubuntu
sudo apt install libsecret-1-dev

# Fedora
sudo dnf install libsecret-devel

Node.js-Version

Überprüfen Sie, ob Sie Node.js 18+ ausführen:

node --version

Lizenz

Apache License 2.0 — Copyright 2026 TNS Solutions, Inc.