Yandex Search MCP: поиск Яндекса для агента в Claude, Cursor и VS Code

yandex/yandex-search-mcp-server· Проверено 12.11.2026· 48на GitHub

Даёт агенту поиск Яндекса через Yandex Search API: ответ со ссылками на источники или короткую сводку модели Yazeka. Сервер от Яндекса подключается по удалённому адресу с ключом и ID каталога Yandex Cloud.

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

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

1

Аккаунт Yandex Cloud с подключённым Yandex Search API

2

Сервисный аккаунт в каталоге с ролью search-api.editor

3
ApiKey

API-ключ сервисного аккаунта Yandex Cloud с областью действия yc.search-api.execute

4
FolderId

ID каталога Yandex Cloud, в котором создан сервисный аккаунт

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

Впишите ключи, и они встанут во все конфиги ниже. Конфиг собирается в браузере.

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

claude mcp add --transport http yandex-search https://d5de9siimt9bkld7viic.emzafcgx.apigw.yandexcloud.net:3000/sse \
  --header 'ApiKey: <ваш API-ключ>' \
  --header 'FolderId: <ID каталога>'

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

Проверить сервер сейчас →Собрать вместе с другими серверами в одном mcp.json →

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

web_search_postищет в интернете и отдаёт ответ с источниками
ai_search_postищет и отдаёт сводку модели Yazeka

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

«Найди через yandexSearch, какие фреймворки для ИИ-агентов популярны в 2025 году»Агент вызовет web_search_post и ответит по результатам выдачи со ссылками
«Кто выиграл последнюю гонку Формулы-1 в 2025 году?»Агент вызовет ai_search_post и вернёт сводку Yazeka по найденным страницам
«Найди в международной выдаче свежие новости о <тема> и дай ссылки»Агент вызовет web_search_post с search_region en

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

Найти свежую информацию в интернете и получить ответ со ссылками на источники
Получить короткую сводку модели Yazeka по результатам поиска на сложный вопрос
Подключить поиск Яндекса к Claude Desktop, Cursor и VS Code по одному адресу
Развернуть сервер у себя в Docker, Podman или через Python

Ограничения

!

Нужен аккаунт Yandex Cloud с доступом к Search API, API-ключ сервисного аккаунта и ID каталога; без них сервер не ищет

!

Регион выдачи — только tr (турецкий) или en (международный), по умолчанию турецкий; русской выдачи в коде сервера нет

!

У репозитория 47 звёзд, последний раз он обновлялся в марте 2026 года

!

Имена инструментов различаются: на удалённом адресе ai_search_post и web_search_post, в локальной версии ai_search_with_yazeka и web_search

Если не работает

Локальный сервер не запускается
Проверьте, что зависимости поставлены: pip install -r requirements.txt.
Ошибка авторизации при поиске
Проверьте, что SEARCH_API_KEY задан в окружении или в конфиге клиента и ключ скопирован целиком.
Локальная и Docker-версия мешают друг другу
Держите запущенным только один экземпляр сервера: локальный или в контейнере.

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

Где взять ApiKey и FolderId?
Создайте в Yandex Cloud сервисный аккаунт с ролью search-api.editor и выпустите для него API-ключ с областью yc.search-api.execute. FolderId — ID каталога, где лежит этот аккаунт.
Ищет ли сервер по русской выдаче Яндекса?
Нет. Параметр search_region принимает только tr и en: турецкую и международную выдачу. Если запрос явно не турецкий, агент должен сам поставить en.
Чем ai_search отличается от web_search?
web_search возвращает результаты с источниками и подходит для простых запросов. ai_search нужен для сложных вопросов: модель Yazeka собирает по выдаче короткий ответ.
Можно запустить сервер у себя, без удалённого адреса?
Да. Склонируйте репозиторий и соберите образ Docker или Podman либо поставьте зависимости pip install -r requirements.txt и запускайте python3 server.py. Ключ и каталог передаются переменными SEARCH_API_KEY и FOLDER_ID, нужен Python 3.10 или новее.
Как подключить Yandex Search MCP к Cursor?
В Settings → Tools and Integrations нажмите Add Custom MCP и пропишите сервер с type sse, адресом https://d5de9siimt9bkld7viic.emzafcgx.apigw.yandexcloud.net:3000/sse и заголовками ApiKey и FolderId.
Как подключить Yandex Search MCP к Claude Desktop?
Включите Developer Mode, откройте claude_desktop_config.json и добавьте сервер через npx -y mcp-remote с адресом /sse и параметрами --header ApiKey:<ключ> и --header FolderId:<каталог>. Затем полностью закройте и снова откройте Claude Desktop.
Работает ли сервер из России?
Сервер работает в Yandex Cloud и ходит в Yandex Search API, зарубежные аккаунты не нужны; оплата и доступ — через ваш аккаунт Yandex Cloud.

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