Опубликовать процесс как MCP-инструмент

Рецепт: сделать существующий процесс видимым для MCP-клиента (IDE, агент) через каталог инструментов платформы.

Задача: опубликовать процесс как MCP-инструмент. Результат: инструмент в tools/list на /mcp, агент может вызвать процесс по имени.

Conveyor выступает MCP-сервером. Инструмент в каталоге соответствует процессу с MCP-триггером, именем и описанием. Вызов внешних API из шага процесса настраивается через плагины.

Когда применять

• агент в IDE должен запускать ваш процесс по описанию в каталоге;
• нужно стабильное своё имя инструмента (не flow_diagram_<uuid>);
• тот же процесс уже вызывается по webhook, и вы добавляете MCP как второй канал.

Перед началом

• доступ к редактору Conveyor и право настройки триггеров процесса;
• понимание модели MCP (см. MCP: платформа как сервер).

Шаги

1. Подготовьте граф. Откройте процесс на канвасе и добавьте узел «Входные данные триггера». Поля его порта станут аргументами MCP-инструмента.
2. Включите webhook. На вкладке «Процессы» раскройте «Настройки процесса» в правой панели. Включите переключатель webhook. Переключатель MCP доступен только при включённом webhook (см. настройки процесса).
3. Включите MCP. Задайте имя инструмента (run_my_flow) и короткое описание для агента: что делает инструмент и что возвращает. Нажмите «Сохранить» в панели настроек.
4. Проверьте каталог. Откройте «Документация ваших интеграций». В секции MCP сверьте имя, описание и схему входа.
5. Подключите клиент. Укажите endpoint /mcp, JWT или ключ afk_* с областью mcp. В клиенте выполните tools/list и tools/call с именем вашего инструмента.

Проверка результата

• процесс виден в секции MCP панели интеграций и в tools/list на /mcp;
• вызов по заданному имени создаёт Запуск (triggerSource: mcp_tool);
• без await в аргументах вызов асинхронный (runId, accepted: true);
• с await клиент ждёт завершения Запуска в рамках таймаута.

Связанное

• MCP: платформа как сервер
• Настройки процесса
• Работа с API: ключи с областью mcp