---
title: "Як налаштувати MCP Tool для стартової ноди"
description: "Інструкція налаштування тригера MCP Tool для стартової ноди — Input Schema, Return Schema, підключення AI-асистента."
---

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

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

- [x] Ви увійшли з правами інтегратора або адміністратора.
- [x] У вас є секція з логікою, яку потрібно викликати з AI.
- [x] 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 (рекомендовано).

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

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

Параметри з’являться як константи в сценарії (наприклад, `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](/uk/scenariodialog/how-to/connect-ai-assistant-mcp.md).

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

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

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

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

Блок **Підключення до Fast Line Pro** з’являється, коли для інстансу увімкнено **Scenario MCP ↔ FLP agent binding**. Альтернатива — **Додати MCP Tool зі сценарію** на картці агента. Детальніше — [Прив'язати MCP Tool секцію до агента](/uk/fastlinepro/how-to/bind-scenario-mcp-tool-to-agent.md).

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

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

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

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

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

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

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

- [Що таке стартова нода](/uk/scenariobuilder/explanation/what-is-start-node.md)
- [Підключити AI-асистента через MCP](/uk/scenariodialog/how-to/connect-ai-assistant-mcp.md)
- [Налаштувати параметри MCP Tool](/uk/scenariodialog/how-to/configure-mcp-tool-parameters.md)
- [Прив'язати MCP Tool секцію до агента Fast Line Pro](/uk/fastlinepro/how-to/bind-scenario-mcp-tool-to-agent.md)
- [Налаштувати тригери стартової ноди](/uk/scenariobuilder/how-to/configure-start-node-triggers.md)