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-коммите.
Ваша бухгалтерская книга под защитой
ИИ с правом записи в ваши книги заслуживает доверия через дизайн, а не обещания.
OAuth 2.1 с ограниченной областью
Вы выбираете, к чему может получить доступ соединение: к одному реестру или ко всем. Авторизуйте только свой личный реестр — и соединение не сможет коснуться ваших деловых книг. Вы сами задаёте радиус поражения.
Предпросмотр в режиме dry-run
editLedgerFiles поддерживает режим dry_run, который проверяет и показывает точные изменения без записи, так что ваш клиент может сначала показать вам diff.
Каждое изменение — это git-коммит
Изменения фиксируются как реальные коммиты ("AI edit: …") в репозитории вашей книги учёта — полный журнал аудита, который можно просмотреть и откатить стандартными git-инструментами.
Сервер без состояния
Сервер MCP не сохраняет состояние сеанса между вызовами инструментов. Выбранные вами ИИ-клиент и модель получают запрошенные результаты; перед подключением ознакомьтесь с их правилами обработки данных.
Ваша вся книга учёта уже является git-репозиторием.
Посмотрите, как работает Git for BeancountЧасто задаваемые вопросы
Что нужно знать перед подключением.
Интересно, как это устроено?
Прочитайте раздел «Часто задаваемые вопросы» для инженеров в блогеЧто такое MCP и почему это важно для Beancount?
MCP (Model Context Protocol) — это открытый стандарт, который позволяет ИИ-ассистентам вызывать внешние инструменты и источники данных структурированным и безопасным способом. Вместо того чтобы угадывать или просить вас вставить данные, ваш ИИ-клиент напрямую подключается к вашей книге учёта — он запрашивает ваши реальные данные, читает ваши фактические файлы и вносит точные изменения.
Какие ИИ-клиенты работают с 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 — выпуск требует платного плана и OAuth-разрешения, не API-ключа)ибанковскими подключениями и импортами( этап, отправка или отклонение транзакций; новый банк подключается в браузере, а не через MCP). ИИ объединяет их для ответов на вопросы и предложения изменений.
Может ли ИИ изменять мою книгу учёта без моего ведома?
Правки проходят через инструмент editLedgerFiles. Режим dry_run предпросматривает запланированные файловые операции без коммита, и зависит от клиента, спрашивает ли он перед реальным коммитом. Каждое закоммиченное изменение вносится как реальный git-коммит—полный журнал аудита, который можно откатить стандартными git-инструментами. Коммит может сообщать об ошибках валидации после записи, поэтому сначала предпросматривайте и проверяйте Ledger после.
Передаются ли мои данные третьим лицам?
Данные вашей учётной книги проходят через серверную часть Web Beancount и возвращаются вашему ИИ-клиенту как результаты работы инструментов. Выбранная ИИ-модель тоже получает эти результаты, поэтому действуют и правила обработки данных её провайдера. Каждый авторизованный сеанс ограничен одной учётной книгой.
Пригласите свою учётную книгу в следующий разговор.
Beancount MCP-сервер уже доступен всем пользователям Web Beancount. Ваша книга учёта — это один git push.