Prototyp · Vorschau: alle Server aus der offiziellen Registry, alle 30 Minuten synchronisiert. Mit Google anmelden, um Bewertungen zu schreiben.Prototyp · alle 30 Min. aktualisiert
PopNx MCPMCP-Server für alle, die KI nutzen · in einfachen Worten erklärt

BuchhaltungsButler

von ohnebenVersion 1.1.5i★ 8iLäuft auf deinem ComputerRepository ↗
Name in der Registryio.github.ohneben/buchhaltungsbutler-mcp

So installierst du es

What it does

BuchhaltungsButler API v1: alle 54 Endpunkte als 46 sicherheitskategorisierte MCP-Tools

  • Connects Läuft auf deinem Computer
  • Account or key Needs BB_API_CLIENT, BB_API_SECRET, BB_API_KEY · 1 setting to fill in (MCP_TRANSPORT)
  • Category Sonstiges

Warum es hier steht

Listen sind nach einem Nutzungswert (von 100) aus diesen Teilen sortiert

Beliebtheit11/80GitHub-Sterne oder wöchentliche Downloads: der größere Wert zählt 60, der kleinere 20
Aktualität12/12Volle Punkte für Release oder Codeänderung in 30 Tagen
Antwortet noch0/8Der Cloud-Endpoint antwortete bei der letzten Prüfung
Nutzungswert23/100

Qualität: 3/3 Basisprüfungen bestanden (angezeigt, nicht zur Sortierung) · Schwung: Noch keine Daten (Nur im Tab Im Trend verwendet)

Installation

Wähle die KI-App, die du nutzt, und kopiere die Einstellungen.

Mit einem Satz von deiner KI installieren lassen

Installiere bitte BuchhaltungsButler. Folge https://mcp.popnx.com/i/ohneben-buchhaltungsbutler-mcp.md, zeig mir die Befehle und warte auf mein OK, bevor du sie ausführst.

Füge ihn in eine KI ein, die auf deinem Rechner arbeitet (z. B. Claude Code oder Cursor). Sie liest unsere Schritte, zeigt dir die Befehle und wartet auf dein OK. Kein Schlüssel, keine Anmeldung. · Vollständigen Text ansehen

3/3 Prüfungen bestanden · Läuft auf deinem Computer · ✓ Befehle geprüft am 14. Nov. 2026

Zuerst: Welche KI nutzt du?

Wähle deine App, dann erscheinen die Schritte unten.

Klappt mit Claude, aber erst etwas vorbereiten

Du brauchst einen Schlüssel von BuchhaltungsButler (auf der Seite des Anbieters erstellen) · 1 Einstellung(en) auszufüllen (MCP_TRANSPORT) · Installiere zuerst Docker auf deinem Computer (nur einmal) · Nur in der Claude-App für den Computer (Windows oder Mac), nicht im Web oder auf dem Handy

Von der KI installieren lassen

Kopiere diese Nachricht in einen Claude-Chat. Die KI prüft deinen Rechner, sagt dir, welche Datei sie ändert, und wartet jedes Mal auf dein OK.

Installiere bitte den MCP server BuchhaltungsButler für Claude auf diesem Rechner, in dieser Reihenfolge: 1) Prüfe Docker mit docker --version. Fehlt es, sag mir, dass ich es von https://www.docker.com/products/docker-desktop/ installiere; installiere es nicht selbst. 2) Verwende nur diese Konfiguration (von PopNx MCP geprüft): { "mcpServers": { "buchhaltungsbutler": { "command": "docker", "args": [ "run", "-i", "--rm", "-e", "MCP_TRANSPORT", "-e", "BB_API_CLIENT", "-e", "BB_API_SECRET", "-e", "BB_API_KEY", "ghcr.io/ohneben/buchhaltungsbutler-mcp:1.1.5" ], "env": { "MCP_TRANSPORT": "stdio", "BB_API_CLIENT": "your-value", "BB_API_SECRET": "your-value", "BB_API_KEY": "your-value" } } } } 3) Nenne mir den vollständigen Pfad der Datei, die du änderst, oder den Befehl, den du ausführst, und warte auf mein OK. 4) Lass bei BB_API_CLIENT, BB_API_SECRET, BB_API_KEY, MCP_TRANSPORT "your-value" stehen und sag mir, dass ich den echten Wert selbst in die Datei oder das Feld der App einfüge. Bitte mich nie, einen Schlüssel in den Chat zu schreiben. 5) Führe das Vereinbarte aus und prüfe, dass die Tools von BuchhaltungsButler wirklich erscheinen.

Diese Nachricht enthält keinen Schlüssel. Wird einer gebraucht, bittet dich die KI, ihn selbst in die Datei oder das Feld der App einzufügen.

  1. Docker installieren (falls noch nicht vorhanden)

    Schon installiert? Zuerst prüfen · Öffne das Terminal, gib diesen Befehl ein und drücke Enter

    docker --version
    • Eine Versionsnummer wie Docker version … = installiert, diesen Schritt überspringen
    • "command not found" (unter Windows "is not recognized") = noch nicht installiert, oder gerade installiert und das Terminal muss neu geöffnet werden
    So öffnest du das Terminal

    Mac: ⌘ + Leertaste drücken, Terminal eingeben, Enter

    Windows: Start öffnen, Windows PowerShell eingeben, dann Öffnen

    Noch nicht installiert: Docker Desktop installieren: auf dem Mac Docker.dmg öffnen und das Symbol in „Programme“ ziehen (Apple silicon oder Intel passend zum Mac wählen) · unter Windows Docker Desktop Installer.exe doppelklicken · danach die App Docker Desktop öffnen und laufen lassen. Kein curl-Befehl nötig

    Download-Seite von Docker öffnen ↗

    Danach das Terminal schließen, neu öffnen und denselben Befehl erneut ausführen. Es muss eine Versionsnummer erscheinen: docker --version

    Einmal installieren, gilt für alles, was Docker braucht

  2. Bei BuchhaltungsButler registrieren und Schlüssel erstellen

    Öffne die Seite des Anbieters, registriere dich und erstelle einen API-Schlüssel für den nächsten Schritt. Preise und Gratis-Tarife siehst du auf seiner Seite.

    Seite von BuchhaltungsButler öffnen ↗

  3. 1 Einstellung(en) ausfüllen

    Das sind Programmeinstellungen, keine Schlüssel. Keine Registrierung nötig; wie vom Autor beschrieben ausfüllen.

    • MCP_TRANSPORT Transport des Servers. Für lokale MCP-Clients auf 'stdio' setzen; das Image startet sonst den HTTP-Transport.
      Englisches Original anzeigenTransport des Servers. Fuer lokale MCP-Clients auf 'stdio' setzen; das Image startet sonst den HTTP-Transport.
      · Standard stdio

    Beschreibungen automatisch übersetzt; Variablennamen bleiben wie im Original. Im Zweifel das Original ansehen.

  4. Einstellungsdatei der Claude-Desktop-App öffnen

    SettingsDeveloperEdit Config

  5. Diese Einstellungen einfügen und speichern

    {
      "mcpServers": {
        "buchhaltungsbutler": {
          "command": "docker",
          "args": [
            "run",
            "-i",
            "--rm",
            "-e",
            "MCP_TRANSPORT",
            "-e",
            "BB_API_CLIENT",
            "-e",
            "BB_API_SECRET",
            "-e",
            "BB_API_KEY",
            "ghcr.io/ohneben/buchhaltungsbutler-mcp:1.1.5"
          ],
          "env": {
            "MCP_TRANSPORT": "stdio",
            "BB_API_CLIENT": "your-value",
            "BB_API_SECRET": "your-value",
            "BB_API_KEY": "your-value"
          }
        }
      }
    }

    Füge den Schlüssel nur in das Feld der App ein, nie in einen Chat und schick ihn niemandem

  6. Claude beenden und neu öffnen

  7. Ausprobieren

    Nutze BuchhaltungsButler und sag mir, was du für mich tun kannst; zeig mir dann eine Sache

    ✓ Wenn Claude sagt, dass es BuchhaltungsButler nutzt, oder ein Werkzeug von BuchhaltungsButler in der Antwort zeigt, bist du verbunden

