runBqlQuery
Executa consultes BQL (Beancount Query Language) sobre saldos, transaccions i comptes.
Model Context Protocol
El teu llibre major entra a la conversa.
Connecta Beancount a les eines d'IA que ja fas servir. Pregunta per les teves finances, treballa amb els fitxers del llibre major i segueix cada canvi a Git.
Només pregunta
Comença amb una pregunta. Segueix la resposta fins al teu llibre major.
Darrere la resposta
runBqlQuerySELECT sum(position) WHERE account ~ 'Assets|Liabilities'Beancount
Funciona amb el teu client compatible amb MCP
- Claude Code
- Claude Desktop
- Cursor
- Windsurf
- Zed
Connecta el client que ja fas servir
Tria el teu client, afegeix el servidor i autoritza un llibre major.
Claude Code
Executa aquesta ordre al teu terminal.
Obre Claude Code i executa /mcp per autenticar-te. Inicia la sessió a Web Beancount i tria el teu llibre major.
Aprova una vegada. Les credencials es refresquen automàticament des d'aquí.
Terminal
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/mcpUtilitza el teu compte de Web Beancount per autoritzar l'accés a un sol llibre major.
No tens un compte Web Beancount? Registra't a beancount.io — el teu llibre de comptes és a un git push de distància.
Què pot fer la IA
El servidor exposa eines enfocades per al vostre llibre, les vostres claus d'API i les vostres connexions bancàries — els verbs del llibre es mostren a continuació. La IA les compon: descobreix l'estructura del vostre fitxer, llegeix per contextualitzar, consulta per obtenir respostes, proposa una edició.
Llibre, claus d'API i eines bancàries. El vostre client decideix com utilitzar-les.
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.
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.
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.
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.
Servidor sense estat
El servidor MCP no manté cap estat de sessió entre crides d'eina. El teu client d'IA i el model que triïs reben els resultats que sol·licites; consulta les seves polítiques de dades abans de connectar-te.
Tot el vostre llibre major ja és un repositori git.
Vegeu com funciona Git per a BeancountPreguntes freqüents
Què has de saber abans de connectar-te.
Esteu curiosos sobre com es construeix?
Llegiu les FAQ d'enginyeria al blogQuè é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 famílies d'eines enfocades — el manifest de descobriment llegible per màquina sota beancount.io/.well-known/ llista el conjunt actual. Les eines del llibre executen consultes del Beancount Query Language (runBqlQuery), naveguen pel repositori (listLedgerFiles), llegeixen documents del llibre (readLedgerFiles) i creen, actualitzen o suprimeixen fitxers en un commit atòmic de git (editLedgerFiles, amb un mode de previsualització dry_run). Altres eines gestionen claus d'API (llistar, encunyar, revocar — l'encunyació requereix un pla de pagament i una concessió OAuth, no una clau d'API) i connexions i imports bancaris (posar en escena, enviar o descartar transaccions; un banc nou es vincula al navegador, no mitjançant MCP). 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. Un mode dry_run previsualitza les operacions de fitxer planificades sense cometre res, i si el vostre client demana confirmació abans d'un commit real depèn del client. Cada canvi comès es materialitza com un commit real de git — una traça d'auditoria completa que podeu revertir amb les eines estàndard de git. La ruta del commit pot informar errors de validació després de l'escriptura, així que previsualitzeu primer i verifiqueu el llibre després.
Es envien les meves dades a un tercer?
Les dades del teu llibre major passen pel backend de Web Beancount i tornen com a resultats d'eina al teu client d'IA. El model d'IA que triïs rep aquests resultats, per tant també s'apliquen les polítiques de dades del seu proveïdor. Cada sessió autoritzada està limitada a un sol llibre major.
Porta el teu llibre major a la teva propera conversa.
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.