Model Context Protocol
Parla con il tuo registro dagli strumenti AI che già usi
Il server MCP di Beancount collega il tuo registro in testo semplice a Claude Code, Claude Desktop, Cursor, Windsurf, Zed — qualsiasi client AI compatibile con MCP. Niente copia-incolla. Niente esportazioni. Basta chiedere.
URL del server MCP
https://beancount.io/api-gateway/mcp> Qual è il mio patrimonio netto oggi?
⏺ runBqlQuery("SELECT sum(position) WHERE account ~ 'Assets|Liabilities'")
Il tuo patrimonio netto oggi è 128,450.32 USD.
> Aggiungi la cena di ieri da 42 USD e committala
⏺ editLedgerFiles(dry_run: true) → +1 transaction
⏺ git commit a1b4f2e — "AI edit: add team dinner transaction"
Fatto — committato nel tuo registro con una traccia di audit completa.
Basta chiedere
Rispondere a "quanto ho speso in viaggi nell'ultimo trimestre?" significava conoscere la sintassi BQL, trovare i file giusti e copiare i risultati in una chat. Ora è una frase.
“Qual è il mio patrimonio netto oggi?”
Una risposta in tempo reale basata sulla tua contabilità effettiva — non una stima.
“Riassumi le spese del mese scorso”
L'IA scrive la query BQL per te e ti rilegge i risultati.
“Aggiungi una transazione e committala su git”
Un commit reale nel repository della tua contabilità, reversibile come qualsiasi altro.
“Cosa c'è nel mio repository contabile?”
Sfoglia e leggi i tuoi file .beancount senza uscire dal tuo editor.
Cosa può fare l'IA
Il server espone quattro strumenti di contabilità. L'IA li compone: scopri la struttura dei file, leggi per contesto, interroga per risposte, proponi una modifica.
runBqlQuery
Esegui query BQL (Beancount Query Language) su saldi, transazioni e conti.
listLedgerFiles
Sfoglia la struttura delle directory del tuo repository contabile.
readLedgerFiles
Leggi il contenuto dei tuoi file .beancount e di altri documenti contabili.
editLedgerFiles
Crea, aggiorna, sostituisci o elimina file in un commit git atomico.
Connessione in meno di un minuto
Scegli il tuo client AI. Copia. Incolla. Chiedi.
- Esegui questo comando nel tuo terminale.
- Claude Code aprirà una finestra del browser: accedi e scegli quale ledger connettere.
- Approva una volta. Le credenziali si aggiornano automaticamente da qui.
claude mcp add --transport http beancount https://beancount.io/api-gateway/mcpHai più di un ledger? Aggiungi di nuovo il server con un nome diverso e autorizza l'altro ledger nel suo prompt:
claude mcp add --transport http beancount-business https://beancount.io/api-gateway/mcpNon hai un account Web Beancount? Registrati su beancount.io — il tuo ledger è a un solo git push di distanza.
La tua contabilità, protetta
Un'IA con accesso in scrittura ai tuoi libri guadagna fiducia attraverso il design, non con le promesse.
OAuth 2.1 con ambito limitato alla contabilità
Una sessione è autorizzata per esattamente un libro contabile. Una sessione per il tuo libro personale non può toccare il tuo libro aziendale — raggio d'azione, limitato.
Ogni modifica è un commit git
Le modifiche vengono applicate come commit reali ("AI edit: …") nel repository del tuo libro contabile — una traccia di audit completa che puoi rivedere e annullare con gli strumenti git standard.
Anteprime dry-run
editLedgerFiles supporta una modalità dry_run che valida e anteprime le modifiche esatte senza scrivere nulla, così il tuo client può mostrarti prima una diff.
Server senza stato
Il server MCP non memorizza nulla oltre a ciò che la conversazione del tuo client IA già contiene. Il tuo libro contabile rimane dove vive oggi.
L'intero tuo libro contabile è già un repository git. Scopri come funziona Git per Beancount
Domande frequenti
Cos'è MCP e perché è importante per Beancount?
MCP (Model Context Protocol) è uno standard aperto che permette agli assistenti IA di chiamare strumenti esterni e fonti di dati in modo strutturato e sicuro. Invece di indovinare o chiederti di incollare dati, il tuo client IA si collega direttamente al tuo libro contabile — interroga i tuoi dati reali, legge i tuoi file effettivi e apporta modifiche precise.
Quali client IA funzionano con il server MCP di Beancount?
Qualsiasi client compatibile con MCP che supporti OAuth 2.1 funziona immediatamente, inclusi Claude Code, Claude Desktop, Cursor, Windsurf e Zed. I client senza supporto OAuth 2.1 possono connettersi con un token statico generato nelle impostazioni dell'account beancount.io.
Come collego la mia contabilità?
Aggiungi l'URL del server alla configurazione MCP del tuo client. Al primo utilizzo, il client apre una finestra del browser: accedi con il tuo account Web Beancount e scegli il registro a cui desideri concedere l'accesso. Il client salva e aggiorna automaticamente le credenziali da quel momento.
Cosa può fare realmente l'AI con la mia contabilità?
Il server espone quattro strumenti: runBqlQuery esegue query di Beancount Query Language, listLedgerFiles esplora il tuo repository di contabilità, readLedgerFiles legge i tuoi documenti contabili, ed editLedgerFiles crea, aggiorna o elimina file in un commit git atomico. L'AI li combina per rispondere a domande e proporre modifiche.
L'AI può modificare la mia contabilità a mia insaputa?
Le modifiche passano attraverso lo strumento editLedgerFiles, che i client MCP ben comportati ti mostrano prima di eseguirle. Una modalità dry_run mostra le modifiche esatte senza scrivere nulla, e ogni modifica committata è un vero commit git: una traccia di audit completa che puoi annullare con gli strumenti git standard.
I miei dati vengono inviati a terze parti?
I dati della tua contabilità fluiscono attraverso il backend Web Beancount, che già gestisce la tua contabilità, e tornano come risultati strutturati al tuo client AI. Le sessioni sono limitate al registro: ciascuna può accedere esattamente al registro che hai autorizzato, e il server MCP non salva nulla oltre a quanto contenuto nella conversazione del tuo client AI.
Curioso di sapere come è costruito? Leggi le FAQ tecniche sul blog
I tuoi dati contabili incontrano il tuo flusso di lavoro AI
Il server MCP Beancount è disponibile oggi per tutti gli utenti Web Beancount. La tua contabilità è a un solo git push di distanza.