Yandex Cloud MCP

yandex-cloud/mcp· Проверено 12.11.2026· 49на GitHub

Набор серверов Yandex Cloud: Toolkit разворачивает приложения на виртуальных машинах, в Object Storage и YDB, отдельные серверы ищут по документации, управляют функциями, контейнерами и API Gateway.

3 реализации:

Запуск через npx с входом в Yandex Cloud через браузер; 42 инструмента для Compute, VPC, IAM, Object Storage и Managed YDB.

Как подключить

Что сделать до подключения

Node.js 18.0.0 или новее

Роли в Yandex Cloud для нужных операций, например editor или compute.admin

Конфиг для вашего клиента

Команда в терминале, в папке проекта. Флаг --scope user подключит сервер для всех проектов. Подробно о Claude Code

claude mcp add --transport stdio yandex-cloud \
  -- npx -y @yandex-cloud/mcp -s toolkit -H 'Folder-Id:<ID каталога>'

Проверка: claude mcp list показывает статус рядом с каждым сервером: ✔ Connected, ! Needs authentication или ✘ Failed to connect. Внутри сессии то же видно по команде /mcp.

Файл ~/.codex/config.toml или .codex/config.toml в доверенном проекте. Можно и командой codex mcp add. Подробно о Codex

[mcp_servers.yandex-cloud]
command = "npx"
args = ["-y", "@yandex-cloud/mcp", "-s", "toolkit", "-H", "Folder-Id:<ID каталога>"]

Проверка: В интерфейсе codex введите /mcp: появится список активных серверов. Из терминала то же покажет codex mcp list.

Файл ~/.cursor/mcp.json для всех проектов или .cursor/mcp.json в папке проекта. Подробно о Cursor

{
  "mcpServers": {
    "yandex-cloud": {
      "command": "npx",
      "args": [
        "-y",
        "@yandex-cloud/mcp",
        "-s",
        "toolkit",
        "-H",
        "Folder-Id:<ID каталога>"
      ]
    }
  }
}

Проверка: Откройте Customize в боковой панели: там список серверов с переключателями. Ошибки подключения смотрите в панели Output (Cmd+Shift+U), пункт MCP Logs в выпадающем списке.

Файл .mcp.json в корне проекта или ~/.copilot/mcp-config.json для всех проектов. Подробно о VS Code

{
  "mcpServers": {
    "yandex-cloud": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@yandex-cloud/mcp",
        "-s",
        "toolkit",
        "-H",
        "Folder-Id:<ID каталога>"
      ]
    }
  }
}

Проверка: Попросите Copilot выполнить безобидную задачу через сервер и раскройте вызов инструмента в чате. Одна запись в конфиге подключение не подтверждает.

Файл ~/.qwen/settings.json или .qwen/settings.json в проекте. Подробно о Qwen Code

{
  "mcpServers": {
    "yandex-cloud": {
      "command": "npx",
      "args": [
        "-y",
        "@yandex-cloud/mcp",
        "-s",
        "toolkit",
        "-H",
        "Folder-Id:<ID каталога>"
      ]
    }
  }
}

Проверка: Запустите qwen и введите /mcp: откроется окно управления серверами. Из терминала статус покажет qwen mcp list.

Файл ~/.gemini/settings.json или .gemini/settings.json в проекте. Подробно о Gemini CLI

{
  "mcpServers": {
    "yandex-cloud": {
      "command": "npx",
      "args": [
        "-y",
        "@yandex-cloud/mcp",
        "-s",
        "toolkit",
        "-H",
        "Folder-Id:<ID каталога>"
      ]
    }
  }
}

Проверка: gemini mcp list показывает каждый сервер, его настройки и статус Connected или Disconnected. В сессии /mcp выводит CONNECTED, CONNECTING или DISCONNECTED и список инструментов.

