MCP-узлы
MCP-сервер Nodul позволяет внешним ИИ-системам (ИИ-агентам) запускать ваши сценарии как инструменты. Model Context Protocol (MCP) — это стандарт коммуникации между ИИ-системами и внешними системами, позволяющий им взаимодействовать путём определения конечных точек и предоставления аутентификации.
С помощью Nodul MCP вы можете предоставить доступ к своим сценариям для ИИ-клиентов, таких как Claude Desktop, Cursor или любое MCP-совместимое приложение.
MCP Trigger
MCP Trigger превращает ваш сценарий в MCP-сервер. Каждый узел, подключённый напрямую к MCP Trigger, становится отдельным инструментом, который ИИ-клиенты могут обнаруживать и вызывать.
Настройки сервера
| Параметр | Описание |
|---|---|
| Server Description | Описание вашего MCP-сервера для контекста ИИ |
| Server URL | Скопируйте этот URL для использования в вашем MCP-клиенте. |
| Version | Идентификатор версии (любой текст, например, 1.0) |
| Authentication | Включите для требования API-ключа для доступа |
Конфигурация инструмента
Каждый узел, подключённый к MCP Trigger, становится инструментом. Настройте его в параметрах первого подключённого узла:
| Параметр | Описание |
|---|---|
| Tool Name | Обязательно. Уникальный идентификатор инструмента (например, create_lead, send_email) |
| Tool Description | Описание, помогающее ИИ понять, когда использовать этот инструмент |
⚠️ Важно: Без Tool Name инструмент не будет виден ИИ-клиентам.
Входные параметры
Параметры определяют, какие данные ИИ будет передавать при вызове инструмента.
| Поле | Описание |
|---|---|
| Key | Имя параметра (например, email, user_name) |
| Type | Выберите fromMCP для параметров, заполняемых ИИ |
| Description | Объяснение для ИИ — какие данные передавать |
Пример — параметры инструмента создания лида:
| Key | Type | Description |
|---|---|---|
| name | fromMCP | Имя контакта |
| fromMCP | Email контакта | |
| phone | fromMCP | Номер телефона (опционально) |
Несколько инструментов
Вы можете создать неограниченное количество инструментов в одном MCP-сервере, подключив несколько веток к MCP Trigger.
Каждая ветка:
- Имеет собственные Tool Name и Description
- Может содержать любое количество узлов
- Может использовать условия, циклы, ИИ-агентов и любые другие узлы Nodul
- Работает независимо
Автоматическая маршрутизация
При подключении узлов к MCP Trigger автоматически создаётся фильтр связи. Этот фильтр направляет запросы к нужной ветке инструмента.
ℹ️ Фильтр генерируется автоматически и не редактируется.
MCP Response
По умолчанию выходные данные последнего узла в цепочке инструмента возвращаются ИИ-клиенту. Часто это включает ненужные данные, такие как заголовки или коды статуса.
MCP Response позволяет точно указать, какие данные возвращать.
Когда использовать
- Вернуть только определённые поля (например, только
bodyиз HTTP-ответа) - Создать собственную структуру ответа
- Скрыть технические детали от ИИ
Настройка
Укажите данные для возврата, используя переменные из предыдущих узлов.
Пример: Простой Echo-инструмент
Шаг 1: Добавьте MCP Trigger
- Создайте новый сценарий
- Добавьте узел MCP Trigger
- Установите Server Description:
Тестовый MCP-сервер
Шаг 2: Настройте инструмент
- Подключите узел Code к MCP Trigger
- Установите Tool Name:
echo - Установите Tool Description:
Возвращает предоставленный текст. Используйте для тестирования. - Добавьте параметр:
- Key:
message - Type:
fromMCP - Description:
Текст для возврата
- Key:
Шаг 3: Верните результат
В узле Code:
return {
result: msg.message
}Шаг 4: Разверните
- Сохраните сценарий
- Скопируйте URL из MCP Trigger
- Подключитесь к вашему MCP-клиенту
Лучшие практики
Описания
Пишите понятные описания, чтобы ИИ понимал, когда и как использовать ваши инструменты.
✅ Хорошо:
Создаёт задачу в Asana. Принимает название задачи и опциональный дедлайн.
Возвращает ID созданной задачи и ссылку.❌ Плохо:
Создаёт задачуПараметры
- Используйте описательные имена (
user_email, а неparam1) - Указывайте ожидаемый формат в описании (
Дата в формате YYYY-MM-DD) - Отмечайте опциональные параметры
Данные ответа
- Возвращайте только необходимые данные через MCP Response
- Избегайте раскрытия технических деталей
- Структурируйте ответы для удобства ИИ
Ограничения
- MCP использует SSE (Server-Sent Events) — требуется стабильное соединение
- Время выполнения инструмента ограничено таймаутом сценария
- Бинарные данные (файлы, изображения) требуют дополнительной обработки