MCP

Где подключаются сервисы-инструменты, что задаётся у источника, как платформа их проверяет и что видно по состоянию.

Как читать этот раздел

Раздел описывает, что находится на каждом экране администрирования и на что это влияет. Пошаговых указаний здесь нет: настройки в каждой установке свои, и менять их нужно осознанно, а не по инструкции.

Что на экране

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

Форма подключения источника

Кнопка Добавить источник внизу списка открывает форму.

Поле формы	Что задаёт
Название	Как источник называется в платформе. Влияет на имена инструментов для модели
Транспорт	Локальный процесс, Streamable HTTP или SSE
Команда	Только для локального процесса: что запускать
Аргументы: по одному на строку	Только для локального процесса. Можно писать и в одну строку, платформа разберёт сама
Переменные окружения: KEY=VALUE	Только для локального процесса
Описание	Необязательное, для себя
Включён	Выключенный источник не попадает ни в одно обращение модели
Доступен для проксирования	Разрешает обращаться к источнику через шлюз для внешних приложений по ключу API
Передавать доступ к файлам чата в init	Выдавать ли источнику временный ключ доступа к файлам чата

Про доступ к файлам чата

Этот переключатель нужен тем сервисам, которые работают с файлами: читают документ, пишут результат. Сервису, который только ищет в интернете, он не нужен. Выдавайте доступ только там, где он действительно требуется.

При выборе транспорта Streamable HTTP или SSE вместо команды и аргументов появляется поле адреса.

Что задаётся у источника

Поле	Что задаёт
Название	Как источник называется в платформе. Влияет на имена инструментов для модели
Транспорт	Способ подключения: запуск локального процесса, Streamable HTTP или SSE
Адрес или команда запуска	Куда подключаться либо что запускать
Токен доступа	Если сервис его требует. Хранится в зашифрованном виде
Включён	Выключенный источник не попадает ни в одно обращение модели
Доступ к файлам чата	Выдавать ли этому источнику временный ключ доступа к файлам чата
Доступ для внешнего шлюза	Разрешить ли обращаться к источнику через шлюз для внешних приложений
Режим адреса файлов чата	Внутренний, внешний или собственный адрес для этого источника

Переименование источника меняет имена инструментов

Платформа показывает модели инструменты под составными именами по правилу mcp_<имя источника>_<имя инструмента>. Переименование источника изменит имена всех его инструментов. Это может сломать запреты на инструменты, настроенные у агентов по старому имени.

Адрес должен быть доступен из контейнера сервиса

Ключ доступа к файлам чата содержит адрес, по которому сервис будет обращаться к платформе. Если сервис работает в своём контейнере, адрес 127.0.0.1 для него бесполезен. Режим адреса и общие настройки платформы позволяют это учесть.

Проверка на подмену поведения модели

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

Заблокированный источник исключается из работы

Если источник получил состояние «заблокирован», он не попадёт ни в одно обращение модели, даже будучи включённым.

Дополнительно платформа сохраняет отпечаток набора инструментов источника.

Сохранённый результат проверки не видно после перезагрузки страницы

Результат проверки безопасности хранится в базе, но не передаётся в интерфейс, поэтому после обновления страницы его не видно. Сохранённый отпечаток набора инструментов тоже нигде не сравнивается, то есть обещанное обнаружение подмены описаний фактически не работает. Это стоит учитывать, полагаясь на эту проверку.

Состояние источника

Состояние	Что означает
подключено	Платформа успешно связалась с источником и получила список инструментов
ошибка	Связаться не удалось. Рядом сохраняется текст последней ошибки
заблокирован	Источник исключён из работы по результатам проверки

Ограничения по времени

Ограничение	Значение по умолчанию	Переменная
Подключение и получение списка инструментов	8 секунд	MCP_DISCOVER_TIMEOUT_MS
Срок жизни кэша списка инструментов	60 секунд	MCP_CATALOG_TTL_MS
Вызов инструмента	30 секунд	MCP_TOOL_CALL_TIMEOUT_MS
Неактивная сессия внешнего шлюза	30 минут	MCP_GATEWAY_SESSION_TTL_MS

Ограничение вызова в 30 секунд задевает часть инструментов

Чтение очень большого документа и преобразование крупной схемы в Visio выполняются одним вызовом и могут не успеть. Пользователь увидит ошибку по времени, хотя работа продолжится и файл в итоге запишется. Если такие обращения частые, значение стоит увеличить.

Ограничение инструментов у агентов

Отдельные инструменты и целые источники можно запрещать конкретным агентам. Делается это не здесь, а в редакторе агента на вкладке доступа к MCP.

Подробности по каждому сервису

Технические сведения по поставляемым сервисам: что за ними стоит, какие модели используют, какие у них ограничения, собраны в архитектурном разделе, страница Инструменты MCP.