Model Context Protocol
Говорете с вашата сметка от AI инструментите, които вече използвате
Beancount MCP сървърът свързва вашата plain-text сметка с Claude Code, Claude Desktop, Cursor, Windsurf, Zed — всеки MCP-съвместим AI клиент. Без копиране. Без експортиране. Просто попитайте.
MCP сървърен URL
https://beancount.io/api-gateway/mcp> Какво е нетното ми богатство днес?
⏺ runBqlQuery("SELECT sum(position) WHERE account ~ 'Assets|Liabilities'")
Нетното ви богатство днес е 128,450.32 USD.
> Добавете снощната вечеря за екипа от 42 USD и я запишете
⏺ editLedgerFiles(dry_run: true) → +1 transaction
⏺ git commit a1b4f2e — "AI edit: add team dinner transaction"
Готово — записано във вашата сметка с пълна одитна следа.
Просто попитайте
Отговарянето на „Колко похарчих за пътувания миналото тримесечие?“ означаваше да знаете BQL синтаксис, да намерите правилните файлове и да копирате резултатите в чат. Сега е едно изречение.
“Какво е нетното ми богатство днес?”
Жив отговор, извлечен от действителната ви сметка — не предположение.
“Обобщете миналогодишните разходи”
AI написва BQL заявката вместо вас и ви чете резултатите.
“Добавете транзакция и я запишете в git”
Реално записване в хранилището на вашата сметка, обратимо като всяко друго.
“Какво има в хранилището на моята сметка?”
Разглеждайте и четете вашите .beancount файлове, без да напускате редактора си.
Какво може AI
Сървърът предоставя четири инструмента за сметката. AI ги комбинира: открива файловата структура, чете за контекст, задава заявки за отговори, предлага редакция.
runBqlQuery
Изпълнете BQL (Beancount Query Language) заявки срещу салда, транзакции и сметки.
listLedgerFiles
Разгледайте директорната структура на вашето ledger хранилище.
readLedgerFiles
Прочетете съдържанието на вашите .beancount файлове и други ledger документи.
editLedgerFiles
Създавайте, актуализирайте, заменяйте или изтривайте файлове в атомарен git commit.
Свържете се за по-малко от минута
Изберете вашия AI клиент. Копирайте. Поставете. Попитайте.
- Изпълнете тази една команда в терминала си.
- Claude Code отваря прозорец на браузъра — влезте и изберете кое ledger да свържете.
- Одобрете веднъж. От тук нататък идентификационните данни се обновяват автоматично.
claude mcp add --transport http beancount https://beancount.io/api-gateway/mcpИмате повече от едно ledger? Добавете сървъра отново под друго име и упълномощете другото ledger в неговия собствен прозорец:
claude mcp add --transport http beancount-business https://beancount.io/api-gateway/mcpНямате Web Beancount акаунт? Регистрирайте се в beancount.io — вашето ledger е на един git push разстояние.
Вашето ledger, защитено
AI с право на запис във вашите книги печели доверие чрез дизайн, а не чрез обещания.
Ledger-ограничен OAuth 2.1
Една сесия е упълномощена точно за едно ledger. Сесия за вашето лично ledger не може да докосне бизнес ledger-то ви — ограничен радиус на взрив.
Всяка редакция е git commit
Промените се записват като реални комити ("AI edit: …") в хранилището на вашата счетоводна книга — пълна одитна следа, която можете да преглеждате и отменяте със стандартните git инструменти.
Прегледи в режим на сухо изпълнение
editLedgerFiles поддържа режим dry_run, който валидира и преглежда точните промени без да записва нищо, така че вашият клиент може първо да ви покаже разликата (diff).
Сървър без състояние
MCP сървърът не съхранява нищо извън това, което вече се съдържа в разговора на вашия AI клиент. Вашата счетоводна книга остава там, където е днес.
Цялата ви счетоводна книга вече е git хранилище. Вижте как работи Git за Beancount
Често задавани въпроси
Какво е MCP и защо е важно за Beancount?
MCP (Model Context Protocol) е отворен стандарт, който позволява на AI асистентите да извикват външни инструменти и източници на данни по структуриран и безопасен начин. Вместо да гадае или да ви моли да поставяте данни, вашият AI клиент се свързва директно с вашата счетоводна книга — той запитва вашите реални данни, чете вашите действителни файлове и прави точни редакции.
Кои AI клиенти работят с Beancount MCP сървъра?
Всеки MCP-съвместим клиент, който поддържа OAuth 2.1, работи веднага, включително Claude Code, Claude Desktop, Cursor, Windsurf и Zed. Клиентите без поддръжка на OAuth 2.1 могат да се свържат със статичен токен, генериран в настройките на вашия акаунт в beancount.io.
Как да свържа счетоводната си книга?
Добавете URL адреса на сървъра към MCP конфигурацията на вашия клиент. При първото използване клиентът отваря прозорец на браузъра — влезте с вашия Web Beancount акаунт и изберете счетоводната книга, на която искате да дадете достъп. Клиентът съхранява и обновява идентификационните данни автоматично оттам нататък.
Какво може всъщност да прави AI с моята счетоводна книга?
Сървърът предоставя четири инструмента: runBqlQuery изпълнява заявки на Beancount Query Language, listLedgerFiles разглежда вашето счетоводно хранилище, readLedgerFiles чете вашите счетоводни документи, а editLedgerFiles създава, актуализира или изтрива файлове в атомарен git комит. AI ги комбинира, за да отговаря на въпроси и да предлага редакции.
Може ли AI да променя счетоводната ми книга без да знам?
Редакциите преминават през инструмента editLedgerFiles, който добре възпитаните MCP клиенти ви показват преди изпълнение. Режимът dry_run преглежда точните промени без да записва нищо, а всяка извършена промяна е реален git комит — пълна одитна следа, която можете да отмените със стандартни git инструменти.
Изпращат ли се данните ми на трета страна?
Данните от вашата счетоводна книга преминават през бекенда на Web Beancount, който вече управлява вашата счетоводна книга, и се връщат като структурирани резултати към вашия AI клиент. Сесиите са ограничени до счетоводната книга: всяка от тях може да получи достъп точно до счетоводната книга, която сте разрешили, а MCP сървърът не съхранява нищо извън това, което вече се съдържа в разговора на вашия AI клиент.
Любопитни как е изградено? Прочетете инженерните често задавани въпроси в блога
Вашите счетоводни данни се срещат с вашия AI работен процес
Beancount MCP сървърът е достъпен днес за всички Web Beancount потребители. Вашата счетоводна книга е на един git push разстояние.