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 una vegada i autoritza els llibres als quals pot accedir.
Claude Code
Executa aquesta ordre al teu terminal.
Obre Claude Code i executa /mcp per autenticar-te. Inicia sessió a Web Beancount i aprova un llibre o tots.
Aprova una vegada. Les credencials es refresquen automàticament des d'aquí.
Terminal
claude mcp add --transport http beancount https://beancount.io/api-gateway/mcpMés d'un llibre? Aprova'ls tots d'una vegada. L'assistent crida listLedgers per veure-hi a què pot accedir i anomena el llibre a cada crida, així que un sol servidor cobreix tots els llibres.
Utilitza el teu compte de Web Beancount per autoritzar a quins llibres pot accedir el servidor.
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 ofereix eines específiques per al vostre llibre i les vostres connexions bancàries — a continuació es mostren els verbs del llibre. La IA les combina: descobrir l’estructura dels fitxers, llegir el context, consultar respostes, proposar una edició.
Eines de llibre i 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.
updateLedgerFiles
Canvia fitxers en un commit de git atòmic, amb vista prèvia dry_run; createLedgerFiles i deleteLedgerFiles els afegeixen i els eliminen.
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 amb abast limitat
Tu tries a què pot accedir una connexió: a un sol llibre o a tots. Autoritza només el teu llibre personal i la connexió no podrà tocar els teus llibres de negoci: tu estableixes l'abast de l'impacte.
Vistes prèvies en mode de prova
Les eines de fitxers (createLedgerFiles, updateLedgerFiles, deleteLedgerFiles) i appendLedgerText admeten un mode dry_run que valida i previsualitza els canvis exactes sense escriure res, perquè el vostre client us pugui mostrar primer un diff.
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 preguntes freqüents 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?
Afegeix l'URL del servidor a la configuració MCP del teu client. Al primer ús, el client obre una finestra del navegador: inicia sessió amb el teu compte de Web Beancount i tria si pot accedir a un sol llibre o a tots. El client emmagatzema i renova les credencials automàticament a partir d'aquí.
Què pot fer realment la IA amb el meu llibre major?
El servidor ofereix una eina per operació — el manifest de descoberta llegible per màquina a beancount.io/.well-known/ en llista el conjunt actual. Les eines de llibre executen consultes de Beancount Query Language (runBqlQuery), exploren el repositori (listLedgerFiles), llegeixen documents del llibre (readLedgerFiles), afegeixen directives per ordre de data (appendLedgerText) i creen, canvien o eliminen fitxers en un commit de git atòmic (createLedgerFiles, updateLedgerFiles, deleteLedgerFiles, cadascuna amb un mode de vista prèvia dry_run). Les eines bancàries obtenen, importen o descarten transaccions pendents i gestionen les connexions vinculades; un banc nou es vincula al navegador, no per MCP. Les claus d’API i la configuració del compte es queden a l’aplicació web de Beancount.io. La IA combina les eines per respondre preguntes i proposar edicions.
Pot la IA modificar el meu llibre major sense que jo ho sàpiga?
Les directives noves passen per appendLedgerText, i els canvis de fitxers per les eines de fitxers: createLedgerFiles, updateLedgerFiles, deleteLedgerFiles. Un mode dry_run previsualitza els canvis previstos sense confirmar res, i si el vostre client pregunta abans d’un commit real depèn del client. Cada canvi confirmat esdevé un commit de git real — un registre d’auditoria complet que podeu revertir amb les eines estàndard de git. El procés de commit pot informar d’errors de validació després d’escriure, 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.