MCP

MCP интеграция Guru Money

У Guru Money есть отдельный MCP server для ChatGPT, Claude и похожих AI-клиентов. Он работает поверх API, а не напрямую с базой данных, что сохраняет единую бизнес-логику и упрощает контроль доступа.

Рекомендуемая модель доступа

Сейчас наиболее удобный вариант это персональный MCP key, связанный с личным Guru Money access token. Так AI-клиент работает от имени конкретного пользователя, а не через один общий токен.

Поддерживаемые клиенты

ChatGPT, Claude, Claude Code и другие клиенты, которые умеют работать с MCP через stdio или HTTP.

Режимы транспорта

Поддерживаются оба варианта: локальный stdio и production-like HTTP за Traefik.

Техническая документация

Подробная документация доступна на https://docs.guru-money.com и в материалах репозитория по mcp-server.

Как устроена авторизация

В персональном режиме сервер читает `MCP_USER_TOKENS` и связывает MCP key с Guru Money access token.
Клиент может передавать `Authorization: Bearer <USER_MCP_TOKEN>` или использовать совместимый query token fallback.
Legacy shared режим остаётся, но предпочтительный вариант сейчас именно персональный доступ.

Что умеет MCP слой

Читать session, workspaces, счета, категории, лимиты и транзакции.
Работать с банковскими подключениями, включая Monobank flow.
Выполнять часть финансовых действий через слой инструментов поверх API.

Почему это удобно

MCP-сервис остаётся thin layer поверх `api`, не дублирует money logic и не требует прямого доступа к SQL.

Для production-сценария в проекте уже есть health endpoint, Traefik routing и документация по развёртыванию HTTP MCP сервиса.

Вернуться на главную