Файл opencode.json в папке проекта или ~/.config/opencode/opencode.json. Подробно о OpenCode

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "servers": {
      "yandex-cloud": {
        "type": "local",
        "command": [
          "npx",
          "-y",
          "@yandex-cloud/mcp",
          "-s",
          "toolkit",
          "-H",
          "Folder-Id:<ID каталога>"
        ]
      }
    }
  }
}

Проверка: opencode mcp list показывает состояние каждого сервера, подключённый выглядит как ✓ context7 connected. Внутри OpenCode то же видно в /mcps.

Настройки → Разработчик → Изменить конфиг: файл claude_desktop_config.json. После правки перезапустите приложение. Подробно о Claude Desktop

{
  "mcpServers": {
    "yandex-cloud": {
      "command": "npx",
      "args": [
        "-y",
        "@yandex-cloud/mcp",
        "-s",
        "toolkit",
        "-H",
        "Folder-Id:<ID каталога>"
      ]
    }
  }
}

Проверка: Нажмите «Add files, connectors, and more /» в левом нижнем углу поля ввода, наведите на Connectors и откройте Manage connectors. Выберите сервер, чтобы увидеть его инструменты.

Вкладка Program → Install → Edit mcp.json. Подробно о LM Studio

{
  "mcpServers": {
    "yandex-cloud": {
      "command": "npx",
      "args": [
        "-y",
        "@yandex-cloud/mcp",
        "-s",
        "toolkit",
        "-H",
        "Folder-Id:<ID каталога>"
      ]
    }
  }
}

Проверка: Попросите модель в чате выполнить задачу через инструмент сервера. Через API сервер из mcp.json вызывают по id в integrations, например mcp/playwright.

Инструменты сервера

instances_listперечисляет виртуальные машины

instance_createсоздаёт виртуальную машину

instance_startзапускает машину

instance_stopостанавливает машину

instance_restartперезагружает машину

instance_deleteудаляет машину

image_get_latest_by_familyнаходит свежий образ семейства

disks_listперечисляет диски

networks_listперечисляет сети

network_security_groups_listпоказывает группы безопасности

service_account_createсоздаёт сервисный аккаунт

folder_accesses_updateменяет права на каталог

ydb_serverless_database_createсоздаёт бессерверную базу YDB

bucket_createсоздаёт бакет Object Storage

buckets_listперечисляет бакеты

Показано 15 из 42.

Тот же Toolkit на серверах Yandex Cloud без установки; вход по IAM-токену, который живёт не больше 12 часов.

Как подключить

Что сделать до подключения

Роли в Yandex Cloud для нужных операций, например editor или compute.admin

Authorization

IAM-токен: команда yc iam create-token, для сервисного аккаунта — с флагом --impersonate-service-account-id; токен живёт до 12 часов

Конфиг для вашего клиента

Команда в терминале, в папке проекта. Флаг --scope user подключит сервер для всех проектов. Подробно о Claude Code

claude mcp add --transport http mcp https://toolkit.mcp.cloud.yandex.net/mcp \
  --header 'Authorization: Bearer <IAM-токен>' \
  --header 'Folder-Id: <ID каталога>'

Файл ~/.codex/config.toml или .codex/config.toml в доверенном проекте. Можно и командой codex mcp add. Подробно о Codex

[mcp_servers.mcp]
url = "https://toolkit.mcp.cloud.yandex.net/mcp"
http_headers = { "Authorization" = "Bearer <IAM-токен>", "Folder-Id" = "<ID каталога>" }

Файл ~/.cursor/mcp.json для всех проектов или .cursor/mcp.json в папке проекта. Подробно о Cursor

{
  "mcpServers": {
    "mcp": {
      "url": "https://toolkit.mcp.cloud.yandex.net/mcp",
      "headers": {
        "Authorization": "Bearer <IAM-токен>",
        "Folder-Id": "<ID каталога>"
      }
    }
  }
}

Файл .mcp.json в корне проекта или ~/.copilot/mcp-config.json для всех проектов. Подробно о VS Code

