runBqlQuery
Voer BQL (Beancount Query Language)-query's uit op saldi, transacties en rekeningen.
Model Context Protocol
Je grootboek praat mee.
Verbind Beancount met de AI-tools die je al gebruikt. Stel vragen over je financiën, werk met je grootboekbestanden en volg elke wijziging in Git.
Vraag het gewoon
Begin met een vraag. Volg het antwoord terug naar je grootboek.
Achter het antwoord
runBqlQuerySELECT sum(position) WHERE account ~ 'Assets|Liabilities'Beancount
Werkt met je MCP-compatibele client
- Claude Code
- Claude Desktop
- Cursor
- Windsurf
- Zed
Verbind de client die je al gebruikt
Kies je client, voeg de server toe en autoriseer één grootboek.
Claude Code
Voer dit ene commando uit in je terminal.
Open Claude Code en voer /mcp uit om te authenticeren. Log in op Web Beancount en kies je grootboek.
Keur eenmalig goed. Credentials worden vanaf hier automatisch vernieuwd.
Terminal
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/mcpGebruik je Web Beancount-account om toegang tot één grootboek te autoriseren.
Heb je geen Web Beancount-account? Meld je aan op beancount.io — je ledger is slechts een git push verwijderd.
Wat de AI kan doen
De server biedt gerichte tools aan voor uw ledger, uw API-sleutels en uw bankverbindingen — de ledgerwerkwoorden worden hieronder weergegeven. De AI stelt ze samen: ontdek uw bestandsstructuur, lees voor context, voer query's uit voor antwoorden, stel een bewerking voor.
Ledger-, API-sleutel- en banktools. Uw client bepaalt hoe ze worden gebruikt.
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.
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.
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.
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.
Stateloze server
De MCP-server bewaart geen sessietoestand tussen toolaanroepen. Je gekozen AI-client en model ontvangen de resultaten die je aanvraagt; controleer hun gegevensbeleid voordat je verbinding maakt.
Uw hele grootboek is al een git-repository.
Bekijk hoe Git for Beancount werktVeelgestelde vragen
Wat je moet weten voordat je verbinding maakt.
Benieuwd hoe het is gebouwd?
Lees de engineering-FAQ op de blogWat 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 biedt gerichte toolfamilies aan — het machine-leesbare ontdekkingsmanifest onder beancount.io/.well-known/ vermeldt de huidige set. Ledgertools voeren Beancount Query Language-query's uit (runBqlQuery), doorzoeken de repository (listLedgerFiles), lezen ledgerdocumenten (readLedgerFiles) en maken, bijwerken of verwijderen bestanden in een atomische git-commit (editLedgerFiles, met een dry_run-previewmodus). Verdere tools beheren API-sleutels (list, mint, revoke — minting vereist een betaald abonnement en een OAuth-grant, geen API-sleutel) en bankverbindingen en importen (stage, submit of discard transacties; een gloednieuwe bank wordt gekoppeld in de browser, niet via MCP). 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 verlopen via de editLedgerFiles-tool. Een dry_run-modus toont een voorbeeld van de geplande bestandsbewerkingen zonder iets door te voeren, en of uw client vraagt voordat een echte commit wordt uitgevoerd, hangt af van de client. Elke doorgevoerde wijziging landt als een echte git-commit — een volledig audittrail die u kunt terugdraaien met standaard git-tools. Het commit-pad kan validatiefouten rapporteren na het schrijven, dus bekijk eerst het voorbeeld en verifieer daarna de ledger.
Wordt mijn gegevens naar een derde partij gestuurd?
Je grootboekgegevens passeren de Web Beancount-backend en keren terug als toolresultaten naar je AI-client. Het AI-model dat je kiest ontvangt die resultaten, dus het gegevensbeleid van de provider is ook van toepassing. Elke geautoriseerde sessie is beperkt tot één grootboek.
Breng je grootboek in je volgende gesprek.
De Beancount MCP-server is vandaag beschikbaar voor alle Web Beancount-gebruikers. Uw grootboek is één git push verwijderd.