Подключения MCP

Подключения MCP — раздел настроек рабочего пространства, в котором владелец или менеджер даёт агенту доступ к внешней системе компании: вики, системе задач, хранилищу документов. Доступ идёт через MCP-сервер — программу, которая по открытому протоколу MCP (Model Context Protocol) открывает инструменты внешней системы. Вы указываете адрес сервера и токен, платформа проверяет сервер и показывает его инструменты с описаниями. Агент видит инструмент только после того, как вы включите его сами. Сам MCP-сервер разворачивает команда сопровождения: платформа к нему подключается, но не запускает его.

Что вам понадобится

право integrations:mcp:connect, чтобы подключать и удалять серверы: оно есть у ролей owner и manager;
право integrations:mcp:manage, чтобы включать инструменты для агента и проверять связь;
адрес MCP-сервера, доступный из платформы;
токен доступа к внешней системе, если сервер требует авторизацию.

Как подключить MCP-сервер

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

Нажмите на своё имя в нижней части левого меню и выберите «Настройки пространства».
Откройте раздел Подключения.
Нажмите «Подключить сервер».
Укажите Название и «Адрес сервера».
В поле Авторизация выберите способ, который требует сервер, и укажите токен.
Нажмите Проверить.
Просмотрите список инструментов и нажмите Подключить.

Платформа сохраняет подключение и показывает сервер в списке вместе с его инструментами. Токен хранится зашифрованным и после подключения не показывается.

Способ авторизации	Когда выбирать	Что указать
Bearer-токен	Сервер ждёт заголовок `Authorization: Bearer <token>`	Токен
«Свой заголовок»	Сервер ждёт другой заголовок или другую схему, например `Authorization: Token <token>`	Заголовок, Схема и Токен. Схема ставится перед токеном через пробел
«Без авторизации»	Сервер открыт внутри периметра и не проверяет вызывающего	Ничего

Как дать агенту доступ к инструментам

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

Переключатель	Что делает	По умолчанию
«Доступен агенту»	Агент видит инструмент и может вызвать его в прогоне	Выключен
«Спрашивать подтверждение»	Перед вызовом агент показывает карточку согласования, и инструмент выполняется только после вашего решения	Выключен у инструментов, которые сервер отметил как безопасные для чтения, у остальных включён

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

Инструменты включаются на уровне рабочего пространства: включённый инструмент доступен агенту в любом ассистенте этого пространства.

Что означают статусы подключения

Статус показан рядом с названием сервера. Проверить связь и перечитать список инструментов вы можете из меню действий сервера.

Статус	Значение	Что делать
Работает	Сервер ответил на последней проверке	Ничего
Ошибка	Сервер не ответил или отклонил запрос, причина показана под названием	Устраните причину и выберите «Проверить связь»
«Не проверен»	Подключение создано, но проверка ещё не завершилась	Выберите «Проверить связь»
Отключён	Подключение выключено	Удалите подключение или подключите сервер заново

Пункт «Обновить инструменты» перечитывает список инструментов сервера. Инструменты, которые сервер перестал отдавать, остаются в списке с пометкой «Сервер больше не отдаёт этот инструмент», и агент их не видит.

Что происходит, когда сервер меняет описание инструмента

Агент выбирает инструмент по его описанию, поэтому платформа запоминает описание, которое вы видели при подключении. Если сервер позже изменил описание или подсказки инструмента, платформа скрывает инструмент от агента и показывает под ним сообщение «Сервер изменил описание инструмента». Так подменённое описание не может незаметно направить агента на другое действие.

Прочитайте новое описание инструмента.
Если изменение ожидаемое, нажмите Одобрить.

Платформа запоминает новое описание и возвращает инструменту прежние настройки доступа.

Как удалить подключение

Удаление убирает сервер из пространства вместе с его инструментами и сохранённым токеном.

Откройте меню действий сервера и выберите Удалить.
Подтвердите удаление.

Агент сразу теряет доступ к инструментам сервера, в том числе в прогоне, который уже идёт.

Частые вопросы

Почему проверка сервера завершается ошибкой

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

Сообщение	Причина	Что сделать
`MCP-сервер отклонил авторизацию`	Неверный токен, заголовок или схема	Проверьте токен и способ авторизации, который требует сервер
`MCP-сервер не ответил за`	Сервер не отвечает или перегружен	Проверьте, что сервер запущен, и повторите проверку
`MCP-сервер недоступен`	Неверный адрес или сервер не доступен из сети платформы	Проверьте адрес, порт и путь, обычно `/mcp`
`Адрес MCP-сервера закрыт политикой исходящих запросов`	Адрес указывает на локальный узел платформы, а в облачной поставке — ещё и на внутреннюю сеть	Укажите адрес, по которому сервер доступен из сети платформы
`MCP-сервер перенаправляет запрос на`	Сервер отвечает перенаправлением на другой адрес, например добавляет `/` в конце пути. Платформа не следует перенаправлениям, чтобы токен не ушёл по чужому адресу	Если адрес из сообщения принадлежит вашему серверу, укажите его в подключении
`MCP-сервер отдаёт … инструментов`	Сервер открывает слишком много инструментов	Ограничьте набор инструментов в настройках сервера

Почему агент не вызывает подключённый инструмент

Агент вызывает только включённые инструменты и только в режиме агента. Проверьте:

у инструмента включён переключатель «Доступен агенту»;
у сервера статус Работает;
под инструментом нет сообщения «Сервер изменил описание инструмента»;
чат отправлен в режиме Агент или ассистент работает через агента.

Чтобы агент обращался к системе без напоминаний, опишите в навыке или инструкции ассистента, когда идти в эту систему.

Что дальше

Агент — как агент выполняет многошаговые задачи и просит согласование.
Навыки — научить агента, когда и как пользоваться подключённой системой.
Роли и права доступа — выдать право на подключение серверов пользовательской роли.