2 optionale Einstellung(en) (geht auch ohne)

Der Befehl oben funktioniert auch ohne diese Werte. Füge sie nur hinzu, wenn du etwas ändern willst, nach der Beschreibung des Autors.

  • BB_RATE_LIMIT Clientseitiges Limit für Anfragen pro Minute. BuchhaltungsButler erlaubt 100 pro Kunde und Minute
    Englisches Original anzeigenClientseitiges Limit an Anfragen pro Minute. BuchhaltungsButler erlaubt 100 pro Kunde und Minute.
    · Standard 90
  • BB_BASE_URL Überschreibt die API-Basis-URL. Standard ist der Wert aus der mitgelieferten Spec.
    Englisches Original anzeigenUeberschreibt die API-Basis-URL. Standard ist der Wert aus der mitgelieferten Spec.

Beschreibungen automatisch übersetzt; Variablennamen bleiben wie im Original. Im Zweifel das Original ansehen.

Menünamen am 11. Nov. 2026 mit der Hilfe von Anthropic abgeglichen · dein Bildschirm kann je nach App-Version leicht abweichen

ChatGPT kann BuchhaltungsButler noch nicht verbinden

BuchhaltungsButler läuft auf deinem Computer, aber ChatGPT verbindet nur Server, die im Web laufen

Das kannst du stattdessen tun

A · Eine App nutzen, die BuchhaltungsButler verbinden kann

  • Du brauchst einen Schlüssel von BuchhaltungsButler (auf der Seite des Anbieters erstellen) · 1 Einstellung(en) auszufüllen (MCP_TRANSPORT) · Installiere zuerst Docker auf deinem Computer (nur einmal) · Nur in der Claude-App für den Computer (Windows oder Mac), nicht im Web oder auf dem Handy
  • Du brauchst einen Schlüssel von BuchhaltungsButler (auf der Seite des Anbieters erstellen) · 1 Einstellung(en) auszufüllen (MCP_TRANSPORT) · Installiere zuerst Docker auf deinem Computer (nur einmal)
  • Du brauchst einen Schlüssel von BuchhaltungsButler (auf der Seite des Anbieters erstellen) · 1 Einstellung(en) auszufüllen (MCP_TRANSPORT) · Installiere zuerst Docker auf deinem Computer (nur einmal)
  • Du brauchst einen Schlüssel von BuchhaltungsButler (auf der Seite des Anbieters erstellen) · 1 Einstellung(en) auszufüllen (MCP_TRANSPORT) · Installiere zuerst Docker auf deinem Computer (nur einmal)

B · Andere in Sonstiges, die mit ChatGPT funktionieren

Aus den meistgenutzten derselben Kategorie, nur solche, die per Adresse ohne Schlüssel verbinden

Klappt mit Claude Code, aber erst etwas vorbereiten

Du brauchst einen Schlüssel von BuchhaltungsButler (auf der Seite des Anbieters erstellen) · 1 Einstellung(en) auszufüllen (MCP_TRANSPORT) · Installiere zuerst Docker auf deinem Computer (nur einmal)

Von der KI installieren lassen

Kopiere diese Nachricht in einen Claude Code-Chat. Die KI prüft deinen Rechner, sagt dir, welche Datei sie ändert, und wartet jedes Mal auf dein OK.

Installiere bitte den MCP server BuchhaltungsButler für Claude Code auf diesem Rechner, in dieser Reihenfolge: 1) Prüfe Docker mit docker --version. Fehlt es, sag mir, dass ich es von https://www.docker.com/products/docker-desktop/ installiere; installiere es nicht selbst. 2) Verwende nur diese Konfiguration (von PopNx MCP geprüft): claude mcp add --scope user buchhaltungsbutler --env MCP_TRANSPORT=stdio --env BB_API_CLIENT=your-value --env BB_API_SECRET=your-value --env BB_API_KEY=your-value -- docker run -i --rm -e MCP_TRANSPORT -e BB_API_CLIENT -e BB_API_SECRET -e BB_API_KEY ghcr.io/ohneben/buchhaltungsbutler-mcp:1.1.5 3) Nenne mir den vollständigen Pfad der Datei, die du änderst, oder den Befehl, den du ausführst, und warte auf mein OK. 4) Lass bei BB_API_CLIENT, BB_API_SECRET, BB_API_KEY, MCP_TRANSPORT "your-value" stehen und sag mir, dass ich den echten Wert selbst in die Datei oder das Feld der App einfüge. Bitte mich nie, einen Schlüssel in den Chat zu schreiben. 5) Führe das Vereinbarte aus und prüfe, dass die Tools von BuchhaltungsButler wirklich erscheinen.

