runBqlQuery
Виконуйте запити BQL (Beancount Query Language) щодо балансів, транзакцій та рахунків.
Model Context Protocol
Ваша облікова книга стає частиною розмови.
Підключіть Beancount до звичних інструментів ШІ. Запитуйте про фінанси, працюйте з файлами облікової книги й відстежуйте зміни в 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Більше одного реєстру? Схваліть їх усі одразу. Асистент викликає listLedgers, щоб побачити, до чого має доступ, і вказує реєстр у кожному виклику, тож один сервер охоплює всі книги.
Використовуйте свій акаунт Web Beancount, щоб авторизувати, до яких реєстрів сервер може мати доступ.
Немає облікового запису Web Beancount? Зареєструйтесь на beancount.io — ваша книга на відстані одного git push.
Що може ШІ
Сервер надає цілеспрямовані інструменти для вашого Ledger, ваших API-ключів та ваших банківських з'єднань — дієслова для Ledger показані нижче. ШІ компонує їх: виявляє структуру ваших файлів, читає для контексту, виконує запити для відповідей, пропонує зміни.
Інструменти для Ledger, API-ключів та банків. Ваш клієнт вирішує, як їх використовувати.
listLedgerFiles
Переглядайте структуру каталогів вашого репозиторію журналу.
readLedgerFiles
Читайте вміст ваших файлів .beancount та інших документів журналу.
editLedgerFiles
Створюйте, оновлюйте, замінюйте або видаляйте файли в атомарному коміті git.
Ваша бухгалтерська книга під захистом
ШІ з правом запису у вашу книгу заслуговує довіру через дизайн, а не обіцянки.
Scoped OAuth 2.1
Ви вибираєте, до чого може мати доступ з'єднання: один реєстр або всі. Авторизуйте лише свій особистий реєстр, і з'єднання не зможе торкнутися ваших бізнес-книг — радіус ураження визначаєте ви.
Попередній перегляд у сухому режимі
editLedgerFiles підтримує режим dry_run, який перевіряє та попередньо показує точні зміни без запису будь-чого, тож ваш клієнт може спочатку показати вам diff.
Кожне редагування — це git-коміт
Зміни потрапляють як справжні коміти ("AI edit: …") у репозиторій вашої книги — повний журнал аудиту, який ви можете переглянути та відкотити за допомогою стандартних інструментів git.
Без станний сервер
Сервер MCP не зберігає стан сеансу між викликами інструментів. Обрані вами клієнт і модель ШІ отримують запитані результати; перед підключенням ознайомтеся з їхніми правилами обробки даних.
Ваша книга вже є git-репозиторієм.
Дізнайтеся, як Git for Beancount працюєЧасті питання
Що слід знати перед підключенням.
Цікаво, як це побудовано?
Читайте інженерне FAQ у блозіЩо таке 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 і виберіть, чи може він мати доступ до одного реєстру, чи до всіх. Далі клієнт зберігає та оновлює облікові дані автоматично.
Що насправді може робити ШІ з моєю книгою?
Сервер надає цілеспрямовані групи інструментів — машиночитаний маніфест виявлення за адресою beancount.io/.well-known/ перелічує поточний набір. Інструменти Ledger виконують запити Beancount Query Language (runBqlQuery), переглядають репозиторій (listLedgerFiles), читають документи Ledger (readLedgerFiles) та створюють, оновлюють або видаляють файли в атомарному git-коміті (editLedgerFiles, з режимом попереднього перегляду dry_run). Додаткові інструменти керують API-ключами (list, mint, revoke — minting потребує платного плану та OAuth-гранту, не API-ключа) та банківськими з'єднаннями та імпортами (stage, submit або discard транзакцій; новий банк прив'язується в браузері, а не через MCP). ШІ комбінує їх, щоб відповідати на питання та пропонувати зміни.
Чи може ШІ змінити мою книгу без мого відома?
Зміни виконуються через інструмент editLedgerFiles. Режим dry_run попередньо переглядає заплановані операції з файлами без фіксації, а чи буде ваш клієнт питати перед реальним комітом — залежить від клієнта. Кожна зафіксована зміна стає реальним git-комітом — повний журнал аудиту, який можна відкотити стандартними git-інструментами. Шлях коміту може повідомляти про помилки валідації після запису, тому спочатку перегляньте попередньо, а потім перевірте Ledger.
Чи передаються мої дані третім особам?
Дані вашої облікової книги проходять через серверну частину Web Beancount і повертаються вашому клієнту ШІ як результати роботи інструментів. Обрана вами модель ШІ теж отримує ці результати, тому діють і правила обробки даних її постачальника. Кожен авторизований сеанс обмежений однією обліковою книгою.
Залучіть свою облікову книгу до наступної розмови.
Сервер Beancount MCP доступний сьогодні всім користувачам Web Beancount. Ваша книга — лише один git push.