Що таке MCP

MCP (Model Context Protocol) — це відкритий протокол, який дозволяє AI-помічникам підключатися до зовнішніх сервісів і працювати з їхніми даними. Finmap надає власний MCP-сервер, тож будь-який помічник із підтримкою MCP може під’єднатися до вашого акаунту й звертатися до даних Finmap напряму.

Після підключення помічник отримує доступ до ваших операцій, рахунків, категорій, проєктів і контрагентів та може працювати з ними за запитами природною мовою — без ручного експорту чи роботи через інтерфейс.

Оскільки MCP — стандарт, а не окрема програма, ви не прив’язані до одного інструмента: підключення працює з будь-яким помічником, що підтримує протокол.

Де це у Finmap

Налаштування Finmap, блок «Розробникам» – АРІ – https://my.finmap.online/settings/api

Як підключити

Послідовність однакова для будь-якого помічника: додати конектор Finmap і авторизувати його вашим API-ключем.

  1. Скопіюйте API-ключ із Finmap (Finmap → Settings → API keys).
  2. У помічнику відкрийте розділ підключень (конектори / MCP) і додайте Finmap.
  3. Вставте API-ключ для авторизації — підключення готове.

Увесь публічний API Finmap також доступний як MCP-сервер (Model Context Protocol), тож AI-помічники на кшталт Claude можуть читати ваші дані Finmap і керувати ними за вашими запитами: рахунки, операції, інвойси, контрагенти, категорії, проєкти тощо.

Адреса MCP-сервера: https://api.finmap.online/mcp

Підключення з Claude

  1. У Claude перейдіть у Settings → Connectors → Add custom connector.
  2. Вставте наведену вище адресу й натисніть Connect (додаткові поля залиште порожніми).
  3. Коли відкриється сторінка Finmap, введіть свій API-ключ — той самий, який ви використовуєте для API (Finmap → Settings → API keys).

Конектор працює з будь-яким MCP-клієнтом, що підтримує Streamable HTTP з OAuth. Усі права доступу, ліміти запитів і обмеження тарифу вашого API-ключа застосовуються до MCP-викликів так само, як і до звичайного API.

Для чого це можна використати

Підключення підходить для довільної роботи з вашими даними природною мовою: побудова власних графіків і візуалізацій, зведення та аналітика по своїх показниках, пошук конкретних операцій і контрагентів, а також будь-які запитання по даних Finmap без ручних вигрузок.

Джерело правди — Finmap. Помічник формує відповіді зі списку операцій, тому на великих періодах можлива розбіжність. Якщо цифри не збігаються — вірна та, що у Finmap. Готові звіти (кешфлоу, P&L, план-факт) залишаються у Finmap на відповідному тарифі.

Безпека

Підключення працює під вашим API-ключем і має доступ до даних компанії, тому не передавайте ключ стороннім. Відкликати його можна в налаштуваннях Finmap будь-коли — після цього підключення перестає працювати.

Через MCP помічник може не лише читати, а й змінювати дані, тому формулюйте запити явно — «покажи», а не «розберись з моїми операціями».

Питання по налаштуванню — напишіть у підтримку Finmap.