Model Context Protocol
Praat met je grootboek via de AI-tools die je al gebruikt
De Beancount MCP-server verbindt je plain-text grootboek met Claude Code, Claude Desktop, Cursor, Windsurf, Zed — elke MCP-compatibele AI-client. Geen kopiëren en plakken. Geen exportbestanden. Vraag het gewoon.
MCP-server-URL
https://beancount.io/api-gateway/mcp> Wat is mijn vermogen vandaag?
⏺ runBqlQuery("SELECT sum(position) WHERE account ~ 'Assets|Liabilities'")
Je vermogen vandaag is 128,450.32 USD.
> Voeg het teamdiner van gisteren van 42 USD toe en leg het vast
⏺ editLedgerFiles(dry_run: true) → +1 transaction
⏺ git commit a1b4f2e — "AI edit: add team dinner transaction"
Klaar — vastgelegd in je grootboek met een volledig audittrail.
Vraag het gewoon
Antwoorden op 'hoeveel heb ik vorig kwartaal aan reizen uitgegeven?' betekende vroeger dat je BQL-syntax kende, de juiste bestanden vond en resultaten in een chat kopieerde. Nu is het één zin.
“Wat is mijn vermogen vandaag?”
Een direct antwoord uit je eigen grootboek — geen gok.
“Vat de uitgaven van vorige maand samen”
De AI schrijft de BQL-query voor je en leest de resultaten voor.
“Voeg een transactie toe en leg hem vast in git”
Een echte commit in de repository van je grootboek, net zo eenvoudig terug te draaien als elke andere.
“Wat zit er in mijn grootboek-repository?”
Blader door en lees je .beancount-bestanden zonder je editor te verlaten.
Wat de AI kan doen
De server stelt vier grootboektools beschikbaar. De AI stelt ze samen: ontdek je bestandsstructuur, lees voor context, query voor antwoorden, stel een bewerking voor.
runBqlQuery
Voer BQL (Beancount Query Language)-query's uit op saldi, transacties en rekeningen.
listLedgerFiles
Blader door de mappenstructuur van je ledger-repository.
readLedgerFiles
Lees de inhoud van je .beancount-bestanden en andere ledger-documenten.
editLedgerFiles
Maak, werk bij, vervang of verwijder bestanden in een atomische git-commit.
Binnen een minuut verbonden
Kies je AI-client. Kopieer. Plak. Vraag.
- Voer dit ene commando uit in je terminal.
- Claude Code opent een browservenster — log in en kies welke ledger je wilt verbinden.
- Keur eenmalig goed. Credentials worden vanaf hier automatisch vernieuwd.
claude mcp add --transport http beancount https://beancount.io/api-gateway/mcpMeer dan één ledger? Voeg de server opnieuw toe onder een andere naam en autoriseer de andere ledger in het eigen venster:
claude mcp add --transport http beancount-business https://beancount.io/api-gateway/mcpHeb je geen Web Beancount-account? Meld je aan op beancount.io — je ledger is slechts een git push verwijderd.
Je ledger, beveiligd
Een AI met schrijftoegang tot je boeken verdient vertrouwen door ontwerp, niet door beloften.
Ledger-specifieke OAuth 2.1
Eén sessie is geautoriseerd voor precies één ledger. Een sessie voor je persoonlijke ledger kan je zakelijke ledger niet aanraken — beperkte impact.
Elke bewerking is een git-commit
Wijzigingen worden vastgelegd als echte commits ("AI edit: …") in de repository van uw grootboek — een volledig audittrail dat u kunt bekijken en terugdraaien met standaard git-tools.
Dry-run-preview
editLedgerFiles ondersteunt een dry_run-modus die de exacte wijzigingen valideert en een voorbeeld toont zonder iets te schrijven, zodat uw client eerst een diff kan tonen.
Stateloze server
De MCP-server slaat niets op buiten wat het gesprek van uw AI-client al bevat. Uw grootboek blijft waar het nu staat.
Uw hele grootboek is al een git-repository. Bekijk hoe Git for Beancount werkt
Veelgestelde vragen
Wat is MCP en waarom is het belangrijk voor Beancount?
MCP (Model Context Protocol) is een open standaard waarmee AI-assistenten op een gestructureerde en veilige manier externe tools en gegevensbronnen kunnen aanroepen. In plaats van te raden of u te vragen gegevens te plakken, verbindt uw AI-client zich rechtstreeks met uw grootboek — het doorzoekt uw echte gegevens, leest uw werkelijke bestanden en maakt nauwkeurige bewerkingen.
Welke AI-clients werken met de Beancount MCP-server?
Elke MCP-compatibele client die OAuth 2.1 ondersteunt, werkt direct uit de doos, inclusief Claude Code, Claude Desktop, Cursor, Windsurf en Zed. Clients zonder OAuth 2.1-ondersteuning kunnen verbinding maken met een statisch token dat wordt gegenereerd in uw beancount.io-accountinstellingen.
Hoe verbind ik mijn grootboek?
Voeg de server-URL toe aan de MCP-configuratie van uw client. Bij het eerste gebruik opent de client een browservenster — log in met uw Web Beancount-account en kies het grootboek waartoe u toegang wilt verlenen. De client slaat referenties automatisch op en vernieuwt ze vanaf dat moment.
Wat kan de AI daadwerkelijk met mijn grootboek doen?
De server stelt vier tools beschikbaar: runBqlQuery voert Beancount Query Language-query's uit, listLedgerFiles bladert door uw grootboekrepository, readLedgerFiles leest uw grootboekdocumenten, en editLedgerFiles maakt, werkt bij of verwijdert bestanden in een atomische git-commit. De AI combineert ze om vragen te beantwoorden en bewerkingen voor te stellen.
Kan de AI mijn grootboek wijzigen zonder dat ik het weet?
Bewerkingen gaan via de editLedgerFiles-tool, die goed functionerende MCP-clients aan u tonen vóór uitvoering. Een dry_run-modus toont de exacte wijzigingen zonder iets te schrijven, en elke vastgelegde wijziging is een echte git-commit — een volledig audittrail dat u kunt terugdraaien met standaard git-tools.
Wordt mijn gegevens naar een derde partij gestuurd?
Uw grootboekgegevens stromen via de Web Beancount-backend, die uw grootboek al beheert, en keren terug als gestructureerde resultaten naar uw AI-client. Sessies zijn grootboekgericht: elke sessie heeft toegang tot precies het grootboek dat u hebt geautoriseerd, en de MCP-server slaat niets op buiten wat het gesprek van uw AI-client bevat.
Benieuwd hoe het is gebouwd? Lees de engineering-FAQ op de blog
Uw boekhoudgegevens ontmoeten uw AI-workflow
De Beancount MCP-server is vandaag beschikbaar voor alle Web Beancount-gebruikers. Uw grootboek is één git push verwijderd.