Yandex Cloud·yandex-cloud
Yandex Cloud MCP — подключение и инструкция
Официальные Yandex Cloud MCP Servers подключают ИИ-клиента к отдельным сервисам облака: инфраструктуре, документации, поиску и serverless.
Что умеет этот сервер
Официальные Yandex Cloud MCP Servers подключают ИИ-клиента к отдельным сервисам облака: инфраструктуре, документации, поиску и serverless.
Это семейство серверов с разными назначениями.
Прочитай список VM и параметры тестовой security group.
Задача для знакомства
Через Yandex Cloud Toolkit MCP прочитай VM и security groups указанной тестовой папки. Ресурсы и права не изменяй.
Уточнить результат
Сверь организацию и folder, а не только успешный OAuth. IAM token для HTTP действует не более 12 часов; при истечении его нужно обновить.
Как подключить
Выберите подходящий способПодключить Yandex Cloud MCP
Добавь npx -y @yandex-cloud/mcp -s toolkit. По умолчанию откроется browser OAuth; для yc profile используй -p. При необходимости передай Cloud-Id и Folder-Id через -H по README. Альтернатива — Streamable HTTP https://toolkit.mcp.cloud.yandex.net/mcp с Bearer IAM token.
Что понадобится
- Node.js 18+ для npm client и необходимые IAM-роли в выбранном cloud/folder. yc CLI нужен только для CLI-auth, не для обычного OAuth.
- 01
Подготовь окружение
Node.js 18+ для npm client и необходимые IAM-роли в выбранном cloud/folder. yc CLI нужен только для CLI-auth, не для обычного OAuth.
- 02
Установи и настрой
Добавь npx -y @yandex-cloud/mcp -s toolkit. По умолчанию откроется browser OAuth; для yc profile используй -p. При необходимости передай Cloud-Id и Folder-Id через -H по README. Альтернатива — Streamable HTTP https://toolkit.mcp.cloud.yandex.net/mcp с Bearer IAM token.
- 03
Открой новую сессию
Убедись, что клиент видит инструменты именно этого сервера, и выполни первый небольшой сценарий.
Команда подключения из документации
npx -y @yandex-cloud/mcp -s toolkitПервый запрос — пример для чата агента
Через Yandex Cloud Toolkit MCP прочитай VM и security groups указанной тестовой папки. Ресурсы и права не изменяй.Как проверить
Сверь организацию и folder, а не только успешный OAuth. IAM token для HTTP действует не более 12 часов; при истечении его нужно обновить.
Подставь собственные пути, адреса и доступы только в локальные настройки. Команды запуска, MCP-конфигурация и текст первого запроса вводятся в разных местах; их назначение указано над примером.
README и установка автораЧто умеет Yandex Cloud
Официальные Yandex Cloud MCP Servers подключают ИИ-клиента к отдельным сервисам облака: инфраструктуре, документации, поиску и serverless.
Это семейство серверов с разными назначениями. Toolkit работает с Compute, VPC, IAM, Storage и Managed YDB; docs и search подключаются отдельно.
Что подготовить перед подключением
Node.js 18+ для npm client и необходимые IAM-роли в выбранном cloud/folder. yc CLI нужен только для CLI-auth, не для обычного OAuth.
Как установить и подключить
Добавь npx -y @yandex-cloud/mcp -s toolkit. По умолчанию откроется browser OAuth; для yc profile используй -p. При необходимости передай Cloud-Id и Folder-Id через -H по README. Альтернатива — Streamable HTTP https://toolkit.mcp.cloud.yandex.net/mcp с Bearer IAM token.
Добавь выбранную запись в существующую конфигурацию клиента, сохранив остальные серверы. Формат и расположение настроек зависят от клиента: JSON-пример для Claude Desktop не нужно целиком вставлять в TOML-файл другого приложения. После изменения перечитай конфигурацию или открой новую сессию.
Как пользоваться: первый сценарий
Прочитай список VM и параметры тестовой security group. Для создания ресурса сначала составь план с cloud/folder, регионом, бюджетом и ожидаемыми изменениями.
Как проверить результат и решить проблемы
Сверь организацию и folder, а не только успешный OAuth. IAM token для HTTP действует не более 12 часов; при истечении его нужно обновить.
Если инструмент не появился, проверь запуск процесса или доступность endpoint, журнал клиента и права доступа. Если соединение есть, но операция не выполняется, сверяй входные параметры и ограничения сервиса; повторять изменяющий запрос без проверки результата не стоит.
Ограничения
Облачные операции могут создавать расходы и менять IAM или сеть. Не назначай максимальные роли всем сервисам только ради появления tools.
Исходники и документация
Репозиторий: yandex-cloud/mcp. В README доступны актуальные варианты установки, требования и примеры настройки. Перед обновлением сохрани рабочую конфигурацию и проверь изменения версии.
Другие подключения — в каталоге MCP-серверов Нейролюба.