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

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

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

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

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

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

   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. Нажмите кнопку Сохранить.