runBqlQuery
Führen Sie BQL-Abfragen (Beancount Query Language) gegen Salden, Transaktionen und Konten aus.
Model Context Protocol
Ihr Hauptbuch wird Teil des Gesprächs.
Verbinden Sie Beancount mit Ihren vertrauten KI-Tools. Stellen Sie Fragen zu Ihren Finanzen, bearbeiten Sie Ihre Hauptbuchdateien und verfolgen Sie jede Änderung in Git.
Einfach fragen
Beginnen Sie mit einer Frage. Folgen Sie der Antwort zurück zu Ihrem Hauptbuch.
Hinter der Antwort
runBqlQuerySELECT sum(position) WHERE account ~ 'Assets|Liabilities'Beancount
Funktioniert mit Ihrem MCP-kompatiblen Client
- Claude Code
- Claude Desktop
- Cursor
- Windsurf
- Zed
Verbinden Sie den Client, den Sie bereits verwenden
Wählen Sie Ihren Client, fügen Sie den Server einmal hinzu und autorisieren Sie die Ledger, auf die er zugreifen darf.
Claude Code
Führen Sie diesen Befehl in Ihrem Terminal aus.
Öffnen Sie Claude Code und führen Sie /mcp aus, um sich zu authentifizieren. Melden Sie sich bei Web Beancount an und genehmigen Sie ein einzelnes Ledger oder alle.
Einmal bestätigen. Anmeldedaten werden von hier aus automatisch aktualisiert.
Terminal
claude mcp add --transport http beancount https://beancount.io/api-gateway/mcpMehr als ein Ledger? Genehmigen Sie einfach alle auf einmal. Der Assistent ruft listLedgers auf, um zu sehen, worauf er zugreifen kann, und nennt bei jedem Aufruf das Ledger – ein einziger Server deckt damit alle Bücher ab.
Autorisieren Sie mit Ihrem Web Beancount-Konto, auf welche Ledger der Server zugreifen darf.
Haben Sie noch kein Web Beancount-Konto? Registrieren Sie sich auf beancount.io – Ihr Ledger ist nur einen Git-Push entfernt.
Was die KI tun kann
Der Server stellt gezielte Tools für Ihr Hauptbuch und Ihre Bankverbindungen bereit – die Hauptbuch-Verben sehen Sie unten. Die KI kombiniert sie: Dateistruktur erkunden, Kontext lesen, Antworten abfragen, eine Änderung vorschlagen.
Hauptbuch- und Bank-Tools. Ihr Client entscheidet, wie er sie einsetzt.
listLedgerFiles
Durchsuchen Sie die Verzeichnisstruktur Ihres Ledger-Repositorys.
readLedgerFiles
Lesen Sie den Inhalt Ihrer .beancount-Dateien und anderer Ledger-Dokumente.
updateLedgerFiles
Ändert Dateien in einem atomaren git-Commit, mit dry_run-Vorschau; createLedgerFiles und deleteLedgerFiles legen Dateien an und entfernen sie.
Ihr Ledger, geschützt
Eine KI mit Schreibzugriff auf Ihre Bücher verdient Vertrauen durch Design, nicht durch Versprechen.
Bereichsbeschränktes OAuth 2.1
Sie entscheiden, worauf eine Verbindung zugreifen kann: auf ein einzelnes Ledger oder auf alle. Autorisieren Sie nur Ihr persönliches Ledger, und die Verbindung kann Ihre Geschäftsbücher nicht berühren – Sie bestimmen die Reichweite.
Dry-Run-Vorschauen
Die Datei-Tools (createLedgerFiles, updateLedgerFiles, deleteLedgerFiles) und appendLedgerText unterstützen einen dry_run-Modus, der die genauen Änderungen prüft und als Vorschau zeigt, ohne etwas zu schreiben – so kann Ihr Client Ihnen zuerst einen Diff anzeigen.
Jede Bearbeitung ist ein Git-Commit
Änderungen werden als echte Commits ("AI edit: …") im Repository Ihres Ledgers gespeichert – eine vollständige Prüfspur, die Sie mit Standard-Git-Tools überprüfen und zurücksetzen können.
Zustandsloser Server
Der MCP-Server speichert keinen Sitzungsstatus zwischen Tool-Aufrufen. Ihr gewählter KI-Client und das Modell erhalten die von Ihnen angeforderten Ergebnisse; prüfen Sie deren Datenrichtlinien, bevor Sie eine Verbindung herstellen.
Ihr gesamtes Ledger ist bereits ein Git-Repository.
Erfahren Sie, wie Git for Beancount funktioniertHäufig gestellte Fragen
Was Sie wissen sollten, bevor Sie sich verbinden.
Neugierig, wie es aufgebaut ist?
Lesen Sie das technische FAQ im BlogWas ist MCP und warum ist es für Beancount wichtig?
MCP (Model Context Protocol) ist ein offener Standard, der KI-Assistenten ermöglicht, externe Tools und Datenquellen strukturiert und sicher aufzurufen. Statt zu raten oder Sie aufzufordern, Daten einzufügen, verbindet sich Ihr KI-Client direkt mit Ihrem Ledger – er fragt Ihre echten Daten ab, liest Ihre tatsächlichen Dateien und nimmt präzise Änderungen vor.
Welche KI-Clients funktionieren mit dem Beancount MCP-Server?
Jeder MCP-kompatible Client, der OAuth 2.1 unterstützt, funktioniert sofort, einschließlich Claude Code, Claude Desktop, Cursor, Windsurf und Zed. Clients ohne OAuth 2.1-Unterstützung können sich mit einem statischen Token verbinden, das in Ihren beancount.io-Kontoeinstellungen generiert wird.
Wie verbinde ich mein Ledger?
Fügen Sie die Server-URL zur MCP-Konfiguration Ihres Clients hinzu. Beim ersten Gebrauch öffnet der Client ein Browserfenster – melden Sie sich mit Ihrem Web Beancount-Konto an und wählen Sie, ob er auf ein einzelnes Ledger oder auf alle zugreifen darf. Der Client speichert und aktualisiert Anmeldedaten von dort automatisch.
Was kann die KI tatsächlich mit meinem Ledger tun?
Der Server stellt für jede Operation ein eigenes Tool bereit – das maschinenlesbare Discovery-Manifest unter beancount.io/.well-known/ listet den aktuellen Umfang. Hauptbuch-Tools führen Abfragen in der Beancount Query Language aus (runBqlQuery), durchsuchen das Repository (listLedgerFiles), lesen Hauptbuchdokumente (readLedgerFiles), fügen Direktiven in Datumsreihenfolge hinzu (appendLedgerText) und erstellen, ändern oder löschen Dateien in einem atomaren git-Commit (createLedgerFiles, updateLedgerFiles, deleteLedgerFiles, jeweils mit dry_run-Vorschaumodus). Bank-Tools holen, importieren oder verwerfen vorgemerkte Transaktionen und verwalten verknüpfte Verbindungen; eine ganz neue Bank wird im Browser verknüpft, nicht über MCP. API-Schlüssel und Kontoeinstellungen bleiben in der Beancount.io-Web-App. Die KI kombiniert die Tools, um Fragen zu beantworten und Änderungen vorzuschlagen.
Kann die KI mein Ledger ohne mein Wissen ändern?
Neue Direktiven laufen über appendLedgerText, Dateiänderungen über die Datei-Tools – createLedgerFiles, updateLedgerFiles, deleteLedgerFiles. Ein dry_run-Modus zeigt die geplanten Änderungen als Vorschau, ohne etwas zu committen; ob Ihr Client vor einem echten Commit nachfragt, hängt vom Client ab. Jede übernommene Änderung landet als echter git-Commit – ein vollständiger Prüfpfad, den Sie mit Standard-git-Werkzeugen zurücknehmen können. Der Commit-Pfad kann Validierungsfehler erst nach dem Schreiben melden; sehen Sie sich daher zuerst die Vorschau an und prüfen Sie das Hauptbuch danach.
Werden meine Daten an Dritte gesendet?
Ihre Hauptbuchdaten durchlaufen das Backend von Web Beancount und gelangen als Tool-Ergebnisse an Ihren KI-Client. Auch das von Ihnen gewählte KI-Modell erhält diese Ergebnisse, daher gelten die Datenrichtlinien seines Anbieters ebenfalls. Jede autorisierte Sitzung ist auf ein Hauptbuch beschränkt.
Bringen Sie Ihr Hauptbuch in Ihr nächstes Gespräch.
Der Beancount MCP-Server ist heute für alle Web Beancount-Nutzer verfügbar. Ihr Ledger ist nur einen Git-Push entfernt.