Як налаштувати 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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Коротко:

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

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

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

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

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

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

Пов'язані матеріали

• Що таке стартова нода
• Підключити AI-асистента через MCP
• Налаштувати параметри MCP Tool
• Налаштувати тригери стартової ноди