MCP-серверы в агенте

Кратко

MCP-серверы подключают к агенту внешние инструменты: CRM, базу знаний, API или другой сервис. Для одного агента можно выбрать конкретные серверы либо подключить общий набор, состав которого меняется сразу для всех связанных агентов.

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

Выберите способ подключения

Откройте настройку MCP в форме агента и выберите один из четырёх вариантов:

• «Без MCP-серверов» — агент не получает MCP-инструменты;
• «Напрямую через AI-провайдера» — AI-провайдер сам обращается к выбранным серверам. Сервер должен быть доступен из интернета по HTTPS;
• «Выбранные серверы через Senler» — Senler обращается к конкретным серверам, выбранным для этого агента;
• «Набор серверов через Senler» — агент использует общий набор. Этот вариант удобен, когда одинаковый состав инструментов нужен нескольким агентам.

Не каждая модель ИИ поддерживает все четыре варианта. Режимы через Senler требуют, чтобы выбранная модель умела вызывать обычные инструменты. Для варианта «Напрямую через AI-провайдера» модель и её активное подключение к провайдеру должны дополнительно поддерживать нативный MCP и загрузку каталога инструментов. «Без MCP-серверов» доступен для любой модели.

При выборе другой модели кабинет сравнивает её возможности с текущим режимом MCP. Если режим не поддерживается, появится окно «Изменить режим MCP?» с текущим и новым вариантами. Кнопка «Сменить модель и режим» применяет оба изменения, а «Отменить смену модели» оставляет прежние настройки.

Если модель не поддерживает прямое подключение через AI-провайдера, но умеет работать с инструментами через Senler, кабинет предложит «Выбранные серверы через Senler». Если модель не поддерживает и этот вариант, новым режимом будет «Без MCP-серверов». Несовместимое сочетание нельзя сохранить и при ручной смене настроек.

Выберите серверы или набор

В режимах с отдельным выбором нажмите «Добавить сервер», воспользуйтесь поиском, отметьте нужные серверы и нажмите «Применить». Выбранный сервер можно убрать из агента.

Нужный MCP-сервер можно найти и через кнопку @ в инструкции. Если он уже разрешён текущим режимом, кабинет сразу вставит тег. Если нет, откроются настройки MCP: выберите совместимый режим и сервер, сохраните их, после чего тег будет добавлен в инструкцию. Сам тег не заменяет правило — рядом укажите, в какой ситуации и для какой задачи вызывать инструменты сервера.

В режиме набора выберите существующий набор. Рядом с полем можно создать новый набор или изменить выбранный. Наборы также доступны в настройках MCP-серверов.

Подтвердите выбор кнопкой «Сохранить», сохраните черновик агента, проверьте инструмент в тестировании и опубликуйте новую версию. Изменение режима, выбранных серверов или выбранного набора начинает работать в реальных диалогах после публикации агента.

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

Если серверы или наборы не загрузились

Если кабинет не смог получить данные, нужные для выбранного режима, в окне MCP появится сообщение с кнопкой «Повторить». Для режима с набором она повторно загружает наборы, а для режима с отдельными серверами — список серверов.

Пока нужные данные не загрузились, кнопка «Сохранить» недоступна. После успешного повтора проверьте выбор ещё раз и только затем сохраните настройки.

Если инструмент не используется

• проверьте, выбран ли MCP-сервер в настройках агента;
• для режима через AI-провайдера проверьте, доступен ли адрес сервера по публичному HTTPS;
• если подключён набор, проверьте его текущий состав;
• проверьте, поддерживает ли выбранная модель текущий режим MCP; если нет, подтвердите предложенную смену режима либо выберите другую модель;
• проверьте, опубликована ли новая версия агента;
• проверьте, активен ли агент;
• проверьте авторизацию MCP-сервера;
• проверьте в "Истории" события запуска, завершения и ошибок инструмента.

Связанные элементы

• форма настроек агента
• список агентов
• пункт «Агенты» в боковом меню