Model Context Protocol
Спілкуйтеся зі своїм журналом через AI-інструменти, які ви вже використовуєте
Сервер Beancount MCP підключає ваш журнал у вигляді звичайного тексту до Claude Code, Claude Desktop, Cursor, Windsurf, Zed — будь-якого MCP-сумісного AI-клієнта. Без копіювання. Без експорту. Просто запитайте.
URL MCP-сервера
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, пошуку потрібних файлів і копіювання результатів у чат. Тепер це одне речення.
“Який мій чистий капітал сьогодні?”
Жива відповідь, взята з вашого фактичного журналу, а не здогадка.
“Підсумуйте витрати за минулий місяць”
ШІ пише запит BQL за вас і читає результати.
“Додати транзакцію та зафіксувати її в git”
Справжній коміт у репозиторії вашого журналу, який можна скасувати, як і будь-який інший.
“Що в моєму репозиторії журналу?”
Переглядайте та читайте ваші файли .beancount, не виходячи з редактора.
Що може ШІ
Сервер надає чотири інструменти для журналу. ШІ їх комбінує: виявляє структуру файлів, читає контекст, виконує запити для відповідей, пропонує редагування.
runBqlQuery
Виконуйте запити BQL (Beancount Query Language) щодо балансів, транзакцій та рахунків.
listLedgerFiles
Переглядайте структуру каталогів вашого репозиторію журналу.
readLedgerFiles
Читайте вміст ваших файлів .beancount та інших документів журналу.
editLedgerFiles
Створюйте, оновлюйте, замінюйте або видаляйте файли в атомарному коміті git.
Підключіться менш ніж за хвилину
Оберіть свого AI-клієнта. Скопіюйте. Вставте. Запитайте.
- Виконайте цю одну команду у терміналі.
- Claude Code відкриває вікно браузера — увійдіть і виберіть, яку книгу підключити.
- Підтвердіть один раз. Облікові дані оновлюватимуться автоматично звідси.
claude mcp add --transport http beancount https://beancount.io/api-gateway/mcpМаєте більше ніж одну книгу? Додайте сервер ще раз під іншою назвою та авторизуйте іншу книгу у власному запиті:
claude mcp add --transport http beancount-business https://beancount.io/api-gateway/mcpНемає облікового запису Web Beancount? Зареєструйтесь на beancount.io — ваша книга на відстані одного git push.
Ваша бухгалтерська книга під захистом
ШІ з правом запису у вашу книгу заслуговує довіру через дизайн, а не обіцянки.
OAuth 2.1 з обмеженням на книгу
Одна сесія авторизована лише для однієї книги. Сесія для вашої особистої книги не може торкатися вашої бізнес-книги — радіус впливу обмежено.
Кожне редагування — це git-коміт
Зміни потрапляють як справжні коміти ("AI edit: …") у репозиторій вашої книги — повний журнал аудиту, який ви можете переглянути та відкотити за допомогою стандартних інструментів git.
Попередній перегляд у сухому режимі
editLedgerFiles підтримує режим dry_run, який перевіряє та попередньо показує точні зміни без запису будь-чого, тож ваш клієнт може спочатку показати вам diff.
Без станний сервер
Сервер MCP не зберігає нічого, окрім того, що вже є в розмові вашого AI-клієнта. Ваша книга залишається там, де вона живе зараз.
Ваша книга вже є git-репозиторієм. Дізнайтеся, як Git for 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 та оберіть книгу, до якої ви хочете надати доступ. Клієнт автоматично зберігає та оновлює облікові дані з цього моменту.
Що насправді може робити ШІ з моєю книгою?
Сервер надає чотири інструменти: runBqlQuery виконує запити Beancount Query Language, listLedgerFiles переглядає ваш репозиторій книги, readLedgerFiles читає документи книги, а editLedgerFiles створює, оновлює або видаляє файли в атомарному git-коміті. ШІ комбінує їх, щоб відповідати на питання та пропонувати зміни.
Чи може ШІ змінити мою книгу без мого відома?
Зміни проходять через інструмент editLedgerFiles, який коректні MCP-клієнти показують вам перед виконанням. Режим dry_run попередньо переглядає точні зміни без запису будь-чого, а кожне зафіксоване змінення є справжнім git-комітом — повний аудиторський слід, який можна скасувати за допомогою стандартних git-інструментів.
Чи передаються мої дані третім особам?
Дані вашої книги проходять через бекенд Web Beancount, який вже керує вашою книгою, і повертаються у вигляді структурованих результатів вашому ШІ-клієнту. Сесії обмежені книгою: кожна може отримати доступ саме до тієї книги, яку ви авторизували, і MCP-сервер не зберігає нічого, окрім того, що міститься в розмові вашого ШІ-клієнта.
Цікаво, як це побудовано? Читайте інженерне FAQ у блозі
Ваші облікові дані зустрічаються з вашим робочим процесом ШІ
Сервер Beancount MCP доступний сьогодні всім користувачам Web Beancount. Ваша книга — лише один git push.