Содержание
Подключение Finmap к AI-помощнику (MCP)
MCP (Model Context Protocol) — это открытый протокол, который позволяет AI-помощникам подключаться к внешним сервисам и работать с их данными. Finmap предоставляет собственный MCP-сервер, поэтому любой помощник с поддержкой MCP может подключиться к вашему аккаунту и обращаться к данным Finmap напрям
Что такое MCP
MCP (Model Context Protocol) — это открытый протокол, который позволяет AI-помощникам подключаться к внешним сервисам и работать с их данными. Finmap предоставляет собственный MCP-сервер, поэтому любой помощник с поддержкой MCP может подключиться к вашему аккаунту и обращаться к данным Finmap напрямую.
После подключения помощник получает доступ к вашим операциям, счетам, категориям, проектам и контрагентам и может работать с ними по запросам на естественном языке — без ручного экспорта или работы через интерфейс.
Поскольку MCP — это стандарт, а не отдельная программа, вы не привязаны к одному инструменту: подключение работает с любым помощником, поддерживающим протокол.
Где это в Finmap
Настройки Finmap, блок «Разработчикам» → API → https://my.finmap.online/settings/api
Как подключить
Последовательность одинакова для любого помощника: добавить коннектор Finmap и авторизовать его вашим API-ключом.
- Скопируйте API-ключ из Finmap (Finmap → Settings → API keys).
- В помощнике откройте раздел подключений (коннекторы / MCP) и добавьте Finmap.
- Вставьте API-ключ для авторизации — подключение готово.
Весь публичный API Finmap также доступен как MCP-сервер (Model Context Protocol), поэтому AI-помощники вроде Claude могут читать ваши данные Finmap и управлять ими по вашим запросам: счета, операции, инвойсы, контрагенты, категории, проекты и т. д.
Адрес MCP-сервера
https://api.finmap.online/mcp
Пошаговые инструкции для популярных помощников:
Коннектор работает с любым MCP-клиентом, поддерживающим Streamable HTTP с OAuth. Все права доступа, лимиты запросов и ограничения тарифа вашего API-ключа применяются к MCP-вызовам так же, как и к обычному API.
Для чего это можно использовать
Подключение подходит для произвольной работы с вашими данными на естественном языке: построение собственных графиков и визуализаций, сведение и аналитика по своим показателям, поиск конкретных операций и контрагентов, а также любые вопросы по данным Finmap без ручных выгрузок.
Источник правды — Finmap. Помощник формирует ответы из списка операций, поэтому на больших периодах возможно расхождение. Если цифры не совпадают — верна та, что в Finmap. Готовые отчёты (кэшфлоу, P&L, план-факт) остаются в Finmap на соответствующем тарифе.
Примеры запросов
Аналитика и поиск
- «Покажи остатки на всех счетах на сегодня»
- «Сколько мы потратили на рекламу в сентябре по сравнению с августом?»
- «Какие инвойсы ещё не оплачены и на какую общую сумму?»
- «Построй график доходов по проектам за последние 6 месяцев»
- «Найди все операции с контрагентом "Альфа" за последний квартал»
Внесение данных
- «Добавь расход 1 200 грн в категорию "Аренда" со счёта ПриватБанк»
Безопасность
API-ключПодключение работает под вашим API-ключом и имеет доступ к данным компании, поэтому не передавайте ключ посторонним. Отозвать его можно в настройках Finmap в любой момент — после этого подключение перестаёт работать.
Изменение данныхЧерез MCP помощник может не только читать, но и изменять данные, поэтому формулируйте запросы явно — «покажи», а не «разберись с моими операциями».
Вопросы по настройке — напишите в поддержку Finmap.