Skip to content
2.12.0

Источники MCP ​

Как подключить внешний 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-сервер.

Документация экосистемы EVA 2.1