
Yandex Search MCP: поиск Яндекса для агента в Claude, Cursor и VS Code
Даёт агенту поиск Яндекса через Yandex Search API: ответ со ссылками на источники или короткую сводку модели Yazeka. Сервер от Яндекса подключается по удалённому адресу с ключом и ID каталога Yandex Cloud.
Как подключить
Что сделать до подключения
Аккаунт Yandex Cloud с подключённым Yandex Search API
Сервисный аккаунт в каталоге с ролью search-api.editor
ApiKeyAPI-ключ сервисного аккаунта Yandex Cloud с областью действия yc.search-api.execute
FolderIdID каталога 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.
Файл ~/.codex/config.toml или .codex/config.toml в доверенном проекте. Можно и командой codex mcp add. Подробно о Codex
[mcp_servers.yandex-search]
url = "https://d5de9siimt9bkld7viic.emzafcgx.apigw.yandexcloud.net:3000/sse"
http_headers = { "ApiKey" = "<ваш API-ключ>", "FolderId" = "<ID каталога>" }Проверка: В интерфейсе codex введите /mcp: появится список активных серверов. Из терминала то же покажет codex mcp list.
Файл ~/.cursor/mcp.json для всех проектов или .cursor/mcp.json в папке проекта. Подробно о Cursor
{
"mcpServers": {
"yandex-search": {
"url": "https://d5de9siimt9bkld7viic.emzafcgx.apigw.yandexcloud.net:3000/sse",
"headers": {
"ApiKey": "<ваш API-ключ>",
"FolderId": "<ID каталога>"
}
}
}
}Проверка: Откройте Customize в боковой панели: там список серверов с переключателями. Ошибки подключения смотрите в панели Output (Cmd+Shift+U), пункт MCP Logs в выпадающем списке.
Файл .mcp.json в корне проекта или ~/.copilot/mcp-config.json для всех проектов. Подробно о VS Code
{
"mcpServers": {
"yandex-search": {
"type": "http",
"url": "https://d5de9siimt9bkld7viic.emzafcgx.apigw.yandexcloud.net:3000/sse",
"headers": {
"ApiKey": "<ваш API-ключ>",
"FolderId": "<ID каталога>"
}
}
}
}Проверка: Попросите Copilot выполнить безобидную задачу через сервер и раскройте вызов инструмента в чате. Одна запись в конфиге подключение не подтверждает.
Файл ~/.qwen/settings.json или .qwen/settings.json в проекте. Подробно о Qwen Code
{
"mcpServers": {
"yandex-search": {
"httpUrl": "https://d5de9siimt9bkld7viic.emzafcgx.apigw.yandexcloud.net:3000/sse",
"headers": {
"ApiKey": "<ваш API-ключ>",
"FolderId": "<ID каталога>"
}
}
}
}Проверка: Запустите qwen и введите /mcp: откроется окно управления серверами. Из терминала статус покажет qwen mcp list.
Файл ~/.gemini/settings.json или .gemini/settings.json в проекте. Подробно о Gemini CLI
{
"mcpServers": {
"yandex-search": {
"httpUrl": "https://d5de9siimt9bkld7viic.emzafcgx.apigw.yandexcloud.net:3000/sse",
"headers": {
"ApiKey": "<ваш API-ключ>",
"FolderId": "<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-search": {
"type": "remote",
"url": "https://d5de9siimt9bkld7viic.emzafcgx.apigw.yandexcloud.net:3000/sse",
"headers": {
"ApiKey": "<ваш API-ключ>",
"FolderId": "<ID каталога>"
}
}
}
}
}Проверка: opencode mcp list показывает состояние каждого сервера, подключённый выглядит как ✓ context7 connected. Внутри OpenCode то же видно в /mcps.
Настройки → Разработчик → Изменить конфиг: файл claude_desktop_config.json. После правки перезапустите приложение. Подробно о Claude Desktop
Customize → Connectors → добавить свой коннектор.
Адрес сервера: https://d5de9siimt9bkld7viic.emzafcgx.apigw.yandexcloud.net:3000/sse
Request headers: ApiKey: <ваш API-ключ>; FolderId: <ID каталога>Проверка: Нажмите «Add files, connectors, and more /» в левом нижнем углу поля ввода, наведите на Connectors и откройте Manage connectors. Выберите сервер, чтобы увидеть его инструменты.
Вкладка Program → Install → Edit mcp.json. Подробно о LM Studio
{
"mcpServers": {
"yandex-search": {
"url": "https://d5de9siimt9bkld7viic.emzafcgx.apigw.yandexcloud.net:3000/sse",
"headers": {
"ApiKey": "<ваш API-ключ>",
"FolderId": "<ID каталога>"
}
}
}
}Проверка: Попросите модель в чате выполнить задачу через инструмент сервера. Через API сервер из mcp.json вызывают по id в integrations, например mcp/playwright.
Проверить сервер сейчас →Собрать вместе с другими серверами в одном mcp.json →
Инструменты сервера
web_search_postищет в интернете и отдаёт ответ с источникамиai_search_postищет и отдаёт сводку модели YazekaЧто попросить агента
Для каких задач
Ограничения
Нужен аккаунт Yandex Cloud с доступом к Search API, API-ключ сервисного аккаунта и ID каталога; без них сервер не ищет
Регион выдачи — только tr (турецкий) или en (международный), по умолчанию турецкий; русской выдачи в коде сервера нет
У репозитория 47 звёзд, последний раз он обновлялся в марте 2026 года
Имена инструментов различаются: на удалённом адресе ai_search_post и web_search_post, в локальной версии ai_search_with_yazeka и web_search