runBqlQuery
Spúšťať dotazy BQL (Beancount Query Language) na zostatky, transakcie a účty.
Model Context Protocol
Vaša účtovná kniha vstupuje do rozhovoru.
Pripojte Beancount k AI nástrojom, ktoré už používate. Pýtajte sa na svoje financie, pracujte so súbormi účtovnej knihy a sledujte každú zmenu v Gite.
Len sa opýtajte
Začnite otázkou. Od odpovede sa dostanete až k záznamom v účtovnej knihe.
Z čoho vychádza odpoveď
runBqlQuerySELECT sum(position) WHERE account ~ 'Assets|Liabilities'Beancount
Funguje s vaším klientom kompatibilným s MCP
- Claude Code
- Claude Desktop
- Cursor
- Windsurf
- Zed
Pripojte klienta, ktorého už používate
Vyberte si klienta, pridajte server raz a autorizujte knihy, ku ktorým môže pristupovať.
Claude Code
Spustite tento jeden príkaz v termináli.
Otvorte Claude Code a spustite /mcp na overenie. Prihláste sa do Web Beancount a schváľte jednu knihu alebo všetky.
Schváľte raz. Poverenia sa odtiaľto automaticky obnovujú.
Terminál
claude mcp add --transport http beancount https://beancount.io/api-gateway/mcpMáte viac ako jednu knihu? Schváľte ich všetky naraz. Asistent volá listLedgers, aby zistil, ku čomu môže pristupovať, a pri každom volaní uvádza názov knihy, takže jeden server pokrýva všetky knihy.
Použite svoj účet Web Beancount na autorizáciu toho, ku ktorým knihám môže server pristupovať.
Nemáte Web Beancount účet? Zaregistrujte sa na beancount.io — váš ledger je len jeden git push vzdialený.
Čo môže AI robiť
Server poskytuje cielené nástroje pre váš ledger a vaše bankové pripojenia — operácie s ledgerom sú uvedené nižšie. AI ich kombinuje: preskúma štruktúru súborov, prečíta kontext, vyhľadá odpovede, navrhne úpravu.
Nástroje pre ledger a banky. Váš klient rozhoduje, ako ich používať.
listLedgerFiles
Prehliadať štruktúru adresárov vášho účtovného repozitára.
readLedgerFiles
Čítať obsah vašich .beancount súborov a ďalších účtovných dokumentov.
updateLedgerFiles
Mení súbory v atomickom git commite s náhľadom dry_run; createLedgerFiles a deleteLedgerFiles ich pridávajú a odstraňujú.
Váš ledger, strážený
AI s prístupom na zápis do vašich kníh si dôveru získava dizajnom, nie sľubmi.
Scoped OAuth 2.1
Vy si určujete, ku čomu môže pripojenie pristupovať: k jednej knihe alebo ku všetkým. Autorizujte iba svoju osobnú knihu a pripojenie sa nedostane k vašim obchodným knihám — rozsah dopadu si určujete sami.
Náhľady suchého spustenia
Nástroje pre súbory (createLedgerFiles, updateLedgerFiles, deleteLedgerFiles) a appendLedgerText podporujú režim dry_run, ktorý overí a zobrazí presné zmeny bez toho, aby čokoľvek zapísal, takže vám klient môže najprv ukázať diff.
Každá úprava je git commit
Zmeny sa ukladajú ako skutočné commity („AI edit: …“) vo vašom repozitári účtovnej knihy – plný auditný záznam, ktorý môžete skontrolovať a vrátiť pomocou štandardných git nástrojov.
Server bez stavu
Server MCP neuchováva stav relácie medzi volaniami nástrojov. Zvolený AI klient a model dostávajú požadované výsledky; pred pripojením si prečítajte ich pravidlá spracovania údajov.
Vaša celá účtovná kniha je už git repozitárom.
Pozrite si, ako funguje Git pre BeancountČasto kladené otázky
Čo treba vedieť pred pripojením.
Zaujíma vás, ako je to postavené?
Prečítajte si technické Často kladené otázky na bloguZvažujete iné účtovné MCP servery?
Ako si Beancount MCP stojí v porovnaní s QuickBooks, Xero a ExpensifyČo je MCP a prečo je dôležité pre Beancount?
MCP (Model Context Protocol) je otvorený štandard, ktorý umožňuje asistentom AI volať externé nástroje a dátové zdroje štruktúrovaným a bezpečným spôsobom. Namiesto hádania alebo požiadavky na vloženie dát sa váš klient AI pripája priamo k vašej účtovnej knihe – dotazuje sa vaše skutočné dáta, číta vaše skutočné súbory a vykonáva presné úpravy.
Ktoré AI klienti fungujú s Beancount MCP serverom?
Akýkoľvek kompatibilný klient MCP, ktorý podporuje OAuth 2.1, funguje okamžite, vrátane Claude Code, Claude Desktop, Cursor, Windsurf a Zed. Klienti bez podpory OAuth 2.1 sa môžu pripojiť so statickým tokenom vygenerovaným v nastaveniach vášho účtu beancount.io.
Ako pripojím svoju účtovnú knihu?
Pridajte URL servera do konfigurácie MCP svojho klienta. Pri prvom použití klient otvorí okno prehliadača — prihláste sa svojím účtom Web Beancount a vyberte, či môže pristupovať k jednej knihe alebo ku všetkým. Klient odtiaľto automaticky ukladá a obnovuje prihlasovacie údaje.
Čo môže AI skutočne robiť s mojou účtovnou knihou?
Server poskytuje jeden nástroj na každú operáciu — strojovo čitateľný manifest objavovania v beancount.io/.well-known/ uvádza aktuálnu sadu. Nástroje pre ledger spúšťajú dopyty v Beancount Query Language (runBqlQuery), prechádzajú repozitár (listLedgerFiles), čítajú dokumenty ledgera (readLedgerFiles), pridávajú direktívy v poradí podľa dátumu (appendLedgerText) a vytvárajú, menia alebo mažú súbory v atomickom git commite (createLedgerFiles, updateLedgerFiles, deleteLedgerFiles, každý s režimom náhľadu dry_run). Bankové nástroje sťahujú, importujú alebo zahadzujú čakajúce transakcie a spravujú prepojené pripojenia; úplne novú banku prepojíte v prehliadači, nie cez MCP. API kľúče a nastavenia účtu zostávajú vo webovej aplikácii Beancount.io. AI nástroje kombinuje, aby odpovedala na otázky a navrhovala úpravy.
Môže AI modifikovať svoju účtovnú knihu bez toho, aby som o tom vedel?
Nové direktívy idú cez appendLedgerText, zmeny súborov cez nástroje pre súbory — createLedgerFiles, updateLedgerFiles, deleteLedgerFiles. Režim dry_run zobrazí náhľad plánovaných zmien bez akéhokoľvek potvrdenia, a či sa klient pred skutočným commitom spýta, závisí od klienta. Každá potvrdená zmena sa stane skutočným git commitom — úplnou auditnou stopou, ktorú môžete vrátiť štandardnými nástrojmi git. Pri commite sa chyby overenia môžu objaviť až po zápise, preto si najprv pozrite náhľad a potom skontrolujte ledger.
Posielajú sa moje dáta tretej strane?
Údaje z vašej knihy prechádzajú cez backend Web Beancount a vracajú sa ako výsledky nástrojov do vášho AI klienta. AI model, ktorý si vyberiete, tieto výsledky dostáva, takže sa uplatňujú aj zásady ochrany údajov jeho poskytovateľa. Pripojenie siaha len na knihy, ktoré ste autorizovali: jednu knihu alebo všetky.
Zapojte svoju účtovnú knihu do ďalšieho rozhovoru.
Beancount MCP server je dnes k dispozícii všetkým používateľom Web Beancount. Vaša účtovná kniha je jedna git push vec