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У вас более одной бухгалтерской книги? Добавьте сервер еще раз под другим именем и авторизуйте другую книгу в ее собственном запросе:
claude mcp add --transport http beancount-business https://beancount.io/api-gateway/mcpРазрешите доступ к одной учётной книге через свою учётную запись Web Beancount.
У вас нет учетной записи Web Beancount? Зарегистрируйтесь на beancount.io — ваша бухгалтерская книга в одном git push.
Что умеет ИИ
Сервер предоставляет четыре инструмента для реестра. ИИ комбинирует их: обнаружьте структуру файлов, читайте для контекста, запрашивайте ответы, предлагайте правки.
Четыре инструмента с чёткими задачами. Ваш клиент решает, как их использовать.
listLedgerFiles
Просматривайте структуру каталогов вашего репозитория бухгалтерской книги.
readLedgerFiles
Читайте содержимое ваших .beancount-файлов и других документов бухгалтерской книги.
editLedgerFiles
Создавайте, обновляйте, заменяйте или удаляйте файлы в атомарном git-коммите.
Ваша бухгалтерская книга под защитой
ИИ с правом записи в ваши книги заслуживает доверия через дизайн, а не обещания.
OAuth 2.1 с ограничением по бухгалтерской книге
Одна сессия авторизована ровно для одной бухгалтерской книги. Сессия для вашей личной книги не может коснуться вашей деловой книги — радиус поражения ограничен.
Предпросмотр в режиме dry-run
editLedgerFiles поддерживает режим dry_run, который проверяет и показывает точные изменения без записи, так что ваш клиент может сначала показать вам diff.
Каждое изменение — это git-коммит
Изменения фиксируются как реальные коммиты ("AI edit: …") в репозитории вашей книги учёта — полный журнал аудита, который можно просмотреть и откатить стандартными git-инструментами.
Сервер без состояния
Сервер MCP не сохраняет состояние сеанса между вызовами инструментов. Выбранные вами ИИ-клиент и модель получают запрошенные результаты; перед подключением ознакомьтесь с их правилами обработки данных.
Ваша вся книга учёта уже является git-репозиторием.
Посмотрите, как работает Git for BeancountЧасто задаваемые вопросы
Что нужно знать перед подключением.
Интересно, как это устроено?
Прочитайте инженерный FAQ в блогеЧто такое 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 и выберите книгу учёта, к которой вы хотите предоставить доступ. Клиент автоматически сохраняет и обновляет учётные данные.
Что именно ИИ может делать с моей книгой учёта?
Сервер предоставляет четыре инструмента: runBqlQuery выполняет запросы Beancount Query Language, listLedgerFiles просматривает репозиторий вашей книги учёта, readLedgerFiles читает ваши документы книги учёта, а editLedgerFiles создаёт, обновляет или удаляет файлы в атомарном git-коммите. ИИ комбинирует их, чтобы отвечать на вопросы и предлагать изменения.
Может ли ИИ изменять мою книгу учёта без моего ведома?
Изменения проходят через инструмент editLedgerFiles, который хорошо ведущие себя MCP-клиенты показывают вам перед выполнением. Режим dry_run предварительно просматривает точные изменения без записи, и каждое зафиксированное изменение — это настоящий git-коммит — полный журнал аудита, который можно откатить стандартными git-инструментами.
Передаются ли мои данные третьим лицам?
Данные вашей учётной книги проходят через серверную часть Web Beancount и возвращаются вашему ИИ-клиенту как результаты работы инструментов. Выбранная ИИ-модель тоже получает эти результаты, поэтому действуют и правила обработки данных её провайдера. Каждый авторизованный сеанс ограничен одной учётной книгой.
Пригласите свою учётную книгу в следующий разговор.
Beancount MCP-сервер уже доступен всем пользователям Web Beancount. Ваша книга учёта — это один git push.