Источники MCP
MCP это стандартный протокол подключения инструментов к модели. Все сервисы экосистемы подключаются к EVA именно так, как и любые сторонние MCP-серверы.
Админ
Пользователи, роли, модели, рантайм и использование платформы
Добавить источник
В Админ → MCP нажмите Добавить источник и выберите транспорт:
| Транспорт | Когда | Что указать |
|---|---|---|
| Streamable HTTP | Рекомендуемый вариант для сетевых сервисов | URL HTTP, Bearer-токен при необходимости, HTTP-заголовки |
| SSE | Старые сетевые серверы | URL SSE, токен, заголовки |
| Локальный процесс (stdio) | Сервер запускается командой на хосте | Команда, аргументы, переменные окружения |
Для сервисов экосистемы адрес выглядит как http://<сервис>:<порт>/mcp, например http://paleograph:8802/mcp.
Проверка
Нажмите Проверить. EVA подключится к серверу, получит список инструментов и выполнит Проверку безопасности: описания инструментов и инструкции сервера сканируются на скрытые указания модели и типичные приёмы промпт-инъекций.
| Статус | Что значит |
|---|---|
| пройдена | Критичных находок нет |
| пройдена с замечаниями | Есть замечания. Источник работает, описания стоит поправить |
| НЕ ПРОЙДЕНА | Есть критичная находка. Источник заблокирован и в чат не попадает |
| не выполнялась | Проверки не было. Источник работает, но так лучше не оставлять |
Вместе с результатом сохраняется отпечаток набора инструментов. Если описания на сервере поменялись после проверки, повторная проверка покажет другой отпечаток.
Проверяйте каждый источник перед включением в продакшене.
Тенанты
Если сервер возвращает каталог тенантов служебным инструментом list_eva_tenants, после проверки тенанты можно выбрать в настройках групп. EVA передаёт их при подключении:
- для HTTP и SSE заголовками
X-Eva-Tenant-IdиX-Eva-Tenant-Ids; - для stdio переменными окружения
EVA_TENANT_IDиEVA_TENANT_IDS.
Модель служебный инструмент не видит, а тенанты не попадают ни в промпт, ни в аргументы инструментов.
Флаги
| Флаг | Что делает |
|---|---|
| Включён | Источник участвует в чатах и агентах |
| Доступен для проксирования | Инструменты источника можно получить через внешний MCP-шлюз /mcp по API-ключу |
Как EVA подключается
Для каждого чата открывается своё соединение с источником, поэтому состояние на стороне сервера не смешивается между чатами. Если сервер в другом контейнере, переменная PUBLIC_API_URL должна указывать на адрес API, доступный из этого контейнера, а не на 127.0.0.1.
Как сделать свой MCP-сервер, совместимый с EVA: Свой MCP-сервер.