Model Context Protocol
Sprechen Sie mit Ihrem Ledger über die KI-Tools, die Sie bereits nutzen
Der Beancount-MCP-Server verbindet Ihr Klartext-Ledger mit Claude Code, Claude Desktop, Cursor, Windsurf, Zed – mit jedem MCP-kompatiblen KI-Client. Kein Kopieren und Einfügen. Keine Exporte. Fragen Sie einfach.
MCP-Server-URL
https://beancount.io/api-gateway/mcp> Wie hoch ist mein Nettovermögen heute?
⏺ runBqlQuery("SELECT sum(position) WHERE account ~ 'Assets|Liabilities'")
Ihr Nettovermögen beträgt heute 128,450.32 USD.
> Fügen Sie gestern das 42-USD-Teamessen hinzu und committen Sie es.
⏺ editLedgerFiles(dry_run: true) → +1 transaction
⏺ git commit a1b4f2e — "AI edit: add team dinner transaction"
Fertig – committet in Ihrem Ledger mit einem vollständigen Audit-Trail.
Einfach fragen
„Wie viel habe ich letztes Quartal für Reisen ausgegeben?“ zu beantworten, erforderte früher BQL-Kenntnisse, das Finden der richtigen Dateien und das Kopieren der Ergebnisse in einen Chat. Jetzt ist es ein Satz.
“Wie hoch ist mein Nettovermögen heute?”
Eine echte Antwort aus Ihrem tatsächlichen Ledger – keine Schätzung.
“Fassen Sie die Ausgaben des letzten Monats zusammen.”
Die KI schreibt die BQL-Abfrage für Sie und liest die Ergebnisse vor.
“Fügen Sie eine Transaktion hinzu und committen Sie sie in git.”
Ein echter Commit in Ihrem Ledger-Repository, der sich wie jeder andere zurücksetzen lässt.
“Was ist in meinem Ledger-Repository?”
Durchsuchen und lesen Sie Ihre .beancount-Dateien, ohne Ihren Editor zu verlassen.
Was die KI tun kann
Der Server stellt vier Ledger-Tools bereit. Die KI setzt sie zusammen: Entdecken Sie Ihre Dateistruktur, lesen Sie für den Kontext, fragen Sie für Antworten und schlagen Sie eine Bearbeitung vor.
runBqlQuery
Führen Sie BQL-Abfragen (Beancount Query Language) gegen Salden, Transaktionen und Konten aus.
listLedgerFiles
Durchsuchen Sie die Verzeichnisstruktur Ihres Ledger-Repositorys.
readLedgerFiles
Lesen Sie den Inhalt Ihrer .beancount-Dateien und anderer Ledger-Dokumente.
editLedgerFiles
Erstellen, aktualisieren, ersetzen oder löschen Sie Dateien in einem atomaren Git-Commit.
In weniger als einer Minute verbunden
Wählen Sie Ihren KI-Client. Kopieren. Einfügen. Fragen.
- Führen Sie diesen Befehl in Ihrem Terminal aus.
- Claude Code öffnet ein Browserfenster – melden Sie sich an und wählen Sie, welches Ledger verbunden werden soll.
- Einmal bestätigen. Anmeldedaten werden von hier aus automatisch aktualisiert.
claude mcp add --transport http beancount https://beancount.io/api-gateway/mcpHaben Sie mehr als ein Ledger? Fügen Sie den Server erneut unter einem anderen Namen hinzu und autorisieren Sie das andere Ledger in dessen eigener Eingabeaufforderung:
claude mcp add --transport http beancount-business https://beancount.io/api-gateway/mcpHaben Sie noch kein Web Beancount-Konto? Registrieren Sie sich auf beancount.io – Ihr Ledger ist nur einen Git-Push entfernt.
Ihr Ledger, geschützt
Eine KI mit Schreibzugriff auf Ihre Bücher verdient Vertrauen durch Design, nicht durch Versprechen.
Ledger-gebundenes OAuth 2.1
Eine Sitzung ist für genau ein Ledger autorisiert. Eine Sitzung für Ihr persönliches Ledger kann Ihr Geschäfts-Ledger nicht berühren – begrenzte Wirkung.
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.
Dry-Run-Vorschauen
editLedgerFiles unterstützt einen dry_run-Modus, der die genauen Änderungen validiert und Vorschauen anzeigt, ohne etwas zu schreiben, sodass Ihr Client Ihnen zuerst einen Diff zeigen kann.
Zustandsloser Server
Der MCP-Server speichert nichts über das hinaus, was die Konversation Ihres KI-Clients bereits enthält. Ihr Ledger bleibt dort, wo er heute liegt.
Ihr gesamtes Ledger ist bereits ein Git-Repository. Erfahren Sie, wie Git for Beancount funktioniert
Häufig gestellte Fragen
Was 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 das Ledger aus, auf das Sie Zugriff gewähren möchten. Der Client speichert und aktualisiert Anmeldedaten von dort automatisch.
Was kann die KI tatsächlich mit meinem Ledger tun?
Der Server stellt vier Tools bereit: runBqlQuery führt Beancount Query Language-Abfragen aus, listLedgerFiles durchsucht Ihr Ledger-Repository, readLedgerFiles liest Ihre Ledger-Dokumente und editLedgerFiles erstellt, aktualisiert oder löscht Dateien in einem atomaren Git-Commit. Die KI kombiniert sie, um Fragen zu beantworten und Änderungen vorzuschlagen.
Kann die KI mein Ledger ohne mein Wissen ändern?
Änderungen laufen über das Tool editLedgerFiles, das gut erzogene MCP-Clients Ihnen vor der Ausführung anzeigen. Ein dry_run-Modus zeigt die genauen Änderungen ohne Schreiben vorab an, und jede übernommene Änderung ist ein echter Git-Commit – eine vollständige Prüfspur, die Sie mit Standard-Git-Tools zurücksetzen können.
Werden meine Daten an Dritte gesendet?
Ihre Ledger-Daten fließen durch das Web Beancount-Backend, das bereits Ihr Ledger verwaltet, und kehren als strukturierte Ergebnisse zu Ihrem KI-Client zurück. Sitzungen sind auf Ledger-Ebene begrenzt: Jede kann genau auf das Ledger zugreifen, das Sie autorisiert haben, und der MCP-Server speichert nichts über das hinaus, was die Konversation Ihres KI-Clients enthält.
Neugierig, wie es aufgebaut ist? Lesen Sie das technische FAQ im Blog
Ihre Buchhaltungsdaten treffen auf Ihren KI-Workflow
Der Beancount MCP-Server ist heute für alle Web Beancount-Nutzer verfügbar. Ihr Ledger ist nur einen Git-Push entfernt.