Як підключити AI-асистента до сценарію через MCP

Якщо ви хочете, щоб AI-асистент (наприклад Cursor або інший клієнт з підтримкою MCP) міг викликати секції вашого сценарію як інструменти, потрібно налаштувати секцію в Конструкторі та додати підключення в AI-клієнті. Ця інструкція допоможе зробити обидва кроки.

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

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

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

  • MCP Tool — тип тригера в точці входу секції; він робить секцію доступною як інструмент для AI-клієнтів.
  • Input Schema — опис вхідних параметрів інструменту (назви, типи), які AI-клієнт може передавати при виклику.
  • Return Schema — опис результату та перелік ключів, які платформа повертає з секції в MCP-відповіді.
  • Результат секції — щоб AI отримав корисні дані, секція має в кінці записати результат у спеціальну константу (це налаштовується через дію в сценарії).
  • Два способи підключення: платформа підтримує підключення з авторизацією через заголовки (рекомендовано) або через посилання з токеном у URL (альтернатива, якщо клієнт не вміє передавати заголовки). Різниця описана нижче.

Детальніше про принцип роботи: Про виклик секцій сценарію з AI-асистентів (MCP).

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

  • Ви увійшли в систему з правами інтегратора або адміністратора.
  • У вас є сценарій і секція, яку ви хочете викликати з AI-асистента (або ви готові створити нову секцію).
  • У вас є адреса платформи ConnectiveOne, токен доступу та ідентифікатор бота (їх надає адміністратор або ви отримуєте після входу в систему).

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

1. Налаштувати секцію як MCP-інструмент у Конструкторі

  1. Перейдіть до модуля Сценарій через меню та відкрийте потрібний сценарій бота.
  2. Виберіть секцію, яка буде «інструментом», або створіть нову секцію.
  3. Відкрийте ноду Старт (точку входу) цієї секції — у правій панелі з’явиться налаштування тригера.
  4. У типі тригера виберіть MCP Tool.
  5. Заповніть Input Schema — додайте параметри, які має приймати інструмент (наприклад, currency, date). Вкажіть назву, тип та за потреби опис.
  6. Заповніть Return Schema — опис інструменту для AI та перелік ключів результату, які потрібно повертати з секції.
  7. Переконайтеся, що в кінці логіки секції результат записується у спеціальну константу (через дію «зберегти в константу» або відповідний action). Без цього MCP-відповідь може бути порожньою.
  8. Збережіть зміни сценарію.

У редакторі є дві кнопки для копіювання конфігурації. Яку використовувати — залежить від способу підключення (див. крок 3).

2. Отримати дані для підключення

Для підключення AI-клієнта потрібні:

  • Адреса платформи — URL сервера ConnectiveOne (наприклад, для локальної розробки або бойового середовища). Адміністратор або налаштування платформи підкажуть точну адресу.
  • Токен доступу — отримується після входу в систему або через відповідні налаштування. Зберігайте його в безпечному місці.
  • Ідентифікатор бота — числовий ID бота, сценарій якого ви налаштували як MCP-інструмент. Його можна побачити в інтерфейсі при виборі бота або в URL редактора сценарію.

Якщо не впевнені, де взяти ці значення — зверніться до адміністратора платформи.

3. Додати MCP-сервер у AI-клієнті (наприклад Cursor)

Рекомендовано: підключення з авторизацією через заголовки (токен доступу та ідентифікатор бота). Альтернатива — посилання з токеном у URL — лише якщо клієнт не підтримує заголовки (див. абзац після кроку 3).

  1. Відкрийте налаштування MCP у вашому AI-клієнті (у Cursor це зазвичай файл конфігурації MCP або розділ налаштувань MCP).
  2. Додайте новий MCP-сервер з такими параметрами:
    • URL — адреса платформи + шлях до MCP-повідомлень (його можна взяти з інструкції платформи або з кнопки «Скопіювати конфіг» у Конструкторі).
    • Тип транспорту — HTTP (якщо клієнт це підтримує).
    • Заголовки — обов’язково вказати токен доступу та ідентифікатор бота у форматі, який вимагає платформа (наприклад, заголовок авторизації та заголовок з ID бота).
  3. Збережіть конфігурацію та перезавантажте MCP-клієнт (якщо потрібно).

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

Два способи конфігурації. Рекомендований — з заголовками (токен доступу та ідентифікатор бота), як описано вище; для цього використовуйте кнопку Скопіювати конфіг для .cursor/mcp.json. Якщо AI-клієнт не підтримує передачу заголовків, використовуйте кнопку Скопіювати конфіг з URL-токеном (без заголовків) — платформа згенерує посилання з вбудованим токеном. У такому разі посилання з токеном може потрапити в логи або бути передане третім особам; токен довгоживучий. Цей варіант використовуйте лише коли спосіб з заголовками неможливий і ви готові прийняти ці ризики.

4. Перевірити роботу

  1. У AI-клієнті переконайтеся, що з’явився новий MCP-сервер і список інструментів для вашого бота.
  2. Викличте один із інструментів (наприклад, з мінімальними параметрами) і перевірте, що відповідь повертається і містить очікувані дані.
  3. Якщо відповідь порожня — перевірте, чи в кінці секції результат записується у спеціальну константу і чи в Return Schema вказані потрібні ключі.

Що далі

  • Додайте інші секції як MCP-інструменти, якщо потрібно кілька типів викликів.
  • Оновлюйте Input Schema та Return Schema при зміні логіки секції, щоб AI-клієнт отримував актуальний опис та результати.
  • Якщо AI має передавати дані при виклику (місто, дату, ідентифікатор тощо) — налаштуйте параметри інструменту та їх використання в сценарії: Як налаштувати параметри MCP-інструменту сценарію.

Пов’язані статті