← Вернуться в dashboard

Wordstat + MCP

Как подключить Yandex Wordstat к нашему MCP

Настраиваем новый способ подключения через Yandex Cloud Search API: создаем API Key, берем Folder ID, выдаем роль search-api.webSearch.userи сохраняем подключение в настройках MCP.

Что понадобится

Аккаунт Яндекса, активный биллинг, API Key и Folder ID каталога.

Куда вставлять

Dashboard → Wordstat API настройки → новое подключение Yandex Cloud.

Как проверить

Кнопка сохранения сама проверит подключение и покажет ошибку, если что-то не так.

Быстрый маршрут

  1. 1. Войти в Yandex AI Studio.
  2. 2. Привязать карту в биллинге.
  3. 3. Создать и сохранить API Key.
  4. 4. В Cloud Console скопировать Folder ID.
  5. 5. Выдать роль search-api.webSearch.user.
  6. 6. Вставить API Key и Folder ID в настройки MCP.

Настройка в Yandex Cloud

Шаг 1. Откройте Yandex AI Studio

Перейдите на aistudio.yandex.ru. Через AI Studio удобно создать API Key для Yandex Search API.

Шаг 1. Откройте Yandex AI Studio

Шаг 2. Войдите в аккаунт Яндекса

Нажмите «Войти» и авторизуйтесь в том аккаунте, где будет создано облако и подключен биллинг.

Шаг 2. Войдите в аккаунт Яндекса

Шаг 3. Привяжите карту к биллингу

Для Search API нужен активный биллинг. Обычно пополнять баланс не нужно, но карта должна быть привязана, иначе API часто отвечает 403.

Шаг 3. Привяжите карту к биллингу

Шаг 4. Нажмите «Создать API-ключ»

В AI Studio откройте создание API-ключа. Этот ключ будет использоваться нашим MCP для запросов к Wordstat через Yandex Search API.

Шаг 4. Нажмите «Создать API-ключ»

Шаг 5. Заполните параметры ключа

Укажите понятное описание, например «MCP Wordstat». Если доступен выбор области прав, добавьте yc.search-api.execute.

Шаг 5. Заполните параметры ключа

Шаг 6. Скопируйте API Key

Сохраните ключ сразу: Яндекс показывает его один раз. Если закрыть окно без копирования, ключ придется пересоздать.

Шаг 6. Скопируйте API Key

Шаг 7. Перейдите в Yandex Cloud Console

В списке сервисов откройте Yandex Cloud Console. Там нужно взять Folder ID и проверить права доступа.

Шаг 7. Перейдите в Yandex Cloud Console

Шаг 8. Скопируйте Folder ID

Откройте нужный каталог. Folder ID находится в адресной строке после /folders/. Обычно он начинается с b1.

Шаг 8. Скопируйте Folder ID

Шаг 9. Откройте IAM

В каталоге перейдите в «Ресурсы» и откройте Identity and Access Management.

Шаг 9. Откройте IAM

Шаг 10. Проверьте роль Search API

Для работы Wordstat нужна роль search-api.webSearch.user. Если ее нет, назначьте роль сервисному аккаунту или субъекту, который использует ключ.

Шаг 10. Проверьте роль Search API

Шаг 11. Откройте сервисный аккаунт

Если роль не назначена, перейдите в нужный сервисный аккаунт, чтобы выдать доступ.

Шаг 11. Откройте сервисный аккаунт

Шаг 12. Перейдите в права доступа

Откройте вкладку «Права доступа». Здесь управляются роли в каталоге.

Шаг 12. Перейдите в права доступа

Шаг 13. Нажмите «Назначить роли»

Добавьте новое назначение роли для нужного сервисного аккаунта.

Шаг 13. Нажмите «Назначить роли»

Шаг 14. Выберите, кому выдать доступ

В поле «Кому выдать доступ» выберите сервисный аккаунт и укажите нужный аккаунт.

Шаг 14. Выберите, кому выдать доступ

Шаг 15. Добавьте роль search-api.webSearch.user

В поиске ролей введите search-api.webSearch.user и выберите роль user для Search API.

Шаг 15. Добавьте роль search-api.webSearch.user

Шаг 16. Сохраните назначение роли

После сохранения у ключа и каталога должны быть права на выполнение запросов Search API.

Подключение в нашем MCP

В отличие от Make, здесь не нужно создавать connection в стороннем сценарии. Данные сохраняются прямо в настройках MCP и используются инструментами wordstat_get_top_requests,wordstat_get_dynamics и wordstat_get_regions.

  1. Откройте dashboard MCP и перейдите в раздел «Wordstat API настройки».
  2. В блоке «Новое подключение Wordstat через Yandex Cloud» вставьте API Key и Folder ID.
  3. Оставьте режим «Авто» или выберите «Новый Yandex Cloud Search API».
  4. Нажмите «Проверить и сохранить новое подключение Wordstat». Если API вернет ошибку, настройки не сохранятся, а dashboard покажет причину.
  5. После успешного сохранения включите Wordstat-инструменты в профиле MCP/GPT Actions, если они еще не включены.
Открыть настройки MCPОткрыть Yandex AI Studio

Если подключение не сохраняется

401

API Key неполный, с пробелами или уже удален. Пересоздайте ключ и вставьте его заново.

403

Чаще всего не привязана карта, не подключен биллинг, не выдана роль search-api.webSearch.user или ключ создан не с той областью доступа.

Folder ID

Берите ID каталога из URL после /folders/, а не ID облака и не ID сервисного аккаунта.

429

Превышены квоты Yandex Search API. Проверьте лимиты в Yandex Cloud.