Ihr Hauptbuch wird Teil des Gesprächs.

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.

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.

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.

Der Server stellt fokussierte Tool-Familien bereit – das maschinenlesbare Discovery-Manifest unter beancount.io/.well-known/ listet den aktuellen Satz auf. Ledger-Tools führen Beancount Query Language-Abfragen aus (runBqlQuery), durchsuchen das Repository (listLedgerFiles), lesen Ledger-Dokumente (readLedgerFiles) und erstellen, aktualisieren oder löschen Dateien in einem atomaren Git-Commit (editLedgerFiles, mit einem dry_run-Vorschaumodus). Weitere Tools verwalten API-Schlüssel (list, mint, revoke – Minting erfordert einen kostenpflichtigen Plan und eine OAuth-Genehmigung, keinen API-Schlüssel) sowie Bankverbindungen und Importe (Transaktionen stufen, einreichen oder verwerfen; eine brandneue Bank wird im Browser verknüpft, nicht über MCP). Die KI kombiniert sie, um Fragen zu beantworten und Änderungen vorzuschlagen.

Bearbeitungen erfolgen über das editLedgerFiles-Tool. Ein dry_run-Modus zeigt eine Vorschau der geplanten Dateioperationen, ohne etwas zu committen, und ob Ihr Client vor einem echten Commit fragt, hängt vom Client ab. Jede committete Änderung landet als echter Git-Commit – ein vollständiges Audit-Trail, das Sie mit Standard-Git-Tools zurücksetzen können. Der Commit-Pfad kann nach dem Schreiben Validierungsfehler melden, also zuerst Vorschau anzeigen und danach das Ledger verifizieren.

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.