{
  "mcpServers": {
    "mcp": {
      "type": "http",
      "url": "https://toolkit.mcp.cloud.yandex.net/mcp",
      "headers": {
        "Authorization": "Bearer <IAM-токен>",
        "Folder-Id": "<ID каталога>"
      }
    }
  }
}

Файл ~/.qwen/settings.json или .qwen/settings.json в проекте. Подробно о Qwen Code

{
  "mcpServers": {
    "mcp": {
      "httpUrl": "https://toolkit.mcp.cloud.yandex.net/mcp",
      "headers": {
        "Authorization": "Bearer <IAM-токен>",
        "Folder-Id": "<ID каталога>"
      }
    }
  }
}

Файл ~/.gemini/settings.json или .gemini/settings.json в проекте. Подробно о Gemini CLI

{
  "mcpServers": {
    "mcp": {
      "httpUrl": "https://toolkit.mcp.cloud.yandex.net/mcp",
      "headers": {
        "Authorization": "Bearer <IAM-токен>",
        "Folder-Id": "<ID каталога>"
      }
    }
  }
}

Файл opencode.json в папке проекта или ~/.config/opencode/opencode.json. Подробно о OpenCode

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "servers": {
      "mcp": {
        "type": "remote",
        "url": "https://toolkit.mcp.cloud.yandex.net/mcp",
        "headers": {
          "Authorization": "Bearer <IAM-токен>",
          "Folder-Id": "<ID каталога>"
        }
      }
    }
  }
}

Customize → Connectors → добавить свой коннектор.
Адрес сервера: https://toolkit.mcp.cloud.yandex.net/mcp
Request headers: Authorization: Bearer <IAM-токен>; Folder-Id: <ID каталога>

Вкладка Program → Install → Edit mcp.json. Подробно о LM Studio

{
  "mcpServers": {
    "mcp": {
      "url": "https://toolkit.mcp.cloud.yandex.net/mcp",
      "headers": {
        "Authorization": "Bearer <IAM-токен>",
        "Folder-Id": "<ID каталога>"
      }
    }
  }
}

Бесплатный поиск по документации Yandex Cloud без входа в аккаунт.

Как подключить

Конфиг для вашего клиента

Команда в терминале, в папке проекта. Флаг --scope user подключит сервер для всех проектов. Подробно о Claude Code

claude mcp add --transport http mcp https://docs.mcp.cloud.yandex.net/mcp

Файл ~/.codex/config.toml или .codex/config.toml в доверенном проекте. Можно и командой codex mcp add. Подробно о Codex

[mcp_servers.mcp]
url = "https://docs.mcp.cloud.yandex.net/mcp"

Файл ~/.cursor/mcp.json для всех проектов или .cursor/mcp.json в папке проекта. Подробно о Cursor

{
  "mcpServers": {
    "mcp": {
      "url": "https://docs.mcp.cloud.yandex.net/mcp"
    }
  }
}

Файл .mcp.json в корне проекта или ~/.copilot/mcp-config.json для всех проектов. Подробно о VS Code

{
  "mcpServers": {
    "mcp": {
      "type": "http",
      "url": "https://docs.mcp.cloud.yandex.net/mcp"
    }
  }
}

Файл ~/.qwen/settings.json или .qwen/settings.json в проекте. Подробно о Qwen Code

{
  "mcpServers": {
    "mcp": {
      "httpUrl": "https://docs.mcp.cloud.yandex.net/mcp"
    }
  }
}

Файл ~/.gemini/settings.json или .gemini/settings.json в проекте. Подробно о Gemini CLI

{
  "mcpServers": {
    "mcp": {
      "httpUrl": "https://docs.mcp.cloud.yandex.net/mcp"
    }
  }
}

Файл opencode.json в папке проекта или ~/.config/opencode/opencode.json. Подробно о OpenCode

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "servers": {
      "mcp": {
        "type": "remote",
        "url": "https://docs.mcp.cloud.yandex.net/mcp"
      }
    }
  }
}

