Все ноды/Integrations/HTTP & Web

MCP-инструмент

Инструмент MCP через сохранённое подключение workspace (URL, auth, режим, tool).

MCP-инструментT
Run

Тип в графе: mcp_tool

ToolExec

Как попробовать

Инструменты MCP-сервера у агента

Подключение в режиме «Как инструмент»: агент получает весь набор инструментов сервера.

Вход
ИИ-агент
MCP-инструментT
LLM
Выход
  • Исполнение + данные
  • LLM
  • Расширение
  • Исполнение + данные + стрим
Нажмите «Скопировать ноды», откройте редактор и нажмите Ctrl+V на холсте.

Перед запуском выберите своё подключение или базу знаний — в графе стоит REPLACE_ME.

Как применять

Нода подключает внешний MCP-сервер — стандартный способ отдать модели чужой набор инструментов, не оборачивая каждый из них в свою ноду. Не путайте с Assistant MCP: там направление обратное — внешний агент управляет Flow, а здесь Flow выступает клиентом. Для обычного HTTP-API берите HTTP Request, а чтобы сделать инструментом собственный воркфлоу — WF tool.

Как это работает

В самой ноде задаётся только Подключение MCP. Адрес сервера, авторизация, режим работы и имя инструмента живут в интеграции типа MCP (Настройки → Интеграции); связь идёт по Streamable HTTP. Токен хранится в интеграции, а не в графе, поэтому одно подключение переиспользуется несколькими воркфлоу.

Режим работы, выбранный в интеграции, определяет порты ноды:

  • Как инструмент — у ноды только tool_out, который тянется в порт extensions ноды AI Agent. На запуске нода подключается к серверу, читает список его инструментов и отдаёт агенту весь набор сразу, вместе со схемами аргументов. Какой инструмент вызвать — решает модель.
  • Исполняемый — нода становится обычным шагом: вход Run, выход Success, а при включённом в интеграции переключателе «Выводить вывод ошибок» появляется и Error. В этом режиме обязательно Имя инструмента, а аргументы берутся из поля «Аргументы инструмента (JSON)» интеграции. На выход уходят tool_name, result и is_error.

Частые ошибки

  • Смена режима в интеграции после того, как рёбра проведены. Порты пересобираются, и старые связи исчезают — соединения придётся провести заново. Шаг, чья интеграция вернулась в режим «Как инструмент», падает с прямым сообщением.
  • Аргументы интеграции — не шаблон. Поле «Аргументы инструмента» разбирается как JSON и не рендерится через Jinja: подставить в него значение текущего запуска нельзя. Нужны разные аргументы на каждый запуск — используйте режим «Как инструмент» и дайте решать модели.
  • Невалидный JSON в аргументах. Шаг падает на разборе, до обращения к серверу.

Входы

ПортПроводДанныеПримечания
RuninputИсполнение + данныеexecute_data

Execution trigger (executable mode)

показывается, когда operation_mode ≠ "as_tool"

Выходы

ПортПроводДанныеПримечания
tool_outРасширениеlink_extension

Настройки

ПолеТипПо умолчаниюОписание
Подключение MCPconnection_idstring""

ID MCP-подключения workspace

подключение: mcp