Beancount.io — MCP-сервер для Claude Code: запросы к бухгалтерскому
Подключает ИИ-агента к размещённому реестру Beancount: запросы на BQL, отчёты, файлы и импорт банковских выписок.
claude mcp add --transport http beancount https://beancount.io/api-gateway/mcpЧто делает Beancount.io
Beancount.io — это MCP-сервер, который даёт агенту доступ к вашему размещённому реестру Beancount. Через него можно выполнять запросы на BQL, получать отчёты, работать с файлами и запускать импорт банковских выписок — всё это прямо из диалога с агентом, без переключения в веб-интерфейс.
Сервер работает по HTTP и подключается одной командой. Для Claude это claude mcp add --transport http beancount https://beancount.io/api-gateway/mcp. Аналогичные команды есть для Codex, Cursor, GitHub Copilot и Gemini CLI. Транспорт — HTTP, поэтому отдельный процесс запускать не нужно.
Для работы нужен персональный токен доступа: он доступен на платных планах. Создайте его в настройках и передайте агенту — без токена сервер не авторизует запросы к реестру. Токен показывается один раз, храните его в менеджере секретов.
Какие задачи решает
- выполнить запрос на BQL к реестру из диалога с агентом
- получить финансовый отчёт без открытия веб-интерфейса
- импортировать банковскую выписку в реестр
- посмотреть и отредактировать файлы реестра через агента
- сверить данные в реестре с банковскими операциями
Примеры запросов агенту
- Покажи все счета с ненулевым балансом за этот месяц
- Импортируй выписку из файла
statement.csvв реестр - Сверь последние транзакции с банковской выпиской
Как установить Beancount.io
Командой платформы: удалённый сервер
claude mcp add --transport http beancount https://beancount.io/api-gateway/mcpКомандой платформы: удалённый сервер
codex mcp add backend-v2 --url https://beancount.io/api-gateway/mcpФайл настроек
{
"mcpServers": {
"backend-v2": {
"url": "https://beancount.io/api-gateway/mcp"
}
}
}Файл настроек
{
"servers": {
"backend-v2": {
"type": "http",
"url": "https://beancount.io/api-gateway/mcp"
}
}
}Командой платформы: удалённый сервер
gemini mcp add -t http backend-v2 https://beancount.io/api-gateway/mcpПо шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о Beancount.io
Как установить Beancount.io в Claude Code?
Выполните claude mcp add --transport http beancount https://beancount.io/api-gateway/mcp. Сервер подключится по HTTP, отдельный процесс запускать не нужно.
Что делает Beancount.io?
Даёт агенту доступ к размещённому реестру Beancount: запросы на BQL, отчёты, файлы и импорт банковских выписок.
Нужен ли токен для работы?
Да, персональный токен доступа. Он доступен на платных планах, создаётся в настройках и показывается один раз.