# Як підключити 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)](/uk/scenariodialog/explanation/mcp-tools-scenario.md).

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

- Ви увійшли в систему з правами інтегратора або адміністратора.
- У вас є сценарій і секція, яку ви хочете викликати з 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-інструменту сценарію](/uk/scenariodialog/how-to/configure-mcp-tool-parameters.md).

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

- [Про виклик секцій сценарію з AI-асистентів (MCP)](/uk/scenariodialog/explanation/mcp-tools-scenario.md) — навіщо потрібні MCP-інструменти та як вони працюють.
- [Як налаштувати параметри MCP-інструменту сценарію](/uk/scenariodialog/how-to/configure-mcp-tool-parameters.md) — додати вхідні параметри та використовувати їх у сценарії.
- [Як використати action в сценарії](/uk/scenariodialog/how-to/use-action-in-scenario.md) — як додати дію для запису результату в константу.