runBqlQuery
Изпълнете BQL (Beancount Query Language) заявки срещу салда, транзакции и сметки.
Model Context Protocol
Вашата счетоводна книга става част от разговора.
Свържете Beancount с AI инструментите, които вече използвате. Питайте за финансите си, работете с файловете на счетоводната книга и поддържайте промените проследими в Git.
Просто попитайте
Започнете с въпрос. Проследете отговора обратно до вашата счетоводна книга.
Как се получи отговорът
runBqlQuerySELECT sum(position) WHERE account ~ 'Assets|Liabilities'128450.32 USD
Beancount
Работи с вашия MCP-съвместим клиент
- Claude Code
- Claude Desktop
- Codex
- Cursor
- Windsurf
- Zed
Свържете клиента, който вече използвате
Изберете вашия клиент, добавете сървъра веднъж и разрешете достъп до регистрите, до които може да достига.
Claude Code
Изпълнете тази една команда в терминала си.
Отворете Claude Code и изпълнете /mcp за удостоверяване. Влезте в Web Beancount и одобрете един регистър или всички.
Одобрете веднъж. От тук нататък идентификационните данни се обновяват автоматично.
Терминал
claude mcp add --transport http beancount https://beancount.io/api-gateway/mcpПовече от един регистър? Одобрете ги всички наведнъж. Асистентът извиква listLedgers, за да види до какво може да достига, и посочва регистъра при всяко извикване, така че един сървър покрива всички книги.
Използвайте вашия акаунт в Web Beancount, за да разрешите до кои регистри може да достига сървърът.
Нямате Web Beancount акаунт? Регистрирайте се в beancount.io — вашето ledger е на един git push разстояние.
Какво може AI
Сървърът предоставя специализирани инструменти за вашия сметкопис и банковите ви връзки — операциите със сметкописа са показани по-долу. ИИ ги комбинира: разучава структурата на файловете, чете контекста, търси отговори, предлага редакция.
Инструменти за сметкопис и банки. Вашият клиент решава как да ги използва.
listLedgerFiles
Разгледайте директорната структура на вашето ledger хранилище.
readLedgerFiles
Прочетете съдържанието на вашите .beancount файлове и други ledger документи.
updateLedgerFiles
Променя файлове в атомарен git commit с преглед dry_run; createLedgerFiles и deleteLedgerFiles ги добавят и премахват.
Вашето ledger, защитено
AI с право на запис във вашите книги печели доверие чрез дизайн, а не чрез обещания.
Обхватно OAuth 2.1
Вие избирате до какво може да достига една връзка: един регистър или всички. Разрешете само личния си регистър и връзката не може да докосне бизнес книгите ви — вие определяте обхвата на последствията.
Прегледи в режим на сухо изпълнение
Файловите инструменти (createLedgerFiles, updateLedgerFiles, deleteLedgerFiles) и appendLedgerText поддържат режим dry_run, който проверява и показва точните промени, без да записва нищо, така че вашият клиент може първо да ви покаже diff.
Всяка редакция е git commit
Промените се записват като реални комити ("AI edit: …") в хранилището на вашата счетоводна книга — пълна одитна следа, която можете да преглеждате и отменяте със стандартните git инструменти.
Сървър без състояние
MCP сървърът не съхранява състояние на сесията между извикванията на инструменти. Вашият избран AI клиент и модел получават резултатите, които поискате; проверете техните политики за данни, преди да се свържете.
Цялата ви счетоводна книга вече е git хранилище.
Вижте как работи Git за BeancountЧесто задавани въпроси
Какво да знаете, преди да се свържете.
Любопитни как е изградено?
Прочетете инженерните често задавани въпроси в блогаОбмисляте други счетоводни MCP сървъри?
Как Beancount MCP се сравнява с QuickBooks, Xero и ExpensifyКакво е 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), добавят директиви по реда на датите (appendLedgerText) и създават, променят или изтриват файлове в атомарен git commit (createLedgerFiles, updateLedgerFiles, deleteLedgerFiles, всеки с режим за преглед dry_run). Банковите инструменти изтеглят, импортират или отхвърлят чакащи транзакции и управляват свързаните връзки; съвсем нова банка се свързва в браузъра, а не през MCP. API ключовете и настройките на акаунта остават в уеб приложението на Beancount.io. ИИ комбинира инструментите, за да отговаря на въпроси и да предлага редакции.
Може ли AI да променя счетоводната ми книга без да знам?
Новите директиви минават през appendLedgerText, а промените във файлове — през файловите инструменти: createLedgerFiles, updateLedgerFiles, deleteLedgerFiles. Режимът dry_run показва планираните промени, без да записва нищо, а дали клиентът ще поиска потвърждение преди истински commit, зависи от клиента. Всяка записана промяна става истински git commit — пълна одитна следа, която можете да отмените със стандартните git инструменти. При commit грешките при проверка може да се появят след записа, затова първо прегледайте промените, а след това проверете сметкописа.
Изпращат ли се данните ми на трета страна?
Данните от вашия регистър преминават през бекенда на Web Beancount и се връщат като резултати от инструменти към вашия AI клиент. Избраният от вас AI модел получава тези резултати, така че политиките за данни на неговия доставчик също се прилагат. Връзката достига само до регистрите, които сте оторизирали: един регистър или всички тях.
Включете вашата счетоводна книга в следващия си разговор.
Beancount MCP сървърът е достъпен днес за всички Web Beancount потребители. Вашата счетоводна книга е на един git push разстояние.