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 и обязан передавать токен в заголовке X-MCP-Token: JWT сессии или ключ afk_* с областью mcp. Анонимные запросы не принимаются (401 Unauthorized). В tools/list — восемь встроенных flowforge_* и ваши процессы с MCP-триггером; новый инструмент появляется после публикации процесса с включённым триггером.
Токен обязателен для подключения. Одного URL
/mcpнедостаточно: в настройках MCP-клиента (Cursor, Claude Desktop, свой агент) добавьте заголовокX-MCP-Tokenсо значением JWT или ключаafk_*с областью mcp (см. Работа с API). Альтернатива: тот же токен вAuthorization: Bearer …. Без токена handshakeinitializeне выполнится.
Как процесс становится 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). - Аутентификация (обязательна): на каждый запрос, включая
initialize, передайте JWT или ключafk_*с областью mcp в заголовкеX-MCP-Token. Без токена ответ401. Допустима та же строка вAuthorization: Bearer …. Ключ с областью mcp может быть ограничен списком процессов: тогда доступны только связанные диаграммы.
Список ваших процессов-инструментов (имя, описание, схема входа) и URL endpoint: раздел «Внешние инструменты» редактора.
Подключение MCP-клиента (агента)
- Опубликуйте нужные процессы (MCP-триггер, имя и описание).
- Создайте ключ с областью mcp (см. Работа с API) или возьмите JWT из сессии редактора. Токен нужен до первого запроса к серверу.
- В настройках MCP-клиента укажите URL платформы (
…/mcp) и заголовокX-MCP-Tokenс JWT или ключомafk_*. URL без токена не подключится. - Клиент выполняет
initialize→tools/list→tools/callна этом endpoint.
Агент видит встроенные flowforge_* и ваши процессы; выбор инструмента опирается на описание и имя в каталоге.
Дальше
- Работа с API: ключи запуска, webhook и REST.
- Опубликовать процесс как MCP-инструмент: пошаговый рецепт.
- Настройки процесса: триггеры webhook и MCP.