MCP: платформа как сервер
Conveyor: MCP-сервер. Платформа отдаёт endpoint POST /mcp (Streamable HTTP, JSON-RPC): агент или IDE подключаются к платформе, получают каталог инструментов и вызывают их. Процесс с включённым MCP-триггером появляется в каталоге как отдельный инструмент. Дополнительно доступны встроенные инструменты flowforge_* для управления процессами и Запусками.
На какие вопросы отвечает раздел: Как агент подключается к Conveyor? Как процесс становится MCP-инструментом? Что ещё есть в
tools/list? Где взять URL и ключ?
Модель: сервер на стороне платформы
| Роль | Кто |
|---|---|
| MCP-сервер | Conveyor (/mcp) |
| MCP-клиент | IDE, агент, скрипт с MCP-клиентом |
| Инструменты | встроенные flowforge_* + ваши процессы с MCP-триггером |
Клиент подключается к POST /mcp с Bearer JWT или ключом afk_* (область mcp). В tools/list — восемь встроенных flowforge_* и ваши процессы с MCP-триггером; новый инструмент появляется после публикации процесса с включённым триггером.
Как процесс становится MCP-инструментом
- Граф: узел «Входные данные триггера» (обязателен для webhook, cron и MCP).
- Webhook в настройках процесса. Переключатель MCP в редакторе доступен только при включённом webhook.
- MCP: задайте имя инструмента (латиница,
a-z,0-9,_) и описание для агента. - Сохраните процесс. Он появится в
tools/listи в панели «Документация ваших интеграций».
Имя в каталоге берётся из настроек. Если имя не задано или невалидно, сервер использует техническое flow_diagram_<uuid>. Вызов по пользовательскому имени и по каноническому имени поддерживается.
Поля входа инструмента строятся из порта узла «Входные данные триггера»; опциональный аргумент await (число, миллисекунды) управляет ожиданием завершения Запуска при вызове.
Процессы без MCP-триггера в каталоге инструментов не появляются.
Встроенные инструменты (flowforge_*)
Помимо процессов, tools/list всегда включает встроенные инструменты платформы:
| Имя | Назначение |
|---|---|
flowforge_process_create | Создать процесс (диаграмму) |
flowforge_process_validate | Проверить триггеры и граф |
flowforge_executor_search | Поиск исполнителей в библиотеке по намерениям |
flowforge_process_start | Запуск по ручному триггеру |
flowforge_process_set_active | Включить или выключить процесс |
flowforge_run_status | Статус Запуска и узлов |
flowforge_run_result | Результат завершённого Запуска |
flowforge_run_wait | Ждать завершения Запуска (с таймаутом) |
В панели «Документация ваших интеграций» отображаются только ваши процессы с MCP-триггером; полный каталог — через tools/list на endpoint.
Endpoint и протокол
- URL:
POST /mcp(JSON-RPC); при необходимостиGET /mcp(text/event-streamдля Streamable HTTP). - Методы:
initialize,tools/list,tools/call(уведомления клиента принимаются). - Ревизии протокола:
2025-11-25,2025-06-18,2025-03-26,2024-11-05. Версия согласуется приinitialize(параметрprotocolVersionи/или заголовокMCP-Protocol-Version). - Аутентификация: Bearer JWT или ключ
afk_*с областью mcp. При необходимости заголовокX-MCP-Token. Ключ с областью mcp может быть ограничен списком процессов: тогда доступны только связанные диаграммы.
Список ваших процессов-инструментов (имя, описание, схема входа) и URL endpoint: раздел «Внешние инструменты» редактора.
Подключение MCP-клиента (агента)
- Опубликуйте нужные процессы (MCP-триггер, имя и описание).
- Создайте ключ с областью mcp (см. Работа с API) или используйте JWT сессии.
- Скопируйте MCP-endpoint из «Документации ваших интеграций».
- В настройках MCP-клиента (Cursor, Claude Desktop, свой агент) укажите URL платформы
/mcpи токен. - Клиент выполняет
initialize→tools/list→tools/callна этом endpoint.
Агент видит встроенные flowforge_* и ваши процессы; выбор инструмента опирается на описание и имя в каталоге.
Дальше
- Работа с API: ключи запуска, webhook и REST.
- Опубликовать процесс как MCP-инструмент: пошаговый рецепт.
- Настройки процесса: триггеры webhook и MCP.