Salta al contenuto principale
Beancount.io Logo

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.

Connetti il tuo client AILeggi l'annuncio

Basta chiedere

Inizia con una domanda. Segui la risposta fino al tuo libro mastro.

Dati di esempio, non una connessione live.
Tu

Qual è il mio patrimonio netto oggi?

Il tuo assistente AI

Il tuo patrimonio netto oggi è 128,450.32 USD.

Consulta i saldi del libro mastro, poi verifica i risultati su cui si basa la risposta.
Dietro la risposta
runBqlQuery
SELECT sum(position) WHERE account ~ 'Assets|Liabilities'
Beancount
Una conversazione di esempio con MCP

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 e autorizza un libro mastro.

Claude Code

  1. Esegui questo comando nel tuo terminale.

  2. Apri Claude Code ed esegui /mcp per autenticarti. Accedi a Web Beancount e scegli il tuo libro mastro.

  3. Approva una volta. Le credenziali si aggiornano automaticamente da qui.

Documentazione di configurazione del client
Terminale
claude mcp add --transport http beancount https://beancount.io/api-gateway/mcp

Hai 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/mcp

Usa il tuo account Web Beancount per autorizzare l'accesso a un singolo libro mastro.

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.

Quattro strumenti mirati. Il tuo client decide come usarli.

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.

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.

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.

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 Beancount

Domande frequenti

Cosa sapere prima di connetterti.

Curioso di sapere come è costruito?

Leggi le FAQ tecniche sul blog
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 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.

Inizia gratisConnetti il tuo client