MCP сервер Yandex Cloud

MCP сервер Yandex Cloud — это приложение, которое предоставляет AI-агентам
доступ к управлению облачными ресурсами Yandex Cloud через стандартный
протокол Model Context Protocol (MCP). Сервер разворачивается на виртуальной
машине в Yandex Cloud.

При установке вы выбираете один из 11 доступных MCP-серверов:

• toolkit — управление Compute, VPC, IAM, Object Storage, YDB и другими сервисами (42 инструмента).
• docs — поиск и навигация по документации Yandex Cloud.
• search — полнотекстовый поиск по ресурсам через Yandex Search API.
• functions — управление Cloud Functions (serverless).
• containers — управление Serverless Containers.
• triggers — управление триггерами Cloud Functions и Serverless Containers.
• workflows — управление Yandex Cloud Workflows.
• apigateway — управление API Gateway.
• mcpgateway — управление MCP Gateway.
• datacatalog-consumer — доступ к каталогу данных Data Catalog.

Основные возможности и преимущества

• Интеграция с Yandex AI Studio. MCP сервер интегрируется с AI Studio MCP Серверы — подключите его к вашим AI-агентам в несколько кликов.
• 11 MCP-серверов. Широкий набор серверов для управления различными сервисами Yandex Cloud — от вычислительных ресурсов до serverless-функций.
• Аутентификация через сервисный аккаунт. Не требуются дополнительные API-ключи — приложение использует сервисный аккаунт виртуальной машины для аутентификации в Yandex Cloud.
• Авторизация Bearer-токеном. Все запросы к MCP-серверу защищены Bearer-токеном, который хранится в Yandex Lockbox.
• Стандартный протокол MCP. Использует открытый протокол Model Context Protocol для взаимодействия с AI-моделями, обеспечивая совместимость с широким спектром клиентов.
• HTTP транспорт. MCP сервер доступен на порту 8000 (HTTP), что упрощает интеграцию с различными клиентами и инструментами.
• Минимальные ресурсы. Приложение работает на виртуальной машине с минимальной конфигурацией (2 vCPU, 2 GB RAM), что снижает затраты на инфраструктуру.
• Docker-контейнеризация. Сервер запускается в Docker-контейнерах (MCP + nginx auth proxy).

1. Создайте секрет в Yandex Lockbox для хранения Bearer-токена авторизации. Секрет должен содержать ключ bearer_token с произвольным токеном.
2. Создайте сервисный аккаунт с ролью lockbox.payloadViewer и ролями, необходимыми для выбранного MCP-сервера:
   • toolkit — editor или compute.admin
   • docs — дополнительные роли не требуются
   • search — search-api.webSearch.user
   • functions — editor или functions.admin
   • containers — editor или serverless-containers.admin
   • triggers — editor или functions.admin
   • workflows — editor или serverless.workflows.admin
   • apigateway — editor или api-gateway.admin
   • mcpgateway — editor или serverless.mcpGateways.admin
   • datacatalog-consumer — data-catalog.viewer
3. В консоли управления выберите сервис Cloud Apps.
4. На панели слева выберите Магазин приложений.
5. Выберите MCP Yandex Cloud и нажмите кнопку Использовать.
6. Укажите:
   • Имя приложения.
   • (Опционально) Описание приложения.
   • Сервисный аккаунт, созданный ранее.
   • Облачную подсеть, в которой будет развёрнута виртуальная машина.
   • MCP-сервер — выберите нужный сервер из списка (toolkit, docs, search и др.).
   • (Опционально) Folder ID — идентификатор каталога Yandex Cloud. Используется как значение по умолчанию для инструментов. Если не указан, AI-агент запросит его при необходимости.
   • Идентификатор секрета Lockbox с Bearer-токеном для авторизации.
7. Нажмите кнопку Установить и дождитесь, пока приложение установится.
8. После установки MCP сервер будет доступен по адресу http://<vm-ip>:8000.
9. Настройте ваш AI-клиент (Claude Desktop, Cursor и др.) для подключения к MCP серверу, указав заголовок Authorization: Bearer <ваш-токен>.

Подключение MCP-сервера к Yandex AI Studio

1. В консоли управления откройте сервис AI Studio и перейдите в раздел MCP Hub.
2. Нажмите Создать MCP-сервер и выберите тип Внешний MCP-сервер.
3. Укажите имя сервера и идентификатор сети VPC, в которой развёрнута виртуальная машина MCP-сервера. Идентификатор сети доступен на странице приложения в разделе Данные приложения, поле Идентификатор сети VPC.
4. На шаге подключения к MCP-серверу заполните параметры значениями из раздела Данные приложения:
   • Тип MCP-сервера — значение из поля Тип MCP-сервера.
   • URL MCP-сервера — значение из поля URL MCP-сервера (внутренний).
   • В блоке HTTP-заголовков добавьте заголовок Authorization со значением Bearer <bearer_token>, где <bearer_token> — токен из секрета Yandex Lockbox, указанного при установке приложения.
5. Нажмите Подключиться. После успешной проверки подключения выберите необходимые инструменты (tools) и нажмите Подключить — MCP-сервер будет зарегистрирован в AI Studio и доступен для использования AI-агентами.

• Управление виртуальными машинами, сетями и дисками через AI-ассистента (toolkit).
• Поиск по документации Yandex Cloud для получения актуальной информации о сервисах (docs).
• Создание и управление serverless-функциями через естественный язык (functions).
• Управление триггерами, API Gateway и Serverless Containers (triggers, apigateway, containers).
• Поиск ресурсов в облаке через Yandex Search API (search).
• Управление MCP Gateway и Workflows (mcpgateway, workflows).

Служба технической поддержки Yandex Cloud отвечает на запросы 24 часа в сутки, 7 дней в неделю. Доступные виды запросов и срок их обработки зависят от тарифного плана. Подключить платную поддержку можно в консоли управления. Подробнее о порядке оказания технической поддержки.