Настройка MCP-сервера

Страница настройки MCP-сервера разделена на две панели: слева -- параметры подключения, справа -- таблица инструментов.

Создание нового сервера

1. Откройте страницу MCP серверы в проекте
2. Нажмите MCP сервер
3. Заполните параметры подключения (см. ниже)
4. Нажмите Проверить соединение для обнаружения инструментов
5. Нажмите Создать

Параметры подключения

Основные настройки

URL

Адрес MCP-сервера. Пример:

https://api.example.com/mcp

Платформа автоматически добавляет /tools и /call к базовому URL при обнаружении инструментов и вызове.

Переменные окружения

JSON-объект с переменными окружения. Они автоматически добавляются как параметры при каждом вызове инструмента.

{
  "YCLIENTS_PARTNER_TOKEN": "ваш-токен",
  "API_SECRET": "секрет"
}

Мультитенантные серверы

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

Описание

Произвольное текстовое описание сервера для вашего удобства. Необязательное поле.

Категория

Категория для группировки серверов:

Категория	Назначение
Web	Веб-сервисы, скрейпинг, браузерная автоматизация
AI	AI-сервисы, NLP, генерация контента
Data	Работа с данными, базы данных, хранилища
Custom	Пользовательские интеграции

Авторизация

Тип авторизации при обращении к MCP-серверу:

Тип	Описание
Нет	Без авторизации
API ключ	Токен передается в заголовке X-API-Key
Bearer токен	Токен передается в заголовке Authorization: Bearer <token>

При выборе типа «API ключ» или «Bearer токен» появится поле Токен доступа.

Пользовательские заголовки

JSON-объект с дополнительными HTTP-заголовками, которые будут передаваться при каждом запросе к серверу:

{
  "X-Custom-Header": "значение",
  "X-Tenant-ID": "12345"
}

Включен

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

Проверка соединения

Нажмите кнопку Проверить соединение для тестирования подключения. Платформа:

1. Подключится к серверу по указанному URL
2. Запросит список доступных инструментов
3. Отобразит результат:
   • При успехе -- сообщение «Соединение установлено!» с количеством найденных инструментов и их списком в виде тегов
   • При ошибке -- описание проблемы (неверный URL, ошибка авторизации, таймаут и т.д.)

Таймаут подключения

Тест соединения имеет таймаут 10 секунд. Если сервер не отвечает за это время, соединение считается неудачным.

После успешной проверки статус сервера обновляется на «Подключено», а обнаруженные инструменты сохраняются и отображаются на правой панели.

Управление инструментами

Правая панель отображает все инструменты, обнаруженные при проверке соединения. Инструменты представлены в виде иерархической таблицы.

Структура таблицы инструментов

Каждая строка верхнего уровня -- это инструмент (tool):

Столбец	Описание
Включен	Переключатель для включения/отключения инструмента
Tool	Имя инструмента
Domain	Описание области ответственности
Ops	Количество включенных/всего операций

Раскройте инструмент, чтобы увидеть его операции:

Столбец	Описание
Включен	Переключатель для включения/отключения операции
Operation	Имя операции
Method	HTTP-метод (GET, POST, PUT, PATCH, DELETE)
Description	Описание операции

Управление разрешениями

Вы можете гранулярно контролировать, какие инструменты и операции доступны агентам:

• Включить/отключить инструмент целиком -- переключатель в строке инструмента
• Включить/отключить отдельную операцию -- переключатель в строке операции
• Выбрать все / снять выбор -- кнопка «Select All» / «Deselect All» на панели инструментов
• Развернуть/свернуть все -- кнопка «Expand» / «Collapse»

Счетчик в столбце «Ops» показывает соотношение включенных операций к общему количеству:

• Зеленый тег -- все операции включены
• Синий тег -- часть операций включена
• Красный тег -- все операции отключены

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

Используйте поле поиска в верхней части панели для фильтрации инструментов и операций по имени или описанию.

Сохранение настроек

Настройки разрешений инструментов сохраняются при нажатии кнопки Сохранить. Не забудьте сохранить изменения после настройки разрешений.

Использование в агентах

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

При вызове инструмента платформа:

1. Формирует запрос к MCP-серверу с аргументами от языковой модели
2. Добавляет авторизационные заголовки и переменные окружения
3. Передает результат обратно модели для продолжения работы

Имя инструмента в контексте агента формируется по шаблону {имя_сервера}__{имя_инструмента}, где пробелы и дефисы в имени сервера заменяются подчеркиванием.

Подробнее

Для создания и конфигурации текстовых агентов и воркфлоу с использованием MCP-инструментов см. соответствующие разделы документации.