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 добавляют и удаляют их.
Ваша бухгалтерская книга под защитой
ИИ с правом записи в ваши книги заслуживает доверия через дизайн, а не обещания.
OAuth 2.1 с ограниченной областью
Вы выбираете, к чему может получить доступ соединение: к одному реестру или ко всем. Авторизуйте только свой личный реестр — и соединение не сможет коснуться ваших деловых книг. Вы сами задаёте радиус поражения.
Предпросмотр в режиме dry-run
Файловые инструменты (createLedgerFiles, updateLedgerFiles, deleteLedgerFiles) и appendLedgerText поддерживают режим dry_run, который проверяет и показывает точные изменения, ничего не записывая, — так ваш клиент может сначала показать вам diff.
Каждое изменение — это git-коммит
Изменения фиксируются как реальные коммиты ("AI edit: …") в репозитории вашей книги учёта — полный журнал аудита, который можно просмотреть и откатить стандартными git-инструментами.
Сервер без состояния
Сервер MCP не сохраняет состояние сеанса между вызовами инструментов. Выбранные вами ИИ-клиент и модель получают запрошенные результаты; перед подключением ознакомьтесь с их правилами обработки данных.
Ваша вся книга учёта уже является git-репозиторием.
Посмотрите, как работает Git for BeancountЧасто задаваемые вопросы
Что нужно знать перед подключением.
Интересно, как это устроено?
Прочитайте раздел «Часто задаваемые вопросы» для инженеров в блогеСравниваете другие MCP-серверы для бухгалтерии?
Как Beancount MCP соотносится с QuickBooks, Xero и ExpensifyЧто такое 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), добавляют директивы в порядке дат (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.