Ваша учётная книга становится частью разговора.

MCP (Model Context Protocol) — это открытый стандарт, который позволяет ИИ-ассистентам вызывать внешние инструменты и источники данных структурированным и безопасным способом. Вместо того чтобы угадывать или просить вас вставить данные, ваш ИИ-клиент напрямую подключается к вашей книге учёта — он запрашивает ваши реальные данные, читает ваши фактические файлы и вносит точные изменения.

Любой 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 и возвращаются вашему ИИ-клиенту как результаты работы инструментов. Выбранная ИИ-модель тоже получает эти результаты, поэтому действуют и правила обработки данных её провайдера. Каждый авторизованный сеанс ограничен одной учётной книгой.