Customize → Connectors → добавить свой коннектор.
Адрес сервера: https://docs.mcp.cloud.yandex.net/mcp

Вкладка Program → Install → Edit mcp.json. Подробно о LM Studio

{
  "mcpServers": {
    "mcp": {
      "url": "https://docs.mcp.cloud.yandex.net/mcp"
    }
  }
}

Инструменты сервера

documentation_generative_searchищет по документации Yandex Cloud

Что попросить агента

«Разверни мой сервис в Yandex Cloud с публичным IP-адресом»Агент подберёт образ через image_get_latest_by_family, посмотрит сети networks_list и создаст машину instance_create

«Создай бакет S3 для раздачи статических страниц»Агент вызовет bucket_create

«Создай базу YDB для моего сервера из этого проекта»Агент вызовет ydb_serverless_database_create

«Все ли мои виртуальные машины запущены? Опиши правила групп безопасности»Агент вызовет instances_list и network_security_groups_list

«Как настроить Terraform для провайдера Yandex Cloud?»Агент вызовет documentation_generative_search и ответит по документации

Для каких задач

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

Создать бакет S3 для раздачи статических страниц

Завести бессерверную базу YDB под приложение из IDE

Проверить, все ли виртуальные машины запущены, и разобрать правила групп безопасности

Ответить на вопрос по документации: как поставить yc CLI или настроить Terraform

Ограничения

Toolkit создаёт и меняет только бессерверные базы YDB

Управлять доступом Toolkit умеет только на уровне каталогов

IAM-токен для удалённого подключения живёт не больше 12 часов, потом его нужно выпустить заново

Серверы Functions, Triggers, Workflows, API Gateway и MCP Gateway пока в статусе Preview

Какую реализацию выбрать

Реализация	Кто делает	Звёзды	Запуск	Ключ	Инструменты	Обновлён
Toolkit MCP Server (npm)разработчик сервиса	Yandex Cloud	49	локально	вход	42	24 апреля 2026
Toolkit MCP Server (удалённый)разработчик сервиса	Yandex Cloud	49	HTTP	токен	42	24 апреля 2026
Documentation MCP Serverразработчик сервиса	Yandex Cloud	49	HTTP	не нужен	1	24 апреля 2026

Частые вопросы

Какие ещё серверы есть в репозитории?

Кроме Toolkit и документации: Yandex Search для веб-поиска, Functions, Serverless Containers, Triggers, Workflows, API Gateway, MCP Gateway и Data Catalog Consumer. Нужный сервер выбирается флагом -s, например search, functions или docs.

Как войти в Yandex Cloud при запуске через npx?

Запустите пакет без флагов авторизации, и вход пройдёт в браузере. Конкретный аккаунт задаётся флагами -S <ID пользователя или сервисного аккаунта> или -u <email>, профиль yc CLI — флагом -p <профиль>.

Зачем заголовки Cloud-Id и Folder-Id?

Они необязательны и подставляют облако и каталог по умолчанию в поля cloud_id и folder_id инструментов, чтобы агент не спрашивал их каждый раз.

Нужен ли аккаунт для поиска по документации?

Нет. Удалённый сервер docs.mcp.cloud.yandex.net подключается без токена, а через npx он запускается с флагом --no-auth.

Работает ли сервер из России?

Серверы ведёт Yandex Cloud, удалённые эндпоинты стоят в зоне cloud.yandex.net; нужен только аккаунт Yandex Cloud с ролями.

Yandex Cloud MCP

Как подключить

Что сделать до подключения

Конфиг для вашего клиента

Инструменты сервера

Как подключить

Что сделать до подключения

Конфиг для вашего клиента

Как подключить

Конфиг для вашего клиента

Инструменты сервера

Что попросить агента

Для каких задач

Ограничения

Какую реализацию выбрать

Частые вопросы

Похожие серверы