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 і банківських підключень — операції з ledger показано нижче. ШІ поєднує їх: вивчає структуру файлів, читає контекст, запитує відповіді, пропонує правку.
Інструменти для ledger і банків. Ваш клієнт вирішує, як їх використовувати.
listLedgerFiles
Переглядайте структуру каталогів вашого репозиторію журналу.
readLedgerFiles
Читайте вміст ваших файлів .beancount та інших документів журналу.
updateLedgerFiles
Змінює файли в атомарному git-коміті з попереднім переглядом dry_run; createLedgerFiles і deleteLedgerFiles додають і видаляють їх.
Ваша бухгалтерська книга під захистом
ШІ з правом запису у вашу книгу заслуговує довіру через дизайн, а не обіцянки.
Scoped OAuth 2.1
Ви вибираєте, до чого може мати доступ з'єднання: один реєстр або всі. Авторизуйте лише свій особистий реєстр, і з'єднання не зможе торкнутися ваших бізнес-книг — радіус ураження визначаєте ви.
Попередній перегляд у сухому режимі
Файлові інструменти (createLedgerFiles, updateLedgerFiles, deleteLedgerFiles) і appendLedgerText підтримують режим 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), додають директиви в порядку дат (appendLedgerText) і створюють, змінюють або видаляють файли в атомарному git-коміті (createLedgerFiles, updateLedgerFiles, deleteLedgerFiles, кожен із режимом попереднього перегляду dry_run). Банківські інструменти отримують, імпортують або відкидають транзакції, що очікують, і керують підключеними банками; зовсім новий банк підключається в браузері, а не через MCP. API-ключі та налаштування облікового запису залишаються у вебзастосунку Beancount.io. ШІ поєднує інструменти, щоб відповідати на запитання й пропонувати правки.
Чи може ШІ змінити мою книгу без мого відома?
Нові директиви додаються через appendLedgerText, а зміни файлів — через файлові інструменти: createLedgerFiles, updateLedgerFiles, deleteLedgerFiles. Режим dry_run показує заплановані зміни без коміту, а чи питатиме клієнт підтвердження перед справжнім комітом, залежить від клієнта. Кожна зафіксована зміна стає справжнім git-комітом — повним журналом аудиту, який можна відкотити стандартними інструментами git. Під час коміту помилки перевірки можуть з’явитися вже після запису, тому спершу перегляньте зміни, а потім перевірте ledger.
Чи передаються мої дані третім особам?
Дані вашої облікової книги проходять через серверну частину Web Beancount і повертаються вашому клієнту ШІ як результати роботи інструментів. Обрана вами модель ШІ теж отримує ці результати, тому діють і правила обробки даних її постачальника. Кожен авторизований сеанс обмежений однією обліковою книгою.
Залучіть свою облікову книгу до наступної розмови.
Сервер Beancount MCP доступний сьогодні всім користувачам Web Beancount. Ваша книга — лише один git push.