# Ваша облікова книга стає частиною розмови.

Підключіть Beancount до звичних інструментів ШІ. Запитуйте про фінанси, працюйте з файлами облікової книги й відстежуйте зміни в Git.

[Підключити клієнт ШІ](https://beancount.io/uk/mcp#get-started) [Читати анонс](https://beancount.io/uk/blog/2026/06/30/beancount-mcp)

## Просто запитайте

Почніть із запитання. Простежте шлях від відповіді до записів у своїй обліковій книзі.

Це демонстраційні дані, без підключення до реальної книги.

Ви

Яка моя чиста вартість сьогодні?

Ваш ШІ-помічник

Ваша чиста вартість сьогодні — 128,450.32 USD.

Запитайте про залишки у своїй обліковій книзі, а потім перевірте результати, що лежать в основі відповіді.

На чому ґрунтується відповідь

`runBqlQuery`

```
SELECT sum(position) WHERE account ~ 'Assets|Liabilities'
```

128450.32 USD

Beancount

Приклад розмови з MCP

Працює з вашим MCP-сумісним клієнтом

- Claude Code
- Claude Desktop
- Codex
- Cursor
- Windsurf
- Zed

## Підключіть клієнт, яким ви вже користуєтеся

Виберіть свій клієнт, додайте сервер один раз і авторизуйте реєстри, до яких він може мати доступ.

### Claude Code

1. Виконайте цю одну команду у терміналі.

2. Відкрийте Claude Code і виконайте /mcp для автентифікації. Увійдіть у Web Beancount і схваліть один реєстр або всі.

3. Підтвердіть один раз. Облікові дані оновлюватимуться автоматично звідси.

[Документація з налаштування клієнта](https://code.claude.com/docs/en/mcp)

Термінал

```
claude mcp add --transport http beancount https://beancount.io/api-gateway/mcp
```

Більше одного реєстру? Схваліть їх усі одразу. Асистент викликає listLedgers, щоб побачити, до чого має доступ, і вказує реєстр у кожному виклику, тож один сервер охоплює всі книги.

Використовуйте свій акаунт Web Beancount, щоб авторизувати, до яких реєстрів сервер може мати доступ.

Немає облікового запису Web Beancount? [Зареєструйтесь на beancount.io](https://beancount.io/auth/sign-up) — ваша книга на відстані одного git push.

## Що може ШІ

Сервер надає спеціальні інструменти для вашого ledger і банківських підключень — операції з ledger показано нижче. ШІ поєднує їх: вивчає структуру файлів, читає контекст, запитує відповіді, пропонує правку.

Інструменти для ledger і банків. Ваш клієнт вирішує, як їх використовувати.

### runBqlQuery

Виконуйте запити BQL (Beancount Query Language) щодо балансів, транзакцій та рахунків.

### 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 працює](https://beancount.io/uk/git)

## Часті питання

Що слід знати перед підключенням.

Цікаво, як це побудовано?

[Читайте інженерне FAQ у блозі](https://beancount.io/uk/blog/2026/06/30/beancount-mcp)

Розглядаєте інші бухгалтерські MCP-сервери?

[Як Beancount MCP порівнюється з QuickBooks, Xero та Expensify](https://beancount.io/uk/compare/accounting-mcp-servers)

**Що таке 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 і повертаються як результати інструментів до вашого AI-клієнта. Обрана вами AI-модель отримує ці результати, тому політики обробки даних її провайдера також застосовуються. З'єднання охоплює лише ті журнали, які ви авторизували: один журнал або всі.

## Залучіть свою облікову книгу до наступної розмови.

Сервер Beancount MCP доступний сьогодні всім користувачам Web Beancount. Ваша книга — лише один git push.

[Почати безкоштовно](https://beancount.io/auth/sign-up) [Підключіть свого клієнта](https://beancount.io/uk/mcp#get-started)

## Where to look next

- [Sitemap](https://beancount.io/sitemap.xml) - all pages with hreflang alternates
- [LLMs index](https://beancount.io/llms.txt) - curated links for AI agents (also /llms-full.txt for full docs)
- [Documentation](https://beancount.io/docs) - every doc is also available as text/markdown via .md suffix or Accept negotiation
- [REST API reference](https://beancount.io/docs/api-reference) - interactive endpoints, schemas, authentication, and code samples
- [OpenAPI spec](https://beancount.io/openapi.json) - OpenAPI 3.1 spec for this website's public content endpoints; the product contract for ledger operations is at https://beancount.io/api-gateway/v1/openapi.json
- [GraphQL](https://beancount.io/graphql) - public, read-only content API over the blog and research logs (no credentials, no ledger data): 12 query fields over 23 types
- [MCP server](https://beancount.io/mcp) - Model Context Protocol at https://beancount.io/api-gateway/mcp
