# 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.

[Connecta el teu client d'IA](https://beancount.io/ca/mcp#get-started) [Llegeix l'anunci](https://beancount.io/ca/blog/2026/06/30/beancount-mcp)

## Només pregunta

Comença amb una pregunta. Segueix la resposta fins al teu llibre major.

Dades d'exemple, no una connexió en directe.

Tu

Quin és el meu patrimoni net avui?

El teu assistent d'IA

El teu patrimoni net avui és de 128,450.32 USD.

Consulta els saldos del teu llibre major i després comprova els resultats que hi ha darrere la resposta.

Darrere la resposta

`runBqlQuery`

```
SELECT sum(position) WHERE account ~ 'Assets|Liabilities'
```

128450.32 USD

Beancount

Una conversa d'exemple amb MCP

Funciona amb el teu client compatible amb MCP

- Claude Code
- Claude Desktop
- Codex
- 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

1. Executa aquesta ordre al teu terminal.

2. Obre Claude Code i executa /mcp per autenticar-te. Inicia sessió a Web Beancount i aprova un llibre o tots.

3. Aprova una vegada. Les credencials es refresquen automàticament des d'aquí.

[Documentació de configuració del client](https://code.claude.com/docs/en/mcp)

Terminal

```
claude mcp add --transport http beancount https://beancount.io/api-gateway/mcp
```

Mé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](https://beancount.io/auth/sign-up) — 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.

### 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.

### 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 Beancount](https://beancount.io/ca/git)

## Preguntes freqüents

Què has de saber abans de connectar-te.

Esteu curiosos sobre com es construeix?

[Llegiu les preguntes freqüents d'enginyeria al blog](https://beancount.io/ca/blog/2026/06/30/beancount-mcp)

Estàs valorant altres servidors MCP de comptabilitat?

[Com es compara Beancount MCP amb QuickBooks, Xero i Expensify](https://beancount.io/ca/compare/accounting-mcp-servers)

**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?**

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 es retornen com a resultats d'eines al teu client d'IA. El model d'IA que triïs rep aquests resultats, de manera que també s'apliquen les polítiques de dades del seu proveïdor. Una connexió només arriba als llibres majors que hagis autoritzat: un sol llibre major, o tots.

## 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.

[Comenceu gratuïtament](https://beancount.io/auth/sign-up) [Connecteu el vostre client](https://beancount.io/ca/mcp#get-started)

## Where to look next

- [Sitemap](https://beancount.io/sitemap.xml) - all pages with hreflang alternates
- [LLMs index](https://beancount.io/llms.txt) - curated links for AI agents (also /llms-full.txt for full docs)
- [Documentation](https://beancount.io/docs) - every doc is also available as text/markdown via .md suffix or Accept negotiation
- [REST API reference](https://beancount.io/docs/api-reference) - interactive endpoints, schemas, authentication, and code samples
- [OpenAPI spec](https://beancount.io/openapi.json) - OpenAPI 3.1 spec for this website's public content endpoints; the product contract for ledger operations is at https://beancount.io/api-gateway/v1/openapi.json
- [GraphQL](https://beancount.io/graphql) - public, read-only content API over the blog and research logs (no credentials, no ledger data): 12 query fields over 23 types
- [MCP server](https://beancount.io/mcp) - Model Context Protocol at https://beancount.io/api-gateway/mcp
