runBqlQuery
Изпълнете BQL (Beancount Query Language) заявки срещу салда, транзакции и сметки.
Model Context Protocol
Вашата счетоводна книга става част от разговора.
Свържете Beancount с AI инструментите, които вече използвате. Питайте за финансите си, работете с файловете на счетоводната книга и поддържайте промените проследими в Git.
Просто попитайте
Започнете с въпрос. Проследете отговора обратно до вашата счетоводна книга.
Как се получи отговорът
runBqlQuerySELECT sum(position) WHERE account ~ 'Assets|Liabilities'Beancount
Работи с вашия MCP-съвместим клиент
- Claude Code
- Claude Desktop
- Cursor
- Windsurf
- Zed
Свържете клиента, който вече използвате
Изберете вашия клиент, добавете сървъра и разрешете достъп до една счетоводна книга.
Claude Code
Изпълнете тази една команда в терминала си.
Отворете Claude Code и изпълнете /mcp, за да се удостоверите. Влезте в Web Beancount и изберете вашата счетоводна книга.
Одобрете веднъж. От тук нататък идентификационните данни се обновяват автоматично.
Терминал
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 акаунт, за да разрешите достъп до една счетоводна книга.
Нямате Web Beancount акаунт? Регистрирайте се в beancount.io — вашето ledger е на един git push разстояние.
Какво може AI
Сървърът предоставя фокусирани инструменти за вашия сметкопис, вашите API ключове и вашите банкови връзки — глаголите за сметкопис са показани по-долу. AI ги комбинира: открийте файловата си структура, четете за контекст, запитвайте за отговори, предлагайте редакция.
Инструменти за сметкопис, API ключове и банки. Вашият клиент решава как да ги използва.
listLedgerFiles
Разгледайте директорната структура на вашето ledger хранилище.
readLedgerFiles
Прочетете съдържанието на вашите .beancount файлове и други ledger документи.
editLedgerFiles
Създавайте, актуализирайте, заменяйте или изтривайте файлове в атомарен git commit.
Вашето ledger, защитено
AI с право на запис във вашите книги печели доверие чрез дизайн, а не чрез обещания.
Ledger-ограничен OAuth 2.1
Една сесия е упълномощена точно за едно ledger. Сесия за вашето лично ledger не може да докосне бизнес ledger-то ви — ограничен радиус на взрив.
Прегледи в режим на сухо изпълнение
editLedgerFiles поддържа режим dry_run, който валидира и преглежда точните промени без да записва нищо, така че вашият клиент може първо да ви покаже разликата (diff).
Всяка редакция е git commit
Промените се записват като реални комити ("AI edit: …") в хранилището на вашата счетоводна книга — пълна одитна следа, която можете да преглеждате и отменяте със стандартните git инструменти.
Сървър без състояние
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 с моята счетоводна книга?
Сървърът предоставя фокусирани семейства от инструменти — машинночетимият манифест за откриване под beancount.io/.well-known/ изброява текущия набор. Инструментите за сметкопис изпълняват заявки на Beancount Query Language (runBqlQuery), преглеждат хранилището (listLedgerFiles), четат документи на сметкописа (readLedgerFiles) и създават, актуализират или изтриват файлове в атомарен git commit (editLedgerFiles, с режим за предварителен преглед dry_run). Допълнителни инструменти управляват API ключове (списък, издаване, отнемане — издаването изисква платен план и OAuth разрешение, не API ключ) и банкови връзки и импортиране (етапиране, подаване или отхвърляне на транзакции; съвсем нова банка се свързва в браузъра, не през MCP). AI ги комбинира, за да отговаря на въпроси и да предлага редакции.
Може ли AI да променя счетоводната ми книга без да знам?
Редакциите минават през инструмента editLedgerFiles. Режимът dry_run показва предварително планираните файлови операции, без да ангажира нищо, и дали вашият клиент пита преди реален commit зависи от клиента. Всяка ангажирана промяна се записва като реален git commit — пълна одитна следа, която можете да отмените със стандартни git инструменти. Пътят на commit може да докладва грешки при валидация след записа, затова първо предварително прегледайте и след това проверете сметкописа.
Изпращат ли се данните ми на трета страна?
Данните от вашата счетоводна книга преминават през бекенда на Web Beancount и се връщат като резултати от инструментите към вашия AI клиент. Избраният от вас AI модел получава тези резултати, така че към тях се прилагат и политиките за данни на неговия доставчик. Всяка упълномощена сесия е ограничена до една счетоводна книга.
Включете вашата счетоводна книга в следващия си разговор.
Beancount MCP сървърът е достъпен днес за всички Web Beancount потребители. Вашата счетоводна книга е на един git push разстояние.