Плагины
API и MCP
Контракты, HTTP API и MCP-сервер платформы для интеграции с Conveyor.
Принципы API
- контракты шагов проверяются до запуска процесса;
- входы и выходы попадают в Трассировку Запуска как результаты выполнения шагов;
- плагины подключаются как отдельные сервисы; MCP-каталог расширяется публикацией процессов с MCP-триггером.
HTTP API
Базовый URL в demo: http://localhost:8080/api/v1. Префикс контроллера Запусков — /flow.
| Метод | Путь | Назначение |
|---|---|---|
POST | /flow/{diagramId}/start | Создание Запуска |
POST | /flow/{diagramId}/webhook | Webhook-триггер |
GET | /flow/{diagramId}/runs | Список Запусков диаграммы |
GET | /flow/{diagramId}/runs/{runId} | Статус и метаданные Запуска |
GET | /flow/{diagramId}/runs/{runId}/result | Финальный результат завершённого Запуска |
GET | /flow/{diagramId}/runs/{runId}/nodes/{nodeId}/payload | Payload узла Запуска |
POST | /flow/{runId}/step/{stepId}/result | Ручная фиксация результата шага (executionId из события) |
GET | /flow/awaiting-validations | Узлы со статусом awaiting |
POST | /flow/{diagramId}/runs/{runId}/stop | Остановка Запуска |
Полная спецификация OpenAPI поставляется вместе с дистрибутивом. Персональный OpenAPI для webhook-процессов: в редакторе, раздел «Документация ваших интеграций».
MCP
Conveyor является MCP-сервером: endpoint POST /mcp (Streamable HTTP, JSON-RPC). MCP-клиент (IDE, агент) подключается к платформе, получает каталог через tools/list и вызывает инструменты через tools/call.
- Каталог:
tools/list— встроенныеflowforge_*и процессы с MCP-триггером; - Вызов:
tools/callпо имени инструмента; - Аутентификация: Bearer JWT или ключ
afk_*с областью mcp.
Подробнее: MCP: платформа как сервер. Пошаговая публикация процесса: Cookbook.
Аутентификация
В demo используется локальный ingress-токен. В production — CIDR allowlist, ingress-токен и при необходимости mTLS между плагинами (см. «Безопасность»).