Diese Nachricht enthält keinen Schlüssel. Wird einer gebraucht, bittet dich die KI, ihn selbst in die Datei oder das Feld der App einzufügen.

  1. Docker installieren (falls noch nicht vorhanden)

    Schon installiert? Zuerst prüfen · Öffne das Terminal, gib diesen Befehl ein und drücke Enter

    docker --version
    • Eine Versionsnummer wie Docker version … = installiert, diesen Schritt überspringen
    • "command not found" (unter Windows "is not recognized") = noch nicht installiert, oder gerade installiert und das Terminal muss neu geöffnet werden
    So öffnest du das Terminal

    Mac: ⌘ + Leertaste drücken, Terminal eingeben, Enter

    Windows: Start öffnen, Windows PowerShell eingeben, dann Öffnen

    Noch nicht installiert: Docker Desktop installieren: auf dem Mac Docker.dmg öffnen und das Symbol in „Programme“ ziehen (Apple silicon oder Intel passend zum Mac wählen) · unter Windows Docker Desktop Installer.exe doppelklicken · danach die App Docker Desktop öffnen und laufen lassen. Kein curl-Befehl nötig

    Download-Seite von Docker öffnen ↗

    Danach das Terminal schließen, neu öffnen und denselben Befehl erneut ausführen. Es muss eine Versionsnummer erscheinen: docker --version

    Einmal installieren, gilt für alles, was Docker braucht

  2. Bei BuchhaltungsButler registrieren und Schlüssel erstellen

    Öffne die Seite des Anbieters, registriere dich und erstelle einen API-Schlüssel für den nächsten Schritt. Preise und Gratis-Tarife siehst du auf seiner Seite.

    Seite von BuchhaltungsButler öffnen ↗

  3. 1 Einstellung(en) ausfüllen

    Das sind Programmeinstellungen, keine Schlüssel. Keine Registrierung nötig; wie vom Autor beschrieben ausfüllen.

    • MCP_TRANSPORT Transport des Servers. Für lokale MCP-Clients auf 'stdio' setzen; das Image startet sonst den HTTP-Transport.
      Englisches Original anzeigenTransport des Servers. Fuer lokale MCP-Clients auf 'stdio' setzen; das Image startet sonst den HTTP-Transport.
      · Standard stdio

    Beschreibungen automatisch übersetzt; Variablennamen bleiben wie im Original. Im Zweifel das Original ansehen.

  4. Terminal öffnen

    Mac: Command+Leertaste drücken und Terminal tippen · Windows: PowerShell öffnen

  5. Diesen Befehl einfügen und Enter drücken

    claude mcp add --scope user buchhaltungsbutler --env MCP_TRANSPORT=stdio --env BB_API_CLIENT=your-value --env BB_API_SECRET=your-value --env BB_API_KEY=your-value -- docker run -i --rm -e MCP_TRANSPORT -e BB_API_CLIENT -e BB_API_SECRET -e BB_API_KEY ghcr.io/ohneben/buchhaltungsbutler-mcp:1.1.5

    Ersetze „your-value“ vor dem Enter durch deinen Schlüssel

    Füge den Schlüssel nur in das Feld der App ein, nie in einen Chat und schick ihn niemandem

  6. /mcp in Claude Code eingeben

    BuchhaltungsButler sollte in der Liste als verbunden erscheinen

  7. Ausprobieren

    Nutze BuchhaltungsButler und sag mir, was du für mich tun kannst; zeig mir dann eine Sache

    ✓ Wenn Claude Code sagt, dass es BuchhaltungsButler nutzt, oder ein Werkzeug von BuchhaltungsButler in der Antwort zeigt, bist du verbunden

2 optionale Einstellung(en) (geht auch ohne)

Der Befehl oben funktioniert auch ohne diese Werte. Füge sie nur hinzu, wenn du etwas ändern willst, nach der Beschreibung des Autors.

  • BB_RATE_LIMIT Clientseitiges Limit für Anfragen pro Minute. BuchhaltungsButler erlaubt 100 pro Kunde und Minute
    Englisches Original anzeigenClientseitiges Limit an Anfragen pro Minute. BuchhaltungsButler erlaubt 100 pro Kunde und Minute.
    · Standard 90
  • BB_BASE_URL Überschreibt die API-Basis-URL. Standard ist der Wert aus der mitgelieferten Spec.
    Englisches Original anzeigenUeberschreibt die API-Basis-URL. Standard ist der Wert aus der mitgelieferten Spec.

Beschreibungen automatisch übersetzt; Variablennamen bleiben wie im Original. Im Zweifel das Original ansehen.

Menünamen am 11. Nov. 2026 mit der Hilfe von Anthropic abgeglichen · dein Bildschirm kann je nach App-Version leicht abweichen

Klappt mit Cursor, aber erst etwas vorbereiten

Du brauchst einen Schlüssel von BuchhaltungsButler (auf der Seite des Anbieters erstellen) · 1 Einstellung(en) auszufüllen (MCP_TRANSPORT) · Installiere zuerst Docker auf deinem Computer (nur einmal)

Von der KI installieren lassen

Kopiere diese Nachricht in einen Cursor-Chat. Die KI prüft deinen Rechner, sagt dir, welche Datei sie ändert, und wartet jedes Mal auf dein OK.

Installiere bitte den MCP server BuchhaltungsButler für Cursor auf diesem Rechner, in dieser Reihenfolge: 1) Prüfe Docker mit docker --version. Fehlt es, sag mir, dass ich es von https://www.docker.com/products/docker-desktop/ installiere; installiere es nicht selbst. 2) Verwende nur diese Konfiguration (von PopNx MCP geprüft): { "mcpServers": { "buchhaltungsbutler": { "command": "docker", "args": [ "run", "-i", "--rm", "-e", "MCP_TRANSPORT", "-e", "BB_API_CLIENT", "-e", "BB_API_SECRET", "-e", "BB_API_KEY", "ghcr.io/ohneben/buchhaltungsbutler-mcp:1.1.5" ], "env": { "MCP_TRANSPORT": "stdio", "BB_API_CLIENT": "your-value", "BB_API_SECRET": "your-value", "BB_API_KEY": "your-value" } } } } 3) Nenne mir den vollständigen Pfad der Datei, die du änderst, oder den Befehl, den du ausführst, und warte auf mein OK. 4) Lass bei BB_API_CLIENT, BB_API_SECRET, BB_API_KEY, MCP_TRANSPORT "your-value" stehen und sag mir, dass ich den echten Wert selbst in die Datei oder das Feld der App einfüge. Bitte mich nie, einen Schlüssel in den Chat zu schreiben. 5) Führe das Vereinbarte aus und prüfe, dass die Tools von BuchhaltungsButler wirklich erscheinen.

Diese Nachricht enthält keinen Schlüssel. Wird einer gebraucht, bittet dich die KI, ihn selbst in die Datei oder das Feld der App einzufügen.

  1. Docker installieren (falls noch nicht vorhanden)

    Schon installiert? Zuerst prüfen · Öffne das Terminal, gib diesen Befehl ein und drücke Enter

    docker --version
    • Eine Versionsnummer wie Docker version … = installiert, diesen Schritt überspringen
    • "command not found" (unter Windows "is not recognized") = noch nicht installiert, oder gerade installiert und das Terminal muss neu geöffnet werden
    So öffnest du das Terminal

    Mac: ⌘ + Leertaste drücken, Terminal eingeben, Enter

    Windows: Start öffnen, Windows PowerShell eingeben, dann Öffnen

    Noch nicht installiert: Docker Desktop installieren: auf dem Mac Docker.dmg öffnen und das Symbol in „Programme“ ziehen (Apple silicon oder Intel passend zum Mac wählen) · unter Windows Docker Desktop Installer.exe doppelklicken · danach die App Docker Desktop öffnen und laufen lassen. Kein curl-Befehl nötig

    Download-Seite von Docker öffnen ↗

    Danach das Terminal schließen, neu öffnen und denselben Befehl erneut ausführen. Es muss eine Versionsnummer erscheinen: docker --version

    Einmal installieren, gilt für alles, was Docker braucht

  2. Bei BuchhaltungsButler registrieren und Schlüssel erstellen

    Öffne die Seite des Anbieters, registriere dich und erstelle einen API-Schlüssel für den nächsten Schritt. Preise und Gratis-Tarife siehst du auf seiner Seite.

    Seite von BuchhaltungsButler öffnen ↗

  3. 1 Einstellung(en) ausfüllen

    Das sind Programmeinstellungen, keine Schlüssel. Keine Registrierung nötig; wie vom Autor beschrieben ausfüllen.

    • MCP_TRANSPORT Transport des Servers. Für lokale MCP-Clients auf 'stdio' setzen; das Image startet sonst den HTTP-Transport.
      Englisches Original anzeigenTransport des Servers. Fuer lokale MCP-Clients auf 'stdio' setzen; das Image startet sonst den HTTP-Transport.
      · Standard stdio

    Beschreibungen automatisch übersetzt; Variablennamen bleiben wie im Original. Im Zweifel das Original ansehen.

  4. Mit diesem Button Cursor öffnen

    In Cursor öffnen

    Cursor fragt nach einer Bestätigung; klicke Install

  5. Schlüssel eintragen

    In den Einstellungen von BuchhaltungsButler ist BB_API_CLIENT, BB_API_SECRET, BB_API_KEY, MCP_TRANSPORT leer; trag deinen Schlüssel ein und speichere

    Füge den Schlüssel nur in das Feld der App ein, nie in einen Chat und schick ihn niemandem

  6. KI-Chat in Cursor im Agent-Modus öffnen

  7. Ausprobieren

    Nutze BuchhaltungsButler und sag mir, was du für mich tun kannst; zeig mir dann eine Sache

    ✓ Wenn Cursor sagt, dass es BuchhaltungsButler nutzt, oder ein Werkzeug von BuchhaltungsButler in der Antwort zeigt, bist du verbunden

2 optionale Einstellung(en) (geht auch ohne)

Der Befehl oben funktioniert auch ohne diese Werte. Füge sie nur hinzu, wenn du etwas ändern willst, nach der Beschreibung des Autors.

  • BB_RATE_LIMIT Clientseitiges Limit für Anfragen pro Minute. BuchhaltungsButler erlaubt 100 pro Kunde und Minute
    Englisches Original anzeigenClientseitiges Limit an Anfragen pro Minute. BuchhaltungsButler erlaubt 100 pro Kunde und Minute.
    · Standard 90
  • BB_BASE_URL Überschreibt die API-Basis-URL. Standard ist der Wert aus der mitgelieferten Spec.
    Englisches Original anzeigenUeberschreibt die API-Basis-URL. Standard ist der Wert aus der mitgelieferten Spec.

Beschreibungen automatisch übersetzt; Variablennamen bleiben wie im Original. Im Zweifel das Original ansehen.

Menünamen am 11. Nov. 2026 mit der Hilfe von Cursor abgeglichen · dein Bildschirm kann je nach App-Version leicht abweichen

Klappt mit VS Code, aber erst etwas vorbereiten

Du brauchst einen Schlüssel von BuchhaltungsButler (auf der Seite des Anbieters erstellen) · 1 Einstellung(en) auszufüllen (MCP_TRANSPORT) · Installiere zuerst Docker auf deinem Computer (nur einmal)

Von der KI installieren lassen

Kopiere diese Nachricht in einen VS Code-Chat. Die KI prüft deinen Rechner, sagt dir, welche Datei sie ändert, und wartet jedes Mal auf dein OK.

Installiere bitte den MCP server BuchhaltungsButler für VS Code auf diesem Rechner, in dieser Reihenfolge: 1) Prüfe Docker mit docker --version. Fehlt es, sag mir, dass ich es von https://www.docker.com/products/docker-desktop/ installiere; installiere es nicht selbst. 2) Verwende nur diese Konfiguration (von PopNx MCP geprüft): { "servers": { "buchhaltungsbutler": { "type": "stdio", "command": "docker", "args": [ "run", "-i", "--rm", "-e", "MCP_TRANSPORT", "-e", "BB_API_CLIENT", "-e", "BB_API_SECRET", "-e", "BB_API_KEY", "ghcr.io/ohneben/buchhaltungsbutler-mcp:1.1.5" ], "env": { "MCP_TRANSPORT": "stdio", "BB_API_CLIENT": "your-value", "BB_API_SECRET": "your-value", "BB_API_KEY": "your-value" } } } } 3) Nenne mir den vollständigen Pfad der Datei, die du änderst, oder den Befehl, den du ausführst, und warte auf mein OK. 4) Lass bei BB_API_CLIENT, BB_API_SECRET, BB_API_KEY, MCP_TRANSPORT "your-value" stehen und sag mir, dass ich den echten Wert selbst in die Datei oder das Feld der App einfüge. Bitte mich nie, einen Schlüssel in den Chat zu schreiben. 5) Führe das Vereinbarte aus und prüfe, dass die Tools von BuchhaltungsButler wirklich erscheinen.

Diese Nachricht enthält keinen Schlüssel. Wird einer gebraucht, bittet dich die KI, ihn selbst in die Datei oder das Feld der App einzufügen.

  1. Docker installieren (falls noch nicht vorhanden)

    Schon installiert? Zuerst prüfen · Öffne das Terminal, gib diesen Befehl ein und drücke Enter

    docker --version
    • Eine Versionsnummer wie Docker version … = installiert, diesen Schritt überspringen
    • "command not found" (unter Windows "is not recognized") = noch nicht installiert, oder gerade installiert und das Terminal muss neu geöffnet werden
    So öffnest du das Terminal

    Mac: ⌘ + Leertaste drücken, Terminal eingeben, Enter

    Windows: Start öffnen, Windows PowerShell eingeben, dann Öffnen

    Noch nicht installiert: Docker Desktop installieren: auf dem Mac Docker.dmg öffnen und das Symbol in „Programme“ ziehen (Apple silicon oder Intel passend zum Mac wählen) · unter Windows Docker Desktop Installer.exe doppelklicken · danach die App Docker Desktop öffnen und laufen lassen. Kein curl-Befehl nötig

    Download-Seite von Docker öffnen ↗

    Danach das Terminal schließen, neu öffnen und denselben Befehl erneut ausführen. Es muss eine Versionsnummer erscheinen: docker --version

    Einmal installieren, gilt für alles, was Docker braucht

  2. Bei BuchhaltungsButler registrieren und Schlüssel erstellen

    Öffne die Seite des Anbieters, registriere dich und erstelle einen API-Schlüssel für den nächsten Schritt. Preise und Gratis-Tarife siehst du auf seiner Seite.

    Seite von BuchhaltungsButler öffnen ↗

  3. 1 Einstellung(en) ausfüllen

    Das sind Programmeinstellungen, keine Schlüssel. Keine Registrierung nötig; wie vom Autor beschrieben ausfüllen.

    • MCP_TRANSPORT Transport des Servers. Für lokale MCP-Clients auf 'stdio' setzen; das Image startet sonst den HTTP-Transport.
      Englisches Original anzeigenTransport des Servers. Fuer lokale MCP-Clients auf 'stdio' setzen; das Image startet sonst den HTTP-Transport.
      · Standard stdio

    Beschreibungen automatisch übersetzt; Variablennamen bleiben wie im Original. Im Zweifel das Original ansehen.

  4. Mit diesem Button VS Code öffnen

    In VS Code öffnen

    VS Code fragt nach einer Bestätigung; klicke Install

  5. Schlüssel eintragen

    In den Einstellungen von BuchhaltungsButler ist BB_API_CLIENT, BB_API_SECRET, BB_API_KEY, MCP_TRANSPORT leer; trag deinen Schlüssel ein und speichere

    Füge den Schlüssel nur in das Feld der App ein, nie in einen Chat und schick ihn niemandem

  6. KI-Chat in VS Code im Agent-Modus öffnen

  7. Ausprobieren

    Nutze BuchhaltungsButler und sag mir, was du für mich tun kannst; zeig mir dann eine Sache

    ✓ Wenn VS Code sagt, dass es BuchhaltungsButler nutzt, oder ein Werkzeug von BuchhaltungsButler in der Antwort zeigt, bist du verbunden

2 optionale Einstellung(en) (geht auch ohne)

Der Befehl oben funktioniert auch ohne diese Werte. Füge sie nur hinzu, wenn du etwas ändern willst, nach der Beschreibung des Autors.

  • BB_RATE_LIMIT Clientseitiges Limit für Anfragen pro Minute. BuchhaltungsButler erlaubt 100 pro Kunde und Minute
    Englisches Original anzeigenClientseitiges Limit an Anfragen pro Minute. BuchhaltungsButler erlaubt 100 pro Kunde und Minute.
    · Standard 90
  • BB_BASE_URL Überschreibt die API-Basis-URL. Standard ist der Wert aus der mitgelieferten Spec.
    Englisches Original anzeigenUeberschreibt die API-Basis-URL. Standard ist der Wert aus der mitgelieferten Spec.

Beschreibungen automatisch übersetzt; Variablennamen bleiben wie im Original. Im Zweifel das Original ansehen.

Menünamen am 11. Nov. 2026 mit der Hilfe von VS Code abgeglichen · dein Bildschirm kann je nach App-Version leicht abweichen

Andere Apps mit MCP, etwa Windsurf, Zed oder Gemini CLI, fügen Server unterschiedlich hinzu. Sieh in der App-Liste nach

Alle Apps mit MCP ansehen →

JSON-Einstellungen stehen unten unter „Für Entwickler“

Hängst du fest? Frag Leute, die BuchhaltungsButler nutzen💬 Diskussion →
Für Entwickler: Terminal-Befehle und JSON-Einstellungen

Auf deinem Computer installiert

Claude Code

claude mcp add --scope user buchhaltungsbutler --env MCP_TRANSPORT=stdio --env BB_API_CLIENT=your-value --env BB_API_SECRET=your-value --env BB_API_KEY=your-value -- docker run -i --rm -e MCP_TRANSPORT -e BB_API_CLIENT -e BB_API_SECRET -e BB_API_KEY ghcr.io/ohneben/buchhaltungsbutler-mcp:1.1.5

Claude Desktop (claude_desktop_config.json)

{
  "mcpServers": {
    "buchhaltungsbutler": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "MCP_TRANSPORT",
        "-e",
        "BB_API_CLIENT",
        "-e",
        "BB_API_SECRET",
        "-e",
        "BB_API_KEY",
        "ghcr.io/ohneben/buchhaltungsbutler-mcp:1.1.5"
      ],
      "env": {
        "MCP_TRANSPORT": "stdio",
        "BB_API_CLIENT": "your-value",
        "BB_API_SECRET": "your-value",
        "BB_API_KEY": "your-value"
      }
    }
  }
}

Cursor (~/.cursor/mcp.json)

{
  "mcpServers": {
    "buchhaltungsbutler": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "MCP_TRANSPORT",
        "-e",
        "BB_API_CLIENT",
        "-e",
        "BB_API_SECRET",
        "-e",
        "BB_API_KEY",
        "ghcr.io/ohneben/buchhaltungsbutler-mcp:1.1.5"
      ],
      "env": {
        "MCP_TRANSPORT": "stdio",
        "BB_API_CLIENT": "your-value",
        "BB_API_SECRET": "your-value",
        "BB_API_KEY": "your-value"
      }
    }
  }
}

VS Code (mcp.json)

{
  "servers": {
    "buchhaltungsbutler": {
      "type": "stdio",
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "MCP_TRANSPORT",
        "-e",
        "BB_API_CLIENT",
        "-e",
        "BB_API_SECRET",
        "-e",
        "BB_API_KEY",
        "ghcr.io/ohneben/buchhaltungsbutler-mcp:1.1.5"
      ],
      "env": {
        "MCP_TRANSPORT": "stdio",
        "BB_API_CLIENT": "your-value",
        "BB_API_SECRET": "your-value",
        "BB_API_KEY": "your-value"
      }
    }
  }
}

Werte, die du selbst einträgst

  • MCP_TRANSPORT erforderlich env
    Transport des Servers. Für lokale MCP-Clients auf 'stdio' setzen; das Image startet sonst den HTTP-Transport.
    Englisches Original anzeigenTransport des Servers. Fuer lokale MCP-Clients auf 'stdio' setzen; das Image startet sonst den HTTP-Transport.
  • BB_API_CLIENT geheim erforderlich env
    BuchhaltungsButler API-Client (HTTP-Basic-Benutzername). Zu finden unter Einstellungen -> API.
  • BB_API_SECRET geheim erforderlich env
    BuchhaltungsButler API-Secret (HTTP-Basic-Passwort). Zu finden unter Einstellungen -> API.
  • BB_API_KEY geheim erforderlich env
    api_key des Mandanten, auf dem gearbeitet wird. Zu finden in den Firmendaten des Kunden
    Englisches Original anzeigenapi_key des Mandanten, auf dem gearbeitet wird. Zu finden in den Firmendaten des Kunden.
  • BB_RATE_LIMIT env
    Clientseitiges Limit für Anfragen pro Minute. BuchhaltungsButler erlaubt 100 pro Kunde und Minute
    Englisches Original anzeigenClientseitiges Limit an Anfragen pro Minute. BuchhaltungsButler erlaubt 100 pro Kunde und Minute.
  • BB_BASE_URL env
    Überschreibt die API-Basis-URL. Standard ist der Wert aus der mitgelieferten Spec.
    Englisches Original anzeigenUeberschreibt die API-Basis-URL. Standard ist der Wert aus der mitgelieferten Spec.

Beschreibungen automatisch übersetzt; Variablennamen bleiben wie im Original. Im Zweifel das Original ansehen.

Diese Einstellungen werden aus dem Registry-Eintrag des Entwicklers erzeugt. Wenn in der README etwas anderes steht, folge der README.

Auf einen Blick

Downloads pro Wochei
Nicht auf npm/PyPI
Verbindung
Läuft auf deinem Computer
Neueste Versioni
1.1.5
Kategoriei
Sonstiges
In der Registry veröffentlichti
29. Okt. 2026
Code zuletzt geänderti
29. Okt. 2026
Entwickler
ohneben
Pakete
oci: ghcr.io/ohneben/buchhaltungsbutler-mcp:1.1.5
Website
github.com
Registry-Status
Aktiv

Welche Apps ihn nutzen können

Basierend darauf, wie sich dieser Server verbindet, und auf der eigenen Doku jeder App, geprüft am 10. Nov. 2026.

Laufen auf deinem Computer in

ClaudeGooseLM StudioMsty StudioCherry StudioCursorVS Code + GitHub CopilotVisual StudioWindsurf (Devin Desktop)ZedKiroClineContinueJetBrains AI AssistantClaude CodeCodex CLIGemini CLIOpenCodenodecodeWarpLibreChatRaycast

Alle Apps, mit Vor- und Nachteilen →

Was er kann

Läuft auf deinem Computer; die Tool-Liste erscheint nach der Installation in deiner KI-App.

Basischecksi

Wir prüfen Informationen, die jeder sehen kann; den Code haben wir nicht gelesen. Checks, die nicht zutreffen, werden nicht mitgezählt. · Geprüft am 20. Nov. 2026

  • ✓ Bestanden

    Entwickler passt zum Repo

    Der Registry-Name wurde mit dem GitHub-Konto ohneben bestätigt, dem das Repo gehört

  • ✓ Bestanden

    Wird noch gepflegt

    Code zuletzt geändert: vor 22 Tagen

  • ✓ Bestanden

    Hat eine Lizenz

    Nutzt MIT

  • – Nicht zutreffend

    Endpunkt antwortet

    Dieser Server läuft auf deinem Computer; es gibt keinen Endpunkt im Internet

  • – Nicht zutreffend

    Anmeldung mit OAuth

    Läuft auf deinem Computer und nutzt stattdessen lokale Einstellungen

  • … Noch nicht geprüft

    Keine versteckten Anweisungen in Tool-Beschreibungen

    Läuft auf deinem Computer; Tool-Listen können wir nur von Endpunkten im Internet lesen

Veröffentlichte Schwachstellen (OSV.dev)

Nicht geprüft: nur npm- und PyPI-Pakete mit Version lassen sich prüfen

Was wir prüfen → · JSON

Entwickler: neue Prüfung anfordern oder falsche Angaben melden
Für Anbieter: Badge ins README

Wenn du das gebaut hast, füge diesen Code in dein README ein. Das Badge verlinkt auf diese Seite.

[![Featured on PopNx MCP](https://mcp.popnx.com/badge/ohneben-buchhaltungsbutler-mcp.svg)](https://mcp.popnx.com/en/servers/ohneben-buchhaltungsbutler-mcp)

Diskussion

Fragen, Tipps teilen oder melden, dass etwas nicht geht. Sortiert nach „hilfreich“.

Noch keine Beiträge. Stell die erste Frage oder teile einen Tipp.

Beiträge hier stammen von Nutzern, nicht vom PopNx-Team.

Anmelden, um zu posten

Nutzerbewertungen

Noch keine Bewertungen

Anmelden, um eine Bewertung zu schreiben

Im Vergleich mit anderen in Sonstigesi

  • Mehr Sterne als 96 % der anderen 20815 Server in dieser Kategorie
  • Neuer in der Registry veröffentlicht als 67 % der anderen 20815 Server in dieser Kategorie
  • Basischecks gleich gut wie oder besser als bei 99 % der anderen 20815 Server in dieser Kategorie

Verglichen mit allen aktiven Servern dieser Kategorie in der Registry. Sterne zählen nur, wenn dem Herausgeber das Repo gehört.

Häufige Fragen

Ist BuchhaltungsButler sicher?

Er hat 3 von 3 zutreffenden Basischecks bestanden. Den Code haben wir nicht gelesen. Bevor du einen Schlüssel oder Token hinzufügst, sieh nach, welche Zugriffe der Server verlangt, und nutze einen Schlüssel, der nur die Berechtigungen hat, die du brauchst.

Welche Schlüssel oder Codes braucht er?

Das musst du eintragen: BB_API_CLIENT, BB_API_SECRET, BB_API_KEY

Läuft er auf meinem Computer oder in der Cloud?

Er läuft auf deinem Computer. Deine KI-App startet ihn bei Bedarf, und die Daten laufen nicht über die Server des Entwicklers (außer der Server ruft selbst einen Onlinedienst auf).

Wird er noch gepflegt?

Das GitHub-Repo wurde zuletzt vor 22 Tagen geändert, und die neueste Version (1.1.5) kam vor 22 Tagen in die Registry.

Welche Apps können ihn nutzen?

Apps, die MCP unterstützen, etwa Claude Desktop, Claude Code, Cursor und VS Code. Außerdem brauchst du Docker auf deinem Computer.

Was kann ich stattdessen nutzen?

In derselben Kategorie: World Monitor, openstatus, Oh My Posh Validator, Strata, Jitsu

Ähnliche Alternativen

Gleiche Kategorie, andere Entwickler, Befehle bereits geprüft. Offizielle zuerst, dann nach Sternen.

So liest du eine Karte:↓ Downloads pro Wochei★ GitHub-SterneiDrei Säulen: Bewertungen · Checks · NutzungiAktualisiert = neueste Version in der Registry veröffentlichti

World Monitor

Real-time global intelligence on conflict, markets, energy, trade, shipping and cyber. 100 tools.

von koala73Weit verbreitet★ 90.934Aktualisiert vor 4 Tagen

Läuft in der Cloud✓ vom Dienst · worldmonitor.app

openstatus

Manage monitors, status pages, incidents and maintenances in your openstatus workspace.

von openstatusHQWeit verbreitet★ 9274Aktualisiert vor 2 Monaten

Läuft in der Cloud✓ vom Dienst · openstatus.dev

Oh My Posh Validator

Validate oh-my-posh configurations and segment snippets against the official schema.

von JanDeDobbeleerWeit verbreitet★ 23.770 Sterne des ganzen ReposAktualisiert vor 31 Tagen

Läuft in der Cloud✓ vom Dienst · ohmyposh.dev

Strata

MCP server for progressive tool usage at any scale (see https://klavis.ai)

von Klavis-AIWachsend★ 5824Aktualisiert vor 14 Monaten

Läuft in der CloudRepo archiviert✓ klavis.ai

Jitsu

Manage Jitsu data pipelines: destinations, streams, connections, functions, live events.

von jitsucomWeit verbreitet★ 5136Aktualisiert vor 4 Monaten

Läuft in der Cloud✓ vom Dienst · jitsu.com
Im Vergleich mit ähnlichen
Dieser
BuchhaltungsButler
World MonitoropenstatusOh My Posh ValidatorStrataJitsu
Läuft woWird auf deinem Rechner installiertLäuft in der Cloud, keine InstallationLäuft in der Cloud, keine InstallationLäuft in der Cloud, keine InstallationLäuft in der Cloud, keine InstallationLäuft in der Cloud, keine Installation
Braucht SchlüsselJaNeinNeinNeinNeinNein
Mit + in Claude hinzufügenNeinNeinNeinNeinNeinNein
Basisprüfungen3/34/44/44/41/44/4
LizenzMITAGPL-3.0AGPL-3.0MITApache-2.0MIT
PreisKeine Kosten im RegisterKeine Kosten im RegisterKeine Kosten im RegisterKeine Kosten im RegisterKeine Kosten im RegisterKeine Kosten im Register

README vom Entwickler

README öffnen

Unverändert aus dem Repo des Entwicklers übernommen. PopNx MCP hat den Inhalt weder geprüft noch empfiehlt es ihn. HTML, Bilder und Skripte wurden entfernt. Links führen von dieser Website weg.

ohneben's Buchhaltungsbutler MCP


Lizenz & Checks
MCP-Register
Paketkennungen

Dieser Server hat eigene Kennungen. Was anders heißt, gehört nicht dazu:

WoKennung
MCP-Registerio.github.ohneben/buchhaltungsbutler-mcp
Container (GHCR)ghcr.io/ohneben/buchhaltungsbutler-mcp
npm@ohneben/buchhaltungsbutler-mcp (noch nicht veröffentlicht)

Das npm-Paket buchhaltungsbutler-mcp ohne Scope ist ein anderes Projekt eines anderen Autors (mrvnklm/buchhaltungsbutler-mcp) und hat mit diesem hier nichts zu tun. Verzeichnisse, die von dieser Seite dorthin verlinken, verlinken auf das falsche Paket.

Verwalte deine BuchhaltungsButler-Buchhaltung in natürlicher Sprache aus KI-Assistenten wie Claude, Cursor und jedem anderen MCP-Client.

Dieser Model-Context-Protocol-Server stellt die [BuchhaltungsButler API v1](https://app.buchhaltungsbutler.de/docs/api/v1/) bereit — alle 54 Endpunkte als 46 MCP-Tools, aus der offiziellen OpenAPI-Spezifikation (Spec-Version 1.9.1) generiert. Jedes Tool ist sicherheitskategorisiert (nur lesend / schreibend / destruktiv), damit dein Assistent weiß, was eine Aktion tut, *bevor* er sie ausführt. Läuft über stdio (Claude Desktop und andere lokale Launcher) oder Streamable HTTP (gehostet in Docker).

Warum dieser Server

Manche MCP-Server leiten eine API einfach nur weiter. Dieser hier ist darauf ausgelegt, gefahrlos an ein Sprachmodell übergeben und im Alltag betrieben werden zu können:

Was du bekommstWarum das zählt
Alle 54 Endpunkte, automatisch generiert aus der offiziellen SpecVollständige Abdeckung von Belegen, Transaktionen, Buchungen, Rechnungen, Auswertungen und Stammdaten. Nichts handverlesen, nichts vergessen.
Jedes Tool ist sicherheitskategorisiert 🟢 / 🟡 / 🔴Ein Banner am Anfang jeder Tool-Beschreibung sagt dem Modell genau, was passiert — lesen, anlegen, ändern, zurücknehmen oder löschen — bevor es handelt.
Maschinenlesbare MCP-Annotationen (readOnlyHint, destructiveHint)Hosts, die Annotationen auswerten (Claude gehört dazu), können Lesezugriffe automatisch zulassen und vor destruktiven Aktionen eine Bestätigung verlangen.
**Zwei Transporte: stdio *und* Streamable HTTP**Lokal in Claude Desktop nutzen — oder einen dauerhaft laufenden Server betreiben, den beliebig viele MCP-Clients über HTTP erreichen.
Docker + docker-compose, Health-Check, Auto-RestartProduktionsnahes Deployment ab Werk: docker compose up, und er bleibt oben.
Bearer-Token-Authentifizierung am HTTP-EndpunktPflicht, sobald der Server über Loopback hinaus gebunden ist: ohne MCP_AUTH_TOKEN verweigert er den Start, statt die API ungeschützt bereitzustellen.
Eingebautes Rate-LimitingDrosselt sich selbst unter dem BuchhaltungsButler-Limit von 100 Anfragen/Kunde/Minute, damit du nie dagegenläufst.
Deine Zugangsdaten erreichen das Modell nieDie Credentials liegen in der Server-Umgebung und werden pro Anfrage injiziert — der Assistent sieht nur Tool-Eingaben und API-Antworten.
Im Vergleich

Nach aktuellem Stand ist dies der einzige dedizierte BuchhaltungsButler-MCP-Server. Alternativ *könntest* du einen generischen OpenAPI→MCP-Wrapper auf die Spec richten — das lässt allerdings einiges liegen:

FähigkeitDieses ProjektGenerischer OpenAPI→MCP-Wrapper\*
Alle 54 BuchhaltungsButler-Endpunkte abgedeckt✅✅
🟢 / 🟡 / 🔴 Sicherheitskategorie + Banner pro Tool✅❌
readOnlyHint / destructiveHint MCP-Annotationen✅➖
$ref-Auflösung für Batch-Payloads + HTML-bereinigte Beschreibungen✅➖
Eingebautes Rate-Limiting (bleibt unter BBs 100/Kunde/Min.)✅❌
stdio-Transport✅✅
Streamable-HTTP-Transport✅➖
Docker + docker-compose, Health-Check, Auto-Restart✅❌
Erzwungene Bearer-Token-Auth am Endpunkt✅❌
Credentials serverseitig injiziert, nie ans Modell gesendet✅➖
LizenzMITunterschiedlich

\*Generische OpenAPI→MCP-Wrapper machen aus jeder Swagger-/OpenAPI-Spec MCP-Tools. Sie erreichen dieselben Endpunkte, behandeln aber jede Operation gleich — keine Sicherheitskategorien, keine Betriebsgeschichte, keine auf echte Buchhaltungsdaten abgestimmten Leitplanken. „➖“ = je nach Werkzeug unterschiedlich / nicht garantiert.

Was du damit machen kannst

Sobald der Server verbunden ist, kannst du deinen Assistenten zum Beispiel bitten:

  • „Liste alle Eingangsbelege vom letzten Monat auf, die noch offen sind.“
  • „Erstelle einen Rechnungsentwurf für die ACME GmbH: 10 Stunden Beratung à 120 €.“
  • „Buche diese Banktransaktion auf Sachkonto 4400.“
  • „Lade diesen PDF-Beleg hoch und ordne ihn der passenden Transaktion zu.“
  • „Zeig mir meine Kreditoren und leg einen neuen für unseren Hosting-Anbieter an.“
  • „Erstelle mir die BWA für das letzte Quartal und zeig mir das Kontenblatt zu Konto 4400.“

Die Tools werden automatisch aus der offiziellen API generiert und in 🟢 nur lesend, 🟡 schreibend und 🔴 destruktiv gruppiert — ein gut umgesetzter Host kann jede Gruppe unterschiedlich behandeln.

Funktionsweise

Claude / Cursor / beliebiger MCP-Client  ──MCP──►  dieser Server  ──HTTPS──►  BuchhaltungsButler API (Cloud)

Der Server liest die mitgelieferte OpenAPI-Spec ein und macht daraus MCP-Tools (inklusive Auflösung von $ref-Batch-Payloads und Entfernen von HTML aus den Beschreibungen), versieht jedes Tool mit seiner Sicherheitskategorie und hängt deine Basic-Auth-Credentials sowie den api_key an jede ausgehende Anfrage. Deine Zugangsdaten bleiben in der Server-Umgebung — das Modell sieht sie nie und fasst sie nie an.

Voraussetzungen

  • Ein BuchhaltungsButler-Konto mit API-Zugang — ein API Client + API Secret (Einstellungen → API) sowie ein Kunden-`api_key` (siehe API-Zugangsdaten besorgen).
  • Docker (Docker Desktop unter macOS/Windows) für den Schnellstart unten — oder Node.js ≥ 18, um aus dem Quellcode zu starten.

Schnellstart (Docker)

1. Zugangsdaten hinterlegen. Beispielkonfiguration kopieren und ausfüllen:

cp .env.example .env

.env bearbeiten → BB_API_CLIENT, BB_API_SECRET, BB_API_KEY setzen

→ MCP_AUTH_TOKEN setzen. PFLICHT, sonst startet der Server

nicht, denn .env.example bindet auf 0.0.0.0:

openssl rand -hex 32

2. Server starten:

docker compose up -d --build

3. Prüfen, ob er läuft:

curl -s http://localhost:3000/health     # → {"status":"ok","server":"buchhaltungsbutler-mcp"}

4. MCP-Client verbinden. Entfernte Endpunkte werden in Claude als Custom Connector hinzugefügt (Einstellungen → Connectors) oder lokal mit mcp-remote gebrückt. Trage Folgendes unter mcpServers in deiner Client-Konfiguration ein und starte die App danach vollständig neu:

{

"mcpServers": { "buchhaltungsbutler": { "command": "npx", "args": [ "mcp-remote", "http://localhost:3000/mcp", "--header", "Authorization: Bearer DEIN_MCP_AUTH_TOKEN" ] } } }

(Die --header-Zeile entfällt nur, wenn du ohne Token auf Loopback bindest. Im Docker-Schnellstart oben ist das Token Pflicht.)

Lieber ein fertiges Image?

Jeder Push auf main veröffentlicht ein startbereites Image in der GitHub Container Registry — damit kannst du den lokalen Build komplett überspringen:

docker run -d --name buchhaltungsbutler-mcp -p 3000:3000 --env-file .env \

ghcr.io/ohneben/buchhaltungsbutler-mcp:latest

API-Zugangsdaten besorgen

BuchhaltungsButler nutzt zwei Authentifizierungsebenen (siehe die offizielle Dokumentation):

  1. HTTP-Basic-Auth — ein API Client + API Secret, deine globalen API-Zugangsdaten. Zu finden bzw. anzulegen in BuchhaltungsButler unter Einstellungen → API.
  2. `api_key` — legt fest, *auf welches Kundenkonto* sich eine Anfrage bezieht. Er steht in den Firmendaten-Einstellungen des jeweiligen Kunden.

Trage alle drei Werte in .env ein. Der Server hängt sie an jede Anfrage an, dein Assistent bekommt sie also nie zu sehen. Ein einzelner Tool-Aufruf kann optional einen eigenen api_key mitgeben, um ein anderes Kundenkonto anzusprechen.

Konfiguration

Alles wird in .env gesetzt (kopiert aus .env.example):

VariablePflichtStandardBeschreibung
BB_API_CLIENT✅—API Client (Basic-Auth-Benutzername)
BB_API_SECRET✅—API Secret (Basic-Auth-Passwort)
BB_API_KEY✅—Standard-Kunden-api_key
MCP_TRANSPORT—stdiostdio oder http (das Docker-Image nutzt standardmäßig http)
PORT—3000HTTP-Port, auf dem gelauscht wird
HOST—0.0.0.0HTTP-Bind-Adresse
MCP_HTTP_PATH—/mcpHTTP-Route für MCP
MCP_AUTH_TOKEN⚠️_(aus)_Verlangt Authorization: Bearer auf /mcp. Pflicht, wenn HOST keine Loopback-Adresse ist — sonst startet der Server nicht
MCP_ALLOWED_HOSTS—_(automatisch)_Erlaubte Host-Header, kommagetrennt (Schutz vor DNS-Rebinding). Nötig hinter einem Reverse-Proxy
MCP_ALLOW_INSECURE—_(aus)_Hebt die Startverweigerung ohne Token auf. Nur für nachweislich unerreichbare Endpunkte
MCP_SESSION_TTL—1800Sekunden Leerlauf, bevor eine Session verworfen wird
MCP_MAX_SESSIONS—256Obergrenze gleichzeitiger Sessions
BB_ALLOW_API_KEY_OVERRIDE—_(aus)_Erlaubt einem Tool-Aufruf, den api_key zu überschreiben
BB_RATE_LIMIT—90Clientseitiges Limit an Anfragen pro Minute
BB_READ_TIMEOUT_MS—55000Gesamtbudget eines Lese-Tools in Millisekunden, über alle Versuche. Liegt unter den 60 s, nach denen der SDK-Client aufgibt
BB_READ_RETRIES—2Weitere Versuche eines Lese-Tools nach Timeout, Netzwerkfehler oder HTTP 429/502/503/504 (max. 5), solange das Budget reicht. Bricht der Client ab, startet kein weiterer Versuch. Schreib-Tools werden nie wiederholt und haben kein Timeout
BB_BASE_URL—_(aus der Spec)_Überschreibt die Basis-URL der API

Nach Änderungen an .env neu laden mit docker compose up -d --force-recreate.

Toolnamen

Jedes Tool heißt _ . Die Verben sind fest: list, get, create, update, delete, upload, assign, `unassign

Nur der Anfang wird gezeigt; den Rest findest du im Repo