Il tuo libro mastro entra nella conversazione.

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.

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.

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.

Il server espone famiglie di strumenti mirate — il manifest di scoperta leggibile da macchina sotto beancount.io/.well-known/ elenca l'insieme attuale. Gli strumenti per la contabilità eseguono query in Beancount Query Language (runBqlQuery), esplorano il repository (listLedgerFiles), leggono documenti di contabilità (readLedgerFiles) e creano, aggiornano o eliminano file in un commit git atomico (editLedgerFiles, con modalità di anteprima dry_run). Ulteriori strumenti gestiscono chiavi API (lista, emissione, revoca — l'emissione richiede un piano a pagamento e una concessione OAuth, non una chiave API) e connessioni bancarie e importazioni (prepara, invia o scarta transazioni; una banca nuova viene collegata nel browser, non tramite MCP). L'AI li combina per rispondere a domande e proporre modifiche.

Le modifiche passano attraverso lo strumento editLedgerFiles. Una modalità dry_run mostra in anteprima le operazioni sui file pianificate senza impegnare nulla, e se il tuo client chiede conferma prima di un commit reale dipende dal client. Ogni modifica impegnata arriva come un vero commit git — una traccia di audit completa che puoi annullare con strumenti git standard. Il percorso di commit può segnalare errori di validazione dopo la scrittura, quindi fai un'anteprima prima e verifica la contabilità successivamente.

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.