Model Context Protocol
Parla amb el teu llibre de comptes des de les eines d'IA que ja fas servir
El servidor MCP de Beancount connecta el teu llibre de comptes de text net a Claude Code, Claude Desktop, Cursor, Windsurf, Zed: qualsevol client d'IA compatible amb MCP. Sense copiar i enganxar. Sense exportacions. Només pregunta.
URL del servidor MCP
https://beancount.io/api-gateway/mcp> Quin és el meu patrimoni net avui?
⏺ runBqlQuery("SELECT sum(position) WHERE account ~ 'Assets|Liabilities'")
El teu patrimoni net avui és de 128,450.32 USD.
> Afegeix el sopar d'equip d'ahir de 42 USD i confirma'l
⏺ editLedgerFiles(dry_run: true) → +1 transaction
⏺ git commit a1b4f2e — "AI edit: add team dinner transaction"
Fet: confirmat al teu llibre de comptes amb un registre d'auditoria complet.
Només pregunta
Respondre "quant vaig gastar en viatges l'últim trimestre?" solia significar conèixer la sintaxi BQL, trobar els fitxers correctes i copiar els resultats en un xat. Ara és una frase.
“Quin és el meu patrimoni net avui?”
Una resposta en directe extreta del teu llibre de comptes real, no una suposició.
“Resumeix les despeses del mes passat”
La IA escriu la consulta BQL per tu i llegeix els resultats.
“Afegeix una transacció i confirma-la a git”
Una confirmació real al repositori del teu llibre de comptes, reversible com qualsevol altra.
“Què hi ha al meu repositori del llibre de comptes?”
Navega i llegeix els teus fitxers .beancount sense sortir del teu editor.
Què pot fer la IA
El servidor exposa quatre eines del llibre de comptes. La IA les compon: descobreix la teva estructura de fitxers, llegeix per context, consulta per obtenir respostes, proposa una edició.
runBqlQuery
Executa consultes BQL (Beancount Query Language) sobre saldos, transaccions i comptes.
listLedgerFiles
Navega per l'estructura de directoris del teu repositori de llibres de comptes.
readLedgerFiles
Llegeix el contingut dels teus fitxers .beancount i altres documents del llibre de comptes.
editLedgerFiles
Crea, actualitza, substitueix o elimina fitxers en un commit git atòmic.
Connecta't en menys d'un minut
Tria el teu client d'IA. Copia. Enganxa. Pregunta.
- Executa aquesta ordre al teu terminal.
- Claude Code obre una finestra del navegador: inicia sessió i tria quin llibre de comptes connectar.
- Aprova una vegada. Les credencials es refresquen automàticament des d'aquí.
claude mcp add --transport http beancount https://beancount.io/api-gateway/mcpTens més d'un llibre de comptes? Afegeix el servidor de nou amb un altre nom i autoritza l'altre llibre en el seu propi prompt:
claude mcp add --transport http beancount-business https://beancount.io/api-gateway/mcpNo tens un compte Web Beancount? Registra't a beancount.io — el teu llibre de comptes és a un git push de distància.
El teu llibre de comptes, protegit
Una IA amb accés d'escriptura als teus llibres guanya confiança mitjançant el disseny, no promeses.
OAuth 2.1 limitat al llibre de comptes
Una sessió està autoritzada per a exactament un llibre de comptes. Una sessió per al teu llibre personal no pot tocar el teu llibre de negoci: radi d'explosió, limitat.
Cada edició és un commit git
Els canvis es registren com a commits reals ("AI edit: …") al repositori del vostre llibre major — una traça d'auditoria completa que podeu revisar i revertir amb les eines estàndard de git.
Vistes prèvies en mode de prova
editLedgerFiles admet un mode dry_run que valida i previsualitza els canvis exactes sense escriure res, de manera que el vostre client us pot mostrar un diff primer.
Servidor sense estat
El servidor MCP no emmagatzema res més enllà del que ja conté la conversa del vostre client d'IA. El vostre llibre major es manté on viu avui.
Tot el vostre llibre major ja és un repositori git. Vegeu com funciona Git per a Beancount
Preguntes freqüents
Què és MCP i per què és important per a Beancount?
MCP (Model Context Protocol) és un estàndard obert que permet als assistents d'IA cridar eines externes i fonts de dades de manera estructurada i segura. En lloc de suposar o demanar-vos que enganxeu dades, el vostre client d'IA es connecta directament al vostre llibre major — consulta les vostres dades reals, llegeix els vostres fitxers reals i fa edicions precises.
Quins clients d'IA funcionen amb el servidor MCP de Beancount?
Qualsevol client compatible amb MCP que admeti OAuth 2.1 funciona directament, incloent Claude Code, Claude Desktop, Cursor, Windsurf i Zed. Els clients sense suport OAuth 2.1 es poden connectar amb un token estàtic generat a la configuració del vostre compte de beancount.io.
Com connecto el meu llibre major?
Afegiu l'URL del servidor a la configuració MCP del vostre client. Al primer ús, el client obre una finestra del navegador — inicieu sessió amb el vostre compte de Web Beancount i trieu el llibre major al qual voleu concedir accés. El client emmagatzema i actualitza les credencials automàticament des d'allà.
Què pot fer realment la IA amb el meu llibre major?
El servidor exposa quatre eines: runBqlQuery executa consultes de Beancount Query Language, listLedgerFiles navega pel vostre repositori de llibre major, readLedgerFiles llegeix els vostres documents de llibre major, i editLedgerFiles crea, actualitza o elimina fitxers en un commit git atòmic. La IA les combina per respondre preguntes i proposar edicions.
Pot la IA modificar el meu llibre major sense que jo ho sàpiga?
Les edicions passen per l'eina editLedgerFiles, que els clients MCP ben comportats us mostren abans d'executar. Un mode dry_run previsualitza els canvis exactes sense escriure res, i cada canvi comès és un commit git real — una traça d'auditoria completa que podeu revertir amb les eines estàndard de git.
Es envien les meves dades a un tercer?
Les dades del vostre llibre major flueixen a través del backend de Web Beancount, que ja gestiona el vostre llibre major, i tornen com a resultats estructurats al vostre client d'IA. Les sessions estan limitades al llibre major: cadascuna pot accedir exactament al llibre major que heu autoritzat, i el servidor MCP no emmagatzema res més enllà del que ja conté la conversa del vostre client d'IA.
Esteu curiosos sobre com es construeix? Llegiu les FAQ d'enginyeria al blog
Les vostres dades de comptabilitat es troben amb el vostre flux de treball d'IA
El servidor MCP de Beancount està disponible avui per a tots els usuaris de Web Beancount. El vostre llibre major és a un git push de distància.