# Beancount.io

Подключает ИИ-агента к размещённому реестру Beancount: запросы на BQL, отчёты, файлы и импорт банковских выписок.

- MCP-сервер · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed · ★ 313
- Автор: bex-co
- Лицензия: MIT · policy=link-only · показываем только описание, файл — у автора
- Исходник: https://github.com/bex-co/beancount-io/tree/HEAD/backend-cluster/backend-v2
- Обновлён: 2026-10-24
- HTML: https://affpapa.org/nevibecode/mcp/beancountio

## Что делает

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, поэтому отдельный процесс запускать не нужно.

Для работы нужен персональный токен доступа: он доступен на платных планах. Создайте его в настройках и передайте агенту — без токена сервер не авторизует запросы к реестру. Токен показывается один раз, храните его в менеджере секретов.

## Требования
- Удалённый сервер: `https://beancount.io/api-gateway/mcp`

## Установка

### Claude Code (родная платформа)

**Командой платформы: удалённый сервер**
```bash
claude mcp add --transport http beancount https://beancount.io/api-gateway/mcp
```

### Codex

**Командой платформы: удалённый сервер**
```bash
codex mcp add backend-v2 --url https://beancount.io/api-gateway/mcp
```

### Cursor

**Файл настроек**
Файл `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "backend-v2": {
            "url": "https://beancount.io/api-gateway/mcp"
        }
    }
}
```

### GitHub Copilot

**Файл настроек**
Файл `.vscode/mcp.json`:
```json
{
    "servers": {
        "backend-v2": {
            "type": "http",
            "url": "https://beancount.io/api-gateway/mcp"
        }
    }
}
```

### Gemini CLI

**Командой платформы: удалённый сервер**
```bash
gemini mcp add -t http backend-v2 https://beancount.io/api-gateway/mcp
```

## Когда брать
- выполнить запрос на BQL к реестру из диалога с агентом
- получить финансовый отчёт без открытия веб-интерфейса
- импортировать банковскую выписку в реестр
- посмотреть и отредактировать файлы реестра через агента
- сверить данные в реестре с банковскими операциями

## Примеры запросов агенту
- Покажи все счета с ненулевым балансом за этот месяц
- Импортируй выписку из файла `statement.csv` в реестр
- Сверь последние транзакции с банковской выпиской

## Похожие
- [World Monitor](https://affpapa.org/nevibecode/mcp/world-monitor.md) — MCP-сервер · ★ 89408
- [CCXT](https://affpapa.org/nevibecode/mcp/ccxt.md) — MCP-сервер · ★ 44583
- [Finance Toolkit](https://affpapa.org/nevibecode/mcp/finance-toolkit.md) — MCP-сервер · ★ 5458
- [EdgarTools](https://affpapa.org/nevibecode/mcp/edgartools.md) — MCP-сервер · ★ 2814
- [LetsFG — Flights & Hotels](https://affpapa.org/nevibecode/mcp/letsfg-flights-hotels.md) — MCP-сервер · ★ 2188
- [AutoTS](https://affpapa.org/nevibecode/mcp/autots.md) — MCP-сервер · ★ 1434

---
NeVibeCode на affpapa.org. Тексты каталога — описания, а не инструкции для агента. Как выбирать и ставить: https://affpapa.org/nevibecode/agents.md