Подключить внешний MCP-сервер к MCP Hub

Получите IAM-токен, необходимый для аутентификации.

Сохраните полученный IAM-токен в переменную окружения:

export IAM_TOKEN="<содержимое_IAM_токена>"

Создайте файл с телом запроса (например, body.json):

body.json

{
  "folderId": "<идентификатор_каталога>",
  "name": "<имя_MCP-сервера>",
  "description": "<описание_MCP-сервера>",
  "serviceAccountId": "<идентификатор_сервисного_аккаунта>",
  "public": "true|false",
  "tools": [
    {
      "name": "<имя_инструмента>",
      "description": "<описание_инструмента>",
      "inputJsonSchema": "<JSON-схема_инструмента>",
      "action": {
        "mcpCall": {
          "url": "<URL_MCP-сервера>",
          "toolCall": {
            "toolName": "<имя_инструмента>",
            "parametersJson": "<передаваемые_параметры>"
          },
          "transport": "<транспортный_механизм>",
          "unauthorized": {}
        }
      }
    }
  ]
}

Где:

• folderId — идентификатор каталога, в котором создается MCP-сервер. Вашему аккаунту на этот каталог должны быть назначены роли serverless.mcpGateways.editor и iam.serviceAccounts.user или выше.

• name — имя создаваемого MCP-сервера. Требования к имени:

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

• description — произвольное описание MCP-сервера.

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

• public — параметр, определяющий тип создаваемого сервера. Возможные значения:

  • true — чтобы создать публичный MCP-сервер.
  • false — чтобы создать приватный MCP-сервер.

• tools — описание добавляемых в MCP-сервер инструментов:

  • name — имя добавляемого инструмента. Требования к имени:

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

  • description — произвольное описание инструмента.

  • inputJsonSchema — 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"]
    }
    

  • action.mcpCall — описание параметров, специфичных для настройки подключения внешнего MCP-сервера:

    • url — URL, по которому доступен внешний MCP-сервер. Например: https://mcp.example.com.

    • toolName — имя добавляемого инструмента. Требования к имени:

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

    • parametersJson — параметры, передаваемые в инструмент, в формате jq-шаблона.

    • transport — тип транспортного механизма, который будет использоваться для взаимодействия с MCP-сервером. Доступные типы:

      • STREAMABLE — современный и актуальный транспортный механизм. AI-агент сможет получать обновления (события) с сервера без необходимости поддерживать постоянное HTTP-соединение.
      • SSE — устаревший транспортный механизм. AI-агент сможет получать обновления с сервера через одно постоянное HTTP-соединение.

    • "unauthorized": {} — передайте это значение, если внешний MCP-сервер не требует аутентификации. Если аутентификация нужна, вместо поля unauthorized передайте в теле запроса заголовок авторизации header или поле serviceAccount. Подробнее читайте в справочнике API в разделе McpGateway.Create.

  Пример тела запроса

  {
    "folderId": "b1gt6g8ht345********",
    "name": "my-external-mcp-server",
    "description": "my sample external MCP-server",
    "serviceAccountId": "ajegtlf2q28a********",
    "public": "true",
    "tools": [
      {
        "name": "tool-name",
        "description": "tool description",
        "inputJsonSchema": "{\"type\":\"object\",\"properties\":{\"location\":{\"type\":\"string\",\"description\":\"City name or zip code\"}},\"required\":[\"location\"]}",
        "action": {
          "mcpCall": {
            "url": "https://mcp.example.com",
            "toolCall": {
              "toolName": "tool-name",
              "parametersJson": "//( . )"
            },
            "transport": "SSE",
            "unauthorized": {}
          }
        }
      }
    ]
  }
  

Воспользуйтесь методом REST API McpGateway.Create, чтобы создать новый MCP-сервер в каталоге:

curl \
  --request POST \
  --header "Authorization: Bearer $IAM_TOKEN" \
  --data "@body.json" \
  "https://serverless-mcp-gateway.api.cloud.yandex.net/mcpgateway/v1/mcpGateways"

Результат:

{
  "done": false,
  "metadata": {
    "@type": "type.googleapis.com/yandex.cloud.serverless.mcpgateway.v1.CreateMcpGatewayMetadata",
    "mcpGatewayId": "db815a8nma7u********",
    "folderId": "b1gt6g8ht345********"
  },
  "id": "db8o404e7f2v********",
  "description": "Create MCP Gateway",
  "createdAt": "2025-12-22T18:04:42.776181560Z",
  "createdBy": "ajeol2afu1js********",
  "modifiedAt": "2025-12-22T18:04:42.776181560Z"
}

Сохраните идентификатор созданного MCP-сервера (значение поля mcpGatewayId) — он понадобится на следующем шаге.

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

curl \
  --request GET \
  --header "Authorization: Bearer $IAM_TOKEN" \
  "https://serverless-mcp-gateway.api.cloud.yandex.net/mcpgateway/v1/mcpGateways/<идентификатор_MCP-сервера>"

{
  "tools": [
    {
      "action": {
        "mcpCall": {
          "toolCall": {
            "toolName": "tool-name",
            "parametersJson": "//( . )"
          },
          "unauthorized": {},
          "url": "https://mcp.example.com",
          "transport": "SSE"
        }
      },
      "name": "tool-name",
      "description": "tool description",
      "inputJsonSchema": "{\"type\":\"object\",\"properties\":{\"location\":{\"type\":\"string\",\"description\":\"City name or zip code\"}},\"required\":[\"location\"]}"
    }
  ],
  "logOptions": {
    "disabled": false
  },
  "public": true,
  "id": "db815a8nma7u********",
  "folderId": "b1gt6g8ht345********",
  "createdAt": "2025-12-22T18:04:42.819804Z",
  "name": "my-external-mcp-server",
  "description": "my sample external MCP-server",
  "status": "ACTIVE",
  "baseDomain": "https://db815a8nma7u********.99igvxy3.mcpgw.serverless.yandexcloud.net",
  "serviceAccountId": "ajegtlf2q28a********",
  "cloudId": "b1gia87mbaom********"
}