Як налаштувати MCP Tool для стартової ноди?

Тригер MCP Tool експонує секцію як інструмент для AI-асистентів (Cursor, Fastline тощо), підключених до платформи через MCP (Model Context Protocol). AI може викликати секцію, передаючи параметри, і отримувати результат.

Коли знадобиться

AI-асистент має отримати дані з ConnectiveOne (курс валют, каталог, перевірки).
Потрібно викликати вже налаштовану логіку сценарію з AI-клієнта без дублювання коду.
Використовується Cursor або інший застосунок з підтримкою MCP.

Що важливо знати

Input Schema — опис вхідних параметрів інструменту (назви, типи, обов’язковість). AI передає ці параметри при виклику.
Return Schema — опис результату та перелік ключів, які платформа повертає з секції в MCP-відповіді.
Константа результату — щоб AI отримав корисні дані, секція має в кінці записати результат у спеціальну константу (через дію «зберегти в константу»).
Параметри в сценарії — параметри з Input Schema автоматично створюються як константи з префіксом mcp_input_ і доступні як {{ mcp_param_name }}.

Перед початком

Ви увійшли з правами інтегратора або адміністратора.
У вас є секція з логікою, яку потрібно викликати з AI.
AI-клієнт підтримує MCP (Cursor, Fastline тощо).

Покрокова інструкція

1. Обрати тип тригера MCP Tool

Виберіть стартову ноду на полотні.
У Node Inspector у полі Тип тригера виберіть MCP Tool.

2. Заповнити Input Schema

Input Schema визначає параметри, які tool приймає від AI.

У блоці Input Schema натисніть Додати параметр.
Для кожного параметра вкажіть:
- Назва (name) — латиницею, наприклад currency, date, product_id.
- Тип (type) — string, number, boolean тощо.
- Обов’язковий (required) — чи параметр обов’язковий.
- Значення за замовчуванням (default) — опціонально.
- Опис (description) — короткий опис для AI (рекомендовано).

Приклад параметрів:

Назва	Тип	Обов’язковий	Опис
currency	string	так	Код валюти (USD, EUR, UAH)
date	string	ні	Дата у форматі YYYY-MM-DD

Параметри з’являться як константи в сценарії (наприклад, mcp_param_currency) і можна використовувати в нодах як {{ mcp_param_currency }}.

3. Заповнити Return Schema

Return Schema визначає, які ключі результату повертаються з секції.

У блоці Return Schema вкажіть Ключі (keys) — список назв ключів, які будуть у відповіді (наприклад, rate, date, source).
Додайте Опис (description) — короткий опис інструменту для AI.

4. Записати результат у константу

Критично: Без запису результату MCP-відповідь буде порожньою.

У кінці логіки секції додайте дію зберегти в константу або відповідний action.
Запишіть результат у константу, ключі якої відповідають Return Schema.
Переконайтеся, що ключі в Return Schema збігаються з тими, що записуються.

5. Скопіювати конфігурацію для AI-клієнта

У Node Inspector є дві кнопки:

Скопіювати конфіг для .cursor/mcp.json — конфігурація з авторизацією через заголовки (рекомендовано).
Скопіювати конфіг з URL-токеном — посилання з токеном у URL (якщо клієнт не підтримує заголовки).

Скопіюйте потрібний варіант і додайте його в конфігурацію MCP у вашому AI-клієнті.

6. Підключити AI-клієнта

Детальна інструкція з підключення: Підключити AI-асистента через MCP.

Коротко:

Відкрийте налаштування MCP у AI-клієнті.
Додайте MCP-сервер з URL та заголовками (або URL з токеном) з кроку 5.
Збережіть та перезавантажте MCP.

7. Підключити секцію до агента Fast Line Pro (опційно)

Якщо агент Fast Line Pro має викликати цю секцію в діалозі:

Збережіть секцію або сценарій.
У блоці Підключення до Fast Line Pro оберіть агентів і збережіть сценарій.
У Fast Line Pro відкрийте картку агента і натисніть Опублікувати.

Блок Підключення до Fast Line Pro з’являється, коли для інстансу увімкнено Scenario MCP ↔ FLP agent binding. Альтернатива — Додати MCP Tool зі сценарію на картці агента. Детальніше — Прив'язати MCP Tool секцію до агента.

Що відбувається після

AI-асистент бачить секцію як інструмент і може викликати його за назвою, передаючи параметри згідно з Input Schema. Відповідь містить ключі з Return Schema.

Як переконатися, що все працює

Перевірте, чи в AI-клієнті з’явився інструмент.
Викличте інструмент з мінімальними параметрами.
Якщо відповідь порожня — перевірте запис результату в константу та ключі в Return Schema.

Типові помилки

Проблема	Рішення
MCP повертає порожній результат	Додайте в кінці секції дію запису результату в константу. Перевірте, що ключі в Return Schema відповідають записуваним даним.
AI не бачить інструмент	Перевірте підключення MCP, токен, bot_id. Перезавантажте MCP-клієнт.
Параметри не підставляються	Переконайтеся, що використовуєте `{{ mcp_param_name }}` з правильними назвами (латиницею, lowercase).