runBqlQuery
Esegui query BQL (Beancount Query Language) su saldi, transazioni e conti.
Model Context Protocol
Il tuo libro mastro entra nella conversazione.
Collega Beancount agli strumenti AI che già usi. Fai domande sulle tue finanze, lavora sui file del libro mastro e ritrova ogni modifica in Git.
Basta chiedere
Inizia con una domanda. Segui la risposta fino al tuo libro mastro.
Dietro la risposta
runBqlQuerySELECT sum(position) WHERE account ~ 'Assets|Liabilities'Beancount
Funziona con il tuo client compatibile con MCP
- Claude Code
- Claude Desktop
- Cursor
- Windsurf
- Zed
Connetti il client che già utilizzi
Scegli il tuo client, aggiungi il server una volta e autorizza i registri a cui può accedere.
Claude Code
Esegui questo comando nel tuo terminale.
Apri Claude Code ed esegui /mcp per autenticarti. Accedi a Web Beancount e approva un registro o tutti.
Approva una volta. Le credenziali si aggiornano automaticamente da qui.
Terminale
claude mcp add --transport http beancount https://beancount.io/api-gateway/mcpPiù di un registro? Approvali tutti in una sola volta. L'assistente chiama listLedgers per vedere a cosa può accedere e indica il registro a ogni chiamata, così un unico server copre tutti i libri contabili.
Usa il tuo account Web Beancount per autorizzare i registri a cui il server può accedere.
Non hai un account Web Beancount? Registrati su beancount.io — il tuo ledger è a un solo git push di distanza.
Cosa può fare l'IA
Il server espone strumenti mirati per la tua contabilità e le tue connessioni bancarie: i verbi della contabilità sono mostrati qui sotto. L’IA li combina: scoprire la struttura dei file, leggere il contesto, interrogare per ottenere risposte, proporre una modifica.
Strumenti per contabilità e banche. Il tuo client decide come usarli.
listLedgerFiles
Sfoglia la struttura delle directory del tuo repository contabile.
readLedgerFiles
Leggi il contenuto dei tuoi file .beancount e di altri documenti contabili.
updateLedgerFiles
Modifica file in un commit git atomico, con anteprima dry_run; createLedgerFiles e deleteLedgerFiles li aggiungono e li rimuovono.
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 ambiti
Scegli tu cosa può raggiungere una connessione: un singolo registro o tutti. Autorizza solo il tuo registro personale e la connessione non potrà toccare i tuoi libri contabili aziendali — sei tu a definire il raggio d'azione.
Anteprime dry-run
Gli strumenti per i file (createLedgerFiles, updateLedgerFiles, deleteLedgerFiles) e appendLedgerText supportano una modalità dry_run che convalida e mostra in anteprima le modifiche esatte senza scrivere nulla, così il tuo client può mostrarti prima un diff.
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.
Server senza stato
Il server MCP non conserva lo stato della sessione tra le chiamate agli strumenti. Il tuo client AI e il modello scelti ricevono i risultati che richiedi; controlla le loro politiche sui dati prima di connetterti.
L'intero tuo libro contabile è già un repository git.
Scopri come funziona Git per BeancountDomande frequenti
Cosa sapere prima di connetterti.
Curioso di sapere come è costruito?
Leggi le FAQ tecniche sul blogCos'è 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 se può accedere a un singolo registro o a tutti. Da lì in poi il client memorizza e aggiorna le credenziali automaticamente.
Cosa può fare realmente l'AI con la mia contabilità?
Il server espone uno strumento per ogni operazione: il manifest di discovery leggibile dalle macchine in beancount.io/.well-known/ elenca l’insieme attuale. Gli strumenti di contabilità eseguono query in Beancount Query Language (runBqlQuery), esplorano il repository (listLedgerFiles), leggono i documenti contabili (readLedgerFiles), aggiungono direttive in ordine di data (appendLedgerText) e creano, modificano o eliminano file in un commit git atomico (createLedgerFiles, updateLedgerFiles, deleteLedgerFiles, ciascuno con una modalità di anteprima dry_run). Gli strumenti bancari scaricano, importano o scartano le transazioni in attesa e gestiscono le connessioni collegate; una banca nuova si collega nel browser, non tramite MCP. Le chiavi API e le impostazioni dell’account restano nell’app web di Beancount.io. L’IA combina gli strumenti per rispondere alle domande e proporre modifiche.
L'AI può modificare la mia contabilità a mia insaputa?
Le nuove direttive passano da appendLedgerText, le modifiche ai file dagli strumenti per i file: createLedgerFiles, updateLedgerFiles, deleteLedgerFiles. Una modalità dry_run mostra in anteprima le modifiche previste senza confermare nulla, e se il tuo client chiede conferma prima di un commit reale dipende dal client. Ogni modifica confermata diventa un vero commit git: una traccia di audit completa che puoi annullare con gli strumenti git standard. Il percorso di commit può segnalare errori di validazione dopo la scrittura, quindi guarda prima l’anteprima e verifica la contabilità dopo.
I miei dati vengono inviati a terze parti?
I dati del tuo libro mastro passano attraverso il backend di Web Beancount e tornano come risultati degli strumenti al tuo client AI. Il modello AI che scegli riceve questi risultati, quindi si applicano anche le politiche sui dati del suo fornitore. Ogni sessione autorizzata è limitata a un singolo libro mastro.
Porta il tuo libro mastro nella prossima conversazione.
Il server MCP Beancount è disponibile oggi per tutti gli utenti Web Beancount. La tua contabilità è a un solo git push di distanza.