API-ключи

Как выдать ключ для внешней интеграции: скрипта, CI, IDE или другого сервиса. Что открывает ключ и как ограничить его доступ к MCP.

API-ключ даёт внешнему клиенту доступ к двум интерфейсам платформы:

• OpenAI-совместимому API /v1: список моделей, Chat Completions, Responses;
• MCP-шлюзу /mcp: инструменты выбранных источников MCP по протоколу Streamable HTTP.

Не путайте его с ключами провайдеров моделей: те задаются в Админ → Модели и наружу не выдаются.

Создание

1. В Админ → API-ключи нажмите Создать ключ.
2. Укажите название, например «IDE» или «CI отчётов».
3. В поле MCP-источники для gateway выберите источники, которые будут доступны по ключу.
4. Скопируйте токен. Он показывается только один раз.

Префикс ключа берётся из технического идентификатора платформы в брендинге, например eva_. После смены идентификатора уже выданные ключи продолжают работать.

Админ · API-ключи

EVAП

Админ

Пользователи, роли, модели, рантайм и использование платформы

+ Создать ключ

ПользователиРолиМоделиMCPПакетыAPI-ключиРантаймНастройкиИспользование

Ключи для OpenAI-совместимого API (/v1) и MCP gateway (/mcp). Токен показывается один раз при создании.

НазваниеПрефиксMCPСозданCI-ботeva_a1b2••••212.10.2026IDE разработчикаeva_c3d4••••418.10.2026

Креды для подключения

Base URL https://eva.example.com

Auth Authorization: Bearer eva_••••

Тип API OpenAI-compatible HTTP + MCP Streamable HTTP

Chat completions

curl https://eva.example.com/v1/chat/completions \
  -H "Authorization: Bearer $EVA_KEY" \
  -d '{"model":"qwen3-32b","messages":[...]}'

MCP конфигурация

CursorClaude

Что видно в MCP-шлюзе

Через /mcp по ключу видны инструменты только тех источников, которые одновременно:

• включены;
• помечены «Доступен для проксирования»;
• выбраны в списке ключа.

Пустой список означает, что шлюз не отдаст ни одного инструмента.

Пример подключения

curl -sS -H "Authorization: Bearer eva_..." https://eva.example.com/v1/models

curl -sS -H "Authorization: Bearer eva_..." -H "Content-Type: application/json" \
  https://eva.example.com/v1/chat/completions \
  -d '{"model":"<идентификатор у провайдера>","messages":[{"role":"user","content":"Привет"}]}'

Подробнее о внешних интерфейсах: Внешний API.

Рекомендации

• Отдельный ключ на каждую интеграцию, чтобы отзыв одного не ломал остальные.
• В списке MCP только то, что нужно интеграции.
• Скомпрометированный ключ сразу Отозвать.