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 klienta, pridajte server a povoľte prístup k jednej účtovnej knihe.
Claude Code
Spustite tento jeden príkaz v termináli.
Otvorte Claude Code a spustite /mcp na overenie totožnosti. Prihláste sa do Web Beancount a vyberte svoju účtovnú knihu.
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 jeden ledger? Pridajte server znova pod iným názvom a autorizujte druhý ledger v jeho vlastnom okne:
claude mcp add --transport http beancount-business https://beancount.io/api-gateway/mcpPomocou účtu Web Beancount povoľte prístup k jednej účtovnej knihe.
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, vaše API kľúče a vaše bankové pripojenia — slovesá ledgeru sú uvedené nižšie. AI ich skladá: objavte štruktúru svojich súborov, čítajte pre kontext, dopytujte sa pre odpovede, navrhnite úpravu.
Ledger, API kľúče a bankové nástroje. 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.
editLedgerFiles
Vytvárať, aktualizovať, nahrádzať alebo mazať súbory v atomickom git commite.
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.
OAuth 2.1 s rozsahom ledgera
Jedna relácia je autorizovaná presne pre jeden ledger. Relácia pre váš osobný ledger sa nemôže dotknúť vášho obchodného ledgera — obmedzený dosah dopadu.
Náhľady suchého spustenia
editLedgerFiles podporuje režim dry_run, ktorý overí a zobrazí presné zmeny bez zápisu, takže váš klient môže najprv zobraziť 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ý FAQ na bloguČ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 MCP konfigurácie vášho klienta. Pri prvom použití klient otvorí okno prehliadača – prihláste sa s vaším účtom Web Beancount a vyberte účtovnú knihu, ktorej chcete udeliť prístup. Klient automaticky ukladá a obnovuje prihlasovacie údaje od tejto bodky.
Čo môže AI skutočne robiť s mojou účtovnou knihou?
Server poskytuje cielené rodiny nástrojov — strojovo čitateľný manifest objavenia pod beancount.io/.well-known/ uvádza aktuálny zoznam. Nástroje ledgeru spúšťajú dotazy v jazyku Beancount Query Language (runBqlQuery), prehliadajú repozitár (listLedgerFiles), čítajú dokumenty ledgeru (readLedgerFiles) a vytvárajú, aktualizujú alebo odstraňujú súbory v rámci atómového git commitu (editLedgerFiles, s režimom náhľadu dry_run). Ďalšie nástroje spravujú API kľúče (list, mint, revoke — minting vyžaduje platený plán a OAuth grant, nie API kľúč) a bankové pripojenia a importy (stage, submit alebo discard transakcií; úplne nová banka sa prepojí v prehliadači, nie cez MCP). AI ich kombinuje na odpovedanie otázok a navrhovanie úprav.
Môže AI modifikovať svoju účtovnú knihu bez toho, aby som o tom vedel?
Úpravy prechádzajú cez nástroj editLedgerFiles. Režim dry_run zobrazí náhľad plánovaných operácií so súbormi bez čohokoľvek potvrdenia, a či váš klient požiada o potvrdenie pred skutočným commitom závisí od klienta. Každá potvrdená zmena sa zapíše ako skutočný git commit — úplný auditný záznam, ktorý môžete vrátiť späť štandardnými git nástrojmi. Cesta commitu môže po zápise hlásiť chyby validácie, takže najprv si urobte náhľad a potom overte ledger.
Posielajú sa moje dáta tretej strane?
Údaje z vašej účtovnej knihy prechádzajú cez backend Web Beancount a vracajú sa vášmu AI klientovi ako výsledky nástrojov. Dostáva ich aj zvolený AI model, preto sa na ne vzťahujú aj pravidlá jeho poskytovateľa pre spracovanie údajov. Každá autorizovaná relácia je obmedzená na jednu účtovnú knihu.
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