Model Context Protocol
Общайтесь со своим реестром из уже привычных ИИ-инструментов
MCP-сервер Beancount подключает ваш текстовый реестр к Claude Code, Claude Desktop, Cursor, Windsurf, Zed — любому MCP-совместимому ИИ-клиенту. Без копирования. Без экспорта. Просто спросите.
URL MCP-сервера
https://beancount.io/api-gateway/mcp> Какой мой чистый капитал сегодня?
⏺ runBqlQuery("SELECT sum(position) WHERE account ~ 'Assets|Liabilities'")
Ваш чистый капитал сегодня составляет 128,450.32 USD.
> Добавь вчерашний командный ужин на 42 USD и закоммить его
⏺ editLedgerFiles(dry_run: true) → +1 transaction
⏺ git commit a1b4f2e — "AI edit: add team dinner transaction"
Готово — закоммичено в ваш реестр с полным журналом аудита.
Просто спросите
Ответить на вопрос «сколько я потратил на поездки в прошлом квартале?» раньше означало знать синтаксис BQL, найти нужные файлы и копировать результаты в чат. Теперь это одно предложение.
“Какой мой чистый капитал сегодня?”
Живой ответ, взятый из вашего реального реестра, — не догадка.
“Суммируй расходы за прошлый месяц”
ИИ составляет BQL-запрос за вас и считывает результаты.
“Добавь транзакцию и закоммить её в git”
Настоящий коммит в репозитории вашего реестра, который можно откатить как любой другой.
“Что в моём репозитории реестра?”
Просматривайте и читайте файлы .beancount, не покидая редактор.
Что умеет ИИ
Сервер предоставляет четыре инструмента для реестра. ИИ комбинирует их: обнаружьте структуру файлов, читайте для контекста, запрашивайте ответы, предлагайте правки.
runBqlQuery
Выполняйте запросы BQL (Beancount Query Language) к балансам, транзакциям и счетам.
listLedgerFiles
Просматривайте структуру каталогов вашего репозитория бухгалтерской книги.
readLedgerFiles
Читайте содержимое ваших .beancount-файлов и других документов бухгалтерской книги.
editLedgerFiles
Создавайте, обновляйте, заменяйте или удаляйте файлы в атомарном git-коммите.
Подключитесь меньше чем за минуту
Выберите свой ИИ-клиент. Скопируйте. Вставьте. Спросите.
- Выполните эту одну команду в терминале.
- Claude Code откроет окно браузера — войдите и выберите, какую бухгалтерскую книгу подключить.
- Подтвердите один раз. Учетные данные автоматически обновляются отсюда.
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? Зарегистрируйтесь на beancount.io — ваша бухгалтерская книга в одном git push.
Ваша бухгалтерская книга под защитой
ИИ с правом записи в ваши книги заслуживает доверия через дизайн, а не обещания.
OAuth 2.1 с ограничением по бухгалтерской книге
Одна сессия авторизована ровно для одной бухгалтерской книги. Сессия для вашей личной книги не может коснуться вашей деловой книги — радиус поражения ограничен.
Каждое изменение — это git-коммит
Изменения фиксируются как реальные коммиты ("AI edit: …") в репозитории вашей книги учёта — полный журнал аудита, который можно просмотреть и откатить стандартными git-инструментами.
Предпросмотр в режиме dry-run
editLedgerFiles поддерживает режим dry_run, который проверяет и показывает точные изменения без записи, так что ваш клиент может сначала показать вам diff.
Сервер без состояния
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 и выберите книгу учёта, к которой вы хотите предоставить доступ. Клиент автоматически сохраняет и обновляет учётные данные.
Что именно ИИ может делать с моей книгой учёта?
Сервер предоставляет четыре инструмента: runBqlQuery выполняет запросы Beancount Query Language, listLedgerFiles просматривает репозиторий вашей книги учёта, readLedgerFiles читает ваши документы книги учёта, а editLedgerFiles создаёт, обновляет или удаляет файлы в атомарном git-коммите. ИИ комбинирует их, чтобы отвечать на вопросы и предлагать изменения.
Может ли ИИ изменять мою книгу учёта без моего ведома?
Изменения проходят через инструмент editLedgerFiles, который хорошо ведущие себя MCP-клиенты показывают вам перед выполнением. Режим dry_run предварительно просматривает точные изменения без записи, и каждое зафиксированное изменение — это настоящий git-коммит — полный журнал аудита, который можно откатить стандартными git-инструментами.
Передаются ли мои данные третьим лицам?
Данные вашей книги учёта проходят через серверную часть Web Beancount, которая уже управляет вашей книгой учёта, и возвращаются в виде структурированных результатов вашему ИИ-клиенту. Сеансы ограничены книгой учёта: каждый из них может получить доступ только к той книге, которую вы авторизовали, и MCP-сервер не хранит ничего, кроме того, что уже находится в разговоре вашего ИИ-клиента.
Интересно, как это устроено? Прочитайте инженерный FAQ в блоге
Ваши данные бухгалтерского учёта встречаются с вашим ИИ-рабочим процессом
Beancount MCP-сервер уже доступен всем пользователям Web Beancount. Ваша книга учёта — это один git push.