Developer docs

Для разработчиков

Протокол, авторизация и совместимость для собственных MCP-клиентов.

Подключение

Каждое подключение изолировано по connectionId. Рекомендуемый flow передаёт авторизацию через локальную переменную окружения и заголовок MCP.

MCP endpoint

https://HOST/connections/<connectionId>/mcp

Для новых подключений используйте endpoint с connectionId. Установщик создаёт конфигурацию без сохранения секрета в проекте.

Authorization

Используйте текущий auth flow сервиса. Не передавайте секреты в URL, команды или файлы проекта.

Header

X-MCP-Authorization: <token>
INFO Рекомендуемый flow передаёт авторизацию через локальную переменную окружения и заголовок X-MCP-Authorization. Токен связан с connectionId.

OAuth и совместимость

Для совместимых клиентов сохранены OAuth 2.1, PKCE, Dynamic Client Registration (DCR) и Protected Resource Metadata (PRM). Они не требуются для установщика OpenCode, Codex или Claude Code.

OAuth 2.1PKCEDCRPRM

Контракт сервиса

Контракт помогает проверить, что клиент подключился к правильной версии Eventicious MCP.

/mcp/toolsMCP tools
/healthzHealth
DiscoveryСписок инструментов
2024-11-05MCP protocol

Health & discovery

Безопасные read-only endpoints, которые можно использовать в мониторинге и smoke-проверках.

GET /healthz GET /mcp GET /mcp/tools

Legacy compatibility

Legacy endpoint и header-based authentication поддержаны без изменения существующих интеграций.

NOTE Для новых интеграций используйте connection flow и не передавайте Eventicious credentials напрямую в клиент.