Model Context Protocol
Hovorte o svojom účtovníctve z AI nástrojov, ktoré už používate
Beancount MCP server pripája vaše účtovníctvo v textovom formáte k Claude Code, Claude Desktop, Cursor, Windsurf, Zed — k akémukoľvek MCP-kompatibilnému AI klientovi. Žiadne kopírovanie a vkladanie. Žiadne exporty. Len sa opýtajte.
URL adresa MCP servera
https://beancount.io/api-gateway/mcp> Aká je dnes moja čistá hodnota?
⏺ runBqlQuery("SELECT sum(position) WHERE account ~ 'Assets|Liabilities'")
Vaša čistá hodnota dnes je 128,450.32 USD.
> Pridajte včerajšiu večeru tímu za 42 USD a potvrďte ju
⏺ editLedgerFiles(dry_run: true) → +1 transaction
⏺ git commit a1b4f2e — "AI edit: add team dinner transaction"
Hotovo — potvrdené do vášho účtovníctva s plnou audit stopou.
Len sa opýtajte
Odpovedať na „koľko som minul na cestovanie za posledný štvrťrok?“ zvyčajne znamenalo poznať syntax BQL, nájsť správne súbory a kopírovať výsledky do chatovej konverzácie. Teraz je to veta.
“Aká je dnes mojč čistá hodnota?”
Živá odpoveď odvodená z váš skutočného účtovníctva — nie odhad.
“Zhrni posledné mesačne výdavky”
AI napíše BQL dopyt za vás a prečíta späť výsledky.
“Pridajte transakciu a potvrdte ju do gitu”
Skutočný commit v repozitári vášho účtovníctva, zvratný ako ktorýkoľvek iný.
“Čo je v mojom repozitári účtovníctva?”
Prehliadajte a čítajte súbory .beancount bez odchodu z editora.
Čo môže AI robiť
Server poskytuje štyri nástroje pre účtovníctvo. AI ich spáju: objavte svoju súborovú štruktúru, čítajte pre kontext, dýujte pre odpovede, navrhite úpravu.
runBqlQuery
Spúšťať dotazy BQL (Beancount Query Language) na zostatky, transakcie a účty.
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.
Pripojte sa za menej ako minútu
Vyberte si svojho AI klienta. Kopírujte. Prilepte. Opýtajte sa.
- Spustite tento jeden príkaz v termináli.
- Claude Code otvorí okno prehliadača — prihláste sa a vyberte, ktorý ledger pripojiť.
- Schváľte raz. Poverenia sa odtiaľto automaticky obnovujú.
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/mcpNemáte Web Beancount účet? Zaregistrujte sa na beancount.io — váš ledger je len jeden git push vzdialený.
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.
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.
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.
Server bez stavu
Server MCP neukladá nič viac, než už drží konverzácia vášho AI klienta. Vaša účtovná kniha zostáva na mieste, kde je teraz.
Vaša celá účtovná kniha je už git repozitárom. Pozrite si, ako funguje Git pre Beancount
Často kladené otázky
Č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 vystavuje štyri nástroje: runBqlQuery vykonáva dotazy Beancount Query Language, listLedgerFiles prezerá repozitár účtovnej knihy, readLedgerFiles číta dokumenty účtovnej knihy a editLedgerFiles vytvára, aktualizuje alebo vymazáva súbory v atomickom git commite. AI ich kombinuje, aby odpovedala otázky a navrhov úpravy.
Môže AI modifikovať svoju účtovnú knihu bez toho, aby som o tom vedel?
Úpravy idú cez nástroj editLedgerFiles, ktorý dobre spravajúce sa MCP klientky vám zobrazia pred vykonaním. Režim dry_run zobrazuje presné zmeny bez písania čohokoľvek a každá vykonaná zmena je skutočný git commit – plný auditný záznam, ktorý môžete vráť štandardnými git nástrojmi.
Posielajú sa moje dáta tretej strane?
Dátová tok vašej účtovnej knihy prechádza cez backend Web Beancount, ktorý už vašu účtovnú knihu spravuje, a vracia sa ako štruktúrované výsledky do vášho AI klienta. Sedenia sú ohraničené knihou: každé môže pristupovať presne k tej knihe, ktorú ste povolili, a server MCP neukladá nič čo by nemal, okrem toho, čo už drží konverzácia vášho AI klienta.
Zaujíma vás, ako je to postavené? Prečítajte si technický FAQ na blogu
Vaše účtovné dáta spĺňajú sa s vaším AI pracovným postupom
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