MCP-серверы Yandex Cloud для AI-агентов и IDE

Model Context Protocol (MCP) — открытый стандарт, который подключает AI-приложения к внешним системам. Внешние системы делятся на три категории:

• источники данных, например, базы данных или файловые хранилища;
• инструменты, например, API или скрипты;
• рабочие процессы, например, сценарии, которые выполняются автоматически.

Без MCP для каждой пары «AI-приложение — внешняя система» пришлось бы писать отдельную интеграцию. MCP предоставляет единый интерфейс, с помощью которого любой MCP-клиент может обращаться к внешним инструментам по общим правилам.
В Yandex Cloud есть набор специализированных MCP-серверов для управления облачной инфраструктурой, Serverless-ресурсами и данными. С их помощью AI-агент может:

• создавать виртуальные машины;
• разворачивать функции и контейнеры;
• настраивать триггеры и рабочие процессы;
• искать метаданные в каталоге данных;
• обращаться к Yandex Cloud и веб-поиску.

Доступные MCP-серверыДоступные MCP-серверы

ПодключениеПодключение

MCP-серверы Yandex Cloud поддерживают два способа подключения: локально через npm-клиент (транспорт stdio) с автоматической аутентификацией и удаленно через Streamable HTTP.

Предварительные требованияПредварительные требования

Чтобы подключить MCP-сервер Yandex Cloud, потребуется:

• Роль Yandex Cloud для работы с конкретным сервисом, например editor или functions.admin. Полный список ролей — в таблице Конфигурация серверов.
• Node.js версии 18.0.0 или выше — при подключении через npm-клиент.
• Yandex Cloud CLI — опционально, требуется только для аутентификации через CLI-профиль.

NPM-клиент (stdio)NPM-клиент (stdio)

npm-клиент @yandex-cloud/mcp запускает MCP-сервер локально и обеспечивает аутентификацию в Yandex Cloud одним из способов:

• OAuth — аутентификация через браузер без дополнительных флагов. Используется по умолчанию.
• OAuth с явным выбором аккаунта — параметр -S <идентификатор_пользователя_или_сервисного_аккаунта> или параметр -u <email>.
• Аутентификация через Yandex Cloud CLI — параметр -p <профиль> использует уже настроенный профиль CLI. Требует установленного Yandex Cloud CLI.
• Без аутентификации — параметр --no-auth. Подходит только для серверов, которым не требуется авторизация (например, для Documentation MCP-сервера).

Пример конфигурации:

{
  "mcpServers": {
    "yandex-cloud-toolkit": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y", "@yandex-cloud/mcp",
        "-s", "toolkit"
      ]
    }
  }
}

Где:

• -s, --server — имя MCP-сервера, например toolkit, search или functions. Полный список имен серверов — в разделе Конфигурация серверов.
• -r, --region <REGION> — регион Yandex Cloud для OAuth-аутентификации. Параметр принимает значения ru или kz. Значение по умолчанию — ru;
• -H, --header <Key:Value> — дополнительный заголовок для каждого вызова инструмента MCP-сервера. Параметр можно указать несколько раз, например, чтобы передать Folder-Id.

Streamable HTTPStreamable HTTP

Для подключения через Streamable HTTP используйте IAM-токен, который можно получить с помощью Yandex Cloud CLI:

yc iam create-token

Для аутентификации от имени сервисного аккаунта:

yc iam create-token --impersonate-service-account-id <идентификатор_сервисного_аккаунта>

Пример конфигурации:

{
  "mcpServers": {
    "yandex-cloud-toolkit": {
      "type": "streamableHttp",
      "url": "https://toolkit.mcp.cloud.yandex.net/mcp",
      "headers": {
        "Authorization": "Bearer <IAM-токен>"
      }
    }
  }
}

Конфигурация серверовКонфигурация серверов

Параметры для подключения MCP-серверов:

Для серверов, которые обращаются к ресурсам каталога (Toolkit, Search, Functions, Serverless Containers, Triggers, Workflows, API Gateway, MCP Gateway), можно передать значения по умолчанию через заголовки:

• Cloud-Id — идентификатор облака для поля cloud_id в инструментах MCP-сервера;
• Folder-Id — идентификатор каталога для поля folder_id в инструментах MCP-сервера.

Пример для npm-клиента:

npx @yandex-cloud/mcp -s toolkit -H "Folder-Id:<идентификатор_каталога>"

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

Подключите MCP-сервер вручную или с помощью AI-агента.

Подключение через AI-агентаПодключение через AI-агента

Чтобы настроить и подключить MCP-сервер, отправьте вашему AI-агенту следующую инструкцию:

Подключи MCP-сервер Yandex Cloud через `npx @yandex-cloud/mcp -s <имя_сервера>`.

Где <имя_сервера> — значение из столбца Имя сервера для npm-клиента (-s) в таблице.

AI-агент сам найдет файл конфигурации и добавит в него настройки MCP-сервера. Для этого ему нужен доступ к файловой системе и терминалу.

Подключение для популярных IDEПодключение для популярных IDE

Ниже пример подключения Toolkit MCP-сервера через npm-клиент. Чтобы подключить другой сервер, замените имя сервера toolkit в параметре -s на значение из таблицы. Если вы используете Streamable HTTP, замените также URL сервера.

claude mcp get yandex-cloud-toolkit

Yandex Cloud CLI как альтернатива для агентовYandex Cloud CLI как альтернатива для агентов

Если AI-агент имеет доступ к терминалу, он может управлять ресурсами Yandex Cloud напрямую через Yandex Cloud CLI — без подключения MCP-сервера. Такой способ полезен, когда агенту нужны команды, которых еще нет среди инструментов MCP-серверов, либо когда терминал уже доступен агенту как основной инструмент.

Чтобы агент мог использовать CLI:

1. Установите Yandex Cloud CLI в окружении, где работает агент.

2. Создайте профиль. Для этого войдите от имени пользователя или сервисного аккаунта.

3. Добавьте параметр --format json к командам CLI, чтобы агент мог структурированно обрабатывать вывод, например:

   yc compute instance list --format json
   

Роли, необходимые для конкретных операций CLI, совпадают с ролями для соответствующего MCP-сервера. Полный список ролей — в таблице Конфигурация серверов.

Проверка работыПроверка работы

После подключения попросите AI-агента вызвать один из инструментов MCP-сервера.

Примеры запросов:

Разверни виртуальную машину в Yandex Cloud с публичным IP-адресом.

Найди в документации Yandex Cloud, как настроить Terraform provider.

Создай бакет Object Storage для статического сайта.

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

Полезные ссылкиПолезные ссылки

• Репозиторий Yandex Cloud MCP на GitHub

• Пакет @yandex-cloud/mcp в npm

• Документация Yandex Cloud в AI‑инструментах

• MCP-сервер

• IAM-токен

• Начало работы с интерфейсом командной строки Yandex Cloud CLI

• Рекомендуемые MCP-серверы Code Assistant