Связаться с намиПодключиться

Создать MCP-сервер в MCP Hub с нуля

Статья создана
Улучшена
Обновлена 10 ноября 2025 г.

Примечание

Функциональность находится на стадии Preview.

В MCP Hub вы можете с нуля создавать новые MCP-серверы, содержащие такие инструменты, как HTTPS-запрос к внешнему API, функция Yandex Cloud Functions или рабочий процесс Yandex Workflows.

Чтобы создать новый MCP-сервер:

  1. В консоли управления выберите каталог, на который у вашего аккаунта есть роль serverless.mcpGateways.editor или выше.

  2. В списке сервисов выберите AI Studio.

  3. На панели слева выберите MCP-серверы и нажмите кнопку Создать MCP-сервер. В открывшемся окне:

    1. В блоке Способ добавления выберите опцию Создать.

    2. В блоке Инструменты выберите тип добавляемого в MCP-сервер инструмента — HTTPS-запрос, Cloud Functions или Workflows:

      1. В поле Имя инструмента задайте имя для создаваемого инструмента. Требования к имени:

        • длина — от 2 до 63 символов;
        • может содержать строчные буквы латинского алфавита, цифры и дефисы;
        • первый символ — буква, последний — не дефис.

      2. В поле Инструкция для агента задайте обязательное текстовое описание инструмента. Описание должно содержать информацию об условиях, при которых AI-агент должен использовать этот инструмент. Например:

        Инструмент для создания тикетов в корпоративной системе обработки задач. Используй этот 
инструмент, чтобы регистрировать жалобы клиентов, запросы на получение консультаций, отчеты 
об ошибках. При использовании инструмента задавай параметры queue, type, priority и summary. 
В параметре queue (имя очереди) всегда передавай константу SUPPORT. В параметре type (тип 
обращения) передавай одно из значений: bug (отчет об ошибке), complaint (жалоба клиента) или 
support-request (запрос на получение консультации). В параметре priority (приоритет) 
передавай одно из значений: low (низкий), medium (средний) или high (высокий). В параметре 
summary передавай значение в виде текста, описывающего суть обращения словами пользователя.

      3. В поле URL укажите эндпоинт, на который будет отправляться HTTPS-запрос.

        • Чтобы добавить path-параметры в значение эндпоинта, вы можете использовать jq-шаблоны. Например:

          https://console.yandex.cloud/folders/\(.folder-id)

          В указанном примере поле folder-id также должно быть добавлено в блоке Параметры инструмента настроек MCP-сервера.

        • Чтобы передавать query-параметры в запросе на эндпоинт:

          • Добавьте поля с нужными именами в блоке Параметры инструмента настроек создаваемого MCP-сервера. Например: country, city и name.
          • Добавьте нужные query-параметры в блоке Параметры HTTPS-метода настроек создаваемого MCP-сервера. В качестве значений добавляемых query-параметров укажите jq-шаблоны с именами заданных выше полей. Например: \(.country), \(.city) и \(.name).

      4. В поле Метод выберите HTTP-метод запроса: GET, POST, DELETE, PATCH, OPTIONS или HEAD.

      5. Разверните блок Дополнительные параметры и укажите аутентификационные данные, которые будут передаваться в HTTPS-запросах:

        • Сервисный аккаунт — чтобы передавать IAM-токен, выпущенный для сервисного аккаунта, привязанного к MCP-серверу.
        • Токен доступа — чтобы передавать заданный токен доступа.
        • Без авторизации — чтобы не использовать аутентификацию.

      6. В блоке Параметры инструмента укажите имена, типы и текстовые описания параметров, которые будут использоваться инструментом.

        Вы можете добавить нужные параметры на вкладке Форма по одному с помощью кнопки Добавить или на вкладке JSON-схема в виде JSON-структуры.

        JSON-схема:

        {
  properties?: { [key: string]: object };
  required?: string[];
  type: “object”;
}
        Пример JSON-структуры
        {
  "type": "object",
  "properties": {
    "location": {
      "type": "string",
      "description": "City name or zip code"
    }
  },
  "required": ["location"]
}

      7. В блоке Параметры HTTPS-запроса настройте параметры HTTPS-запросов:

        • В секции Заголовки запроса укажите имена и значения заголовков, которые будут передаваться в запросах.

        • В секции Query-параметры задайте имена и значения параметров, которые будут передаваться в запросе.

        • В секции Тело запроса посмотрите пример получившегося запроса и при необходимости скорректируйте его.

          По умолчанию формируется пустое тело запроса с плоским JSON-объектом, состоящим из пар параметров инструмента и их значений. Например:

          {
  "parameter-a": <значение_parameter-a>,
  "parameter-b": <значение_parameter-b>,
  "parameter-c": <значение_parameter-c>
}

        Все параметры HTTPS-запроса поддерживают шаблонизацию — их значения могут генерироваться динамически. Язык шаблонизации — jq. Подробнее см. в документации jq.

        Например: значение \(.city) параметра HTTPS-запроса будет взято из параметра инструмента city. Также при помощи конструкции Bearer \(.token) для заголовка Authorization вы сможете настроить авторизацию с использованием токена, переданного в параметре инструмента.

      1. В поле Имя инструмента задайте имя для создаваемого инструмента. Требования к имени:

        • длина — от 2 до 63 символов;
        • может содержать строчные буквы латинского алфавита, цифры и дефисы;
        • первый символ — буква, последний — не дефис.

      2. В поле Инструкция для агента задайте обязательное текстовое описание инструмента. Описание должно содержать информацию об условиях, при которых AI-агент должен использовать этот инструмент. Например:

        Инструмент распознает текст на изображении, передаваемом в кодировке base64. В распознанном 
тексте инструмент выделяет пары "артикул":"количество" и возвращает в формате JSON-структуры.

      3. В поле Функция выберите функцию Cloud Functions, которая будет выполнять обработку запросов, и ее версию.

      4. В блоке Параметры инструмента укажите имена, типы и текстовые описания параметров, которые будут использоваться инструментом.

        Вы можете добавить нужные параметры на вкладке Форма по одному с помощью кнопки Добавить или на вкладке JSON-схема в виде JSON-структуры.

        JSON-схема:

        {
  properties?: { [key: string]: object };
  required?: string[];
  type: “object”;
}
        Пример JSON-структуры
        {
  "type": "object",
  "properties": {
    "location": {
      "type": "string",
      "description": "City name or zip code"
    }
  },
  "required": ["location"]
}

      По умолчанию формируется пустое тело запроса с плоским JSON-объектом, состоящим из пар параметров инструмента и их значений. Например:

      {
  "parameter-a": <значение_parameter-a>,
  "parameter-b": <значение_parameter-b>,
  "parameter-c": <значение_parameter-c>
}

      1. В поле Имя инструмента задайте имя для создаваемого инструмента. Требования к имени:

        • длина — от 2 до 63 символов;
        • может содержать строчные буквы латинского алфавита, цифры и дефисы;
        • первый символ — буква, последний — не дефис.

      2. В поле Инструкция для агента задайте обязательное текстовое описание инструмента. Описание должно содержать информацию об условиях, при которых AI-агент должен использовать этот инструмент. Например:

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

      3. В поле Рабочий процесс выберите рабочий процесс Workflows, который будет выполнять обработку запросов.

      4. В блоке Параметры инструмента укажите имена, типы и текстовые описания параметров, которые будут использоваться инструментом.

        Вы можете добавить нужные параметры на вкладке Форма по одному с помощью кнопки Добавить или на вкладке JSON-схема в виде JSON-структуры.

        JSON-схема:

        {
  properties?: { [key: string]: object };
  required?: string[];
  type: “object”;
}
        Пример JSON-структуры
        {
  "type": "object",
  "properties": {
    "location": {
      "type": "string",
      "description": "City name or zip code"
    }
  },
  "required": ["location"]
}

      По умолчанию формируется пустое тело запроса с плоским JSON-объектом, состоящим из пар параметров инструмента и их значений. Например:

      {
  "parameter-a": <значение_parameter-a>,
  "parameter-b": <значение_parameter-b>,
  "parameter-c": <значение_parameter-c>
}

    3. Чтобы добавить в MCP-сервер дополнительный инструмент, нажмите кнопку Добавить инструмент.

      Примечание

      Один MCP-сервер может содержать до 50 инструментов.

    4. В блоке Параметры сервера:

      1. В поле Имя задайте имя создаваемого MCP-сервера. Требования к имени:

        • длина — от 2 до 63 символов;
        • может содержать строчные буквы латинского алфавита, цифры и дефисы;
        • первый символ — буква, последний — не дефис.

      2. (Опционально) Добавьте создаваемому серверу описание и метки, воспользовавшись соответствующими кнопками.

      3. В поле Доступ выберите тип создаваемого сервера:

        • Приватный — чтобы создать приватный MCP-сервер, для доступа к которому потребуется аутентификация.
        • Публичный — чтобы создать публичный MCP-сервер, доступный без аутентификации.

      4. В поле Сервисный аккаунт выберите сервисный аккаунт, от имени которого MCP-сервер будет работать с сервисами и ресурсами Yandex Cloud. Сервисному аккаунту должны быть назначены роли, достаточные для доступа к этим ресурсам и сервисам.

      5. (Опционально) Включите опцию Указать сеть, чтобы указать облачную сеть, в которой будет размещены экземпляры MCP-сервера.

      6. (Опционально) Включите опцию Запись логов и задайте параметры логирования, чтобы вести журнал логов создаваемого MCP-сервера.

    5. Нажмите кнопку Сохранить.

В результате в MCP Hub будет создан MCP-сервер, содержащий добавленные инструменты и доступный AI-агентам.

См. также

Предыдущая
Создать MCP-сервер из шаблона
Следующая
Переход с AI Assistant API на Responses API