Підтримувані клієнти
ChatGPT, Claude, Claude Code та інші клієнти, які підтримують MCP через stdio або HTTP transport.
MCP
MCP інтеграція Guru Money
Guru Money має окремий MCP server для ChatGPT, Claude та інших AI-клієнтів. Він працює поверх API, а не напряму з базою даних, що спрощує контроль доступу і зберігає єдину бізнес-логіку.
Як зараз зроблено доступ
У поточній моделі зручно використовувати персональний MCP key, який привʼязаний до особистого Guru Money access token. Це дозволяє AI-клієнту працювати від імені конкретного користувача.
Транспорт
Підтримуються два режими: локальний 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 у сценаріях, де Bearer auth недоступний.
- У legacy/shared режимі може використовуватися окремий edge token, але рекомендований варіант зараз саме персональний.
Що вміє MCP шар
- Читати session, workspaces, рахунки, категорії, ліміти та транзакції.
- Працювати з банківськими підключеннями, включно з Monobank flow.
- Створювати окремі фінансові дії через API-обмежений інтерфейс.
Чому це зручно
MCP-сервер є thin layer поверх `api`, тому не дублює money logic і не ходить напряму в SQL. Це робить інтеграцію безпечнішою, простішою для супроводу і зрозумілішою з точки зору прав доступу.
Для публічного використання також окремо доступні health endpoint, документація з деплою та опис production-моделі за Traefik.