Короткий ответ
У Яндекса по MCP есть три разные вещи, и их регулярно путают:
- MCP Hub в Yandex AI Studio — место, где вы держите свои MCP-серверы: подключаете внешний, поднимаете из шаблона или собираете с нуля.
- Пять партнёрских шаблонов — готовые серверы к Контур.Фокусу, amoCRM, Яндекс Трекеру, Яндекс Поиску и SourceCraft. Ставятся выбором из списка и вводом токена.
- Yandex Search MCP — отдельный открытый сервер, который подключается к Claude, Claude Code и Cursor напрямую, без всякого AI Studio. Это то, что нужно большинству.
Ниже — что из этого кому подходит. Данные проверены 21 августа 2026.
Yandex Search MCP: поиск в интернете для вашего агента
Самая полезная часть для человека, который не строит агентов на инфраструктуре Яндекса, а просто работает в Claude Code или Cursor.
Сервер лежит в открытом репозитории Яндекса (yandex/yandex-search-mcp-server, Python) и даёт агенту два инструмента:
web_search_post— живой поиск в интернете с возвратом ответа и источников;ai_search_post— то же, но ответ уже сгенерирован моделью Яндекса поверх найденного.
Зачем это нужно: у модели есть граница знаний, и всё, что произошло после неё, она либо не знает, либо додумывает. Поиск закрывает разрыв — агент идёт и смотрит, вместо того чтобы вспоминать.
Подключение — удалённое, ничего ставить не надо. Готовый эндпоинт уже поднят, конфигурация для Claude Desktop выглядит так:
{
"mcpServers": {
"yandexSearch": {
"command": "npx",
"args": [
"-y", "mcp-remote",
"https://d5de9siimt9bkld7viic.emzafcgx.apigw.yandexcloud.net:3000/sse",
"--header", "ApiKey:<ваш_ключ>",
"--header", "FolderId:<ваш_folder_id>"
]
}
}
}
Что понадобится: быть клиентом Yandex Search API, API-ключ с областью yc.search-api.execute и идентификатор каталога, где у сервисного аккаунта есть роль search-api.editor. Бесплатно это не работает — Search API платный.
ПолезноЕсли поиск нужен «просто чтобы агент не выдумывал», сначала посмотрите бесплатные варианты вроде Fetch и Context7 из нашей подборки серверов. Яндекс-поиск оправдан там, где важна именно российская выдача.
MCP Hub: где живут ваши серверы
MCP Hub — часть Yandex AI Studio. Это не каталог чужих серверов, а место, где вы регистрируете свои: агенты платформы обращаются к ним по единому адресу, а платформа берёт на себя доступы и авторизацию.
Три пути, которые он даёт:
- подключить внешний MCP-сервер — тот, что уже где-то работает;
- создать из шаблона — партнёрские серверы, о них ниже;
- собрать с нуля — через интерфейс или через API платформы.
Дальше сервер подключается к агенту как инструмент типа mcp. Конфигурация компактная:
{
"type": "mcp",
"server_url": "https://your-mcp-server.example.com/sse",
"server_label": "business_tools",
"description": "Инструменты для работы с корпоративными системами",
"require_approval": "always"
}
Последнее поле важнее, чем выглядит. always — агент спрашивает подтверждение перед каждым вызовом, never — вызывает сам. Для читающих инструментов never уместен; для всего, что меняет данные, — нет.
Пять партнёрских шаблонов
Это и есть ответ на вопрос «есть ли официальный MCP у российских систем». Оказалось, что вендоры выпускают их не у себя на сайте, а шаблонами в чужом хабе.
Контур.Фокус — проверка контрагентов: сведения по ИНН, экспресс-отчёт, оценка благонадёжности, поиск организаций по руководителю, адресу и сайту. Методы req, search, scoring, briefReport. Токен берётся у самого Фокуса. Разбор целиком.
amoCRM — компании, лиды, контакты, заметки, пайплайны и задачи: чтение и запись. Аутентификация — токен в заголовке X-Auth-Token плюс имя аккаунта в X-Account-Name.
Яндекс Трекер — работа с задачами, проектами, портфелями и целями, включая массовые операции и перевод задач между очередями. Отдельная засада: чтобы обращаться к API Трекера от имени сервисного аккаунта, нужно заранее написать в поддержку Трекера, указав идентификаторы облачной организации и сервисного аккаунта. Без этого все запросы возвращают 401 Unauthorized, и понять причину по симптому невозможно.
Яндекс Поиск — тот же Search API, но обёрнутый шаблоном внутри хаба.
SourceCraft — платформа разработки Яндекса: задачи, комментарии, метки, репозитории, предложения изменений и рецензенты. Доступ по персональному токену.
Что нужно из доступов
Требования платформы, о которые спотыкаются на первом подключении:
- сервисный аккаунт с ролью
serverless.mcpGateways.invokerили выше; - дополнительно роль
serverless.mcpGateways.anonymousInvoker— именно для серверов из шаблона; - API-ключ с областью действия
yc.serverless.mcpGateways.invoke. Ключ, созданный прямо в AI Studio, эти разрешения уже имеет.
Вторая роль — самая частая причина того, что «шаблон поставился, а не работает».
Кому что подходит
| Ситуация | Что брать |
|---|---|
| Работаю в Claude Code или Cursor, нужен поиск по российской выдаче | Yandex Search MCP, удалённый эндпоинт |
| Строю агента в AI Studio, нужна проверка контрагентов | шаблон Контур.Фокус |
| Агент должен работать с задачами команды | шаблон Яндекс Трекер (сначала письмо в поддержку) |
| Нужна связка с amoCRM | шаблон amoCRM |
| Нужна система, для которой шаблона нет | свой MCP-сервер и подключение внешним в хаб |
Ограничения, о которых стоит знать заранее
Это платная инфраструктура. И Search API, и работа агентов в AI Studio тарифицируются. «Бесплатно попробовать» здесь означает пробный период, а не бесплатный тариф — в отличие от большинства открытых серверов.
Шаблоны — не то же самое, что официальная поддержка вендора. Контур или amoCRM отвечают за свой API, Яндекс — за обёртку. При проблеме вы окажетесь между двумя поддержками.
Привязка к платформе. Сервер, поднятый в MCP Hub, живёт в контуре Яндекса. Если завтра агент переедет в другое место, конфигурацию придётся собирать заново — в отличие от локального сервера, который просто переносится файлом.
Данные уходят в облако. Как и в любой облачной связке: контрагенты, задачи, содержимое CRM. Если это неприемлемо — локальная модель и локальный сервер, других вариантов нет.
Коротко о главном
- «Яндекс MCP-сервер» — это три разные вещи: хаб, партнёрские шаблоны и отдельный сервер поиска.
- Большинству нужен третий: Yandex Search MCP подключается к Claude и Cursor удалённо, даёт живой поиск с источниками, требует платного Search API.
- Шаблонов пять: Контур.Фокус, amoCRM, Яндекс Трекер, Яндекс Поиск, SourceCraft.
- Перед подключением шаблона выдайте сервисному аккаунту обе роли, иначе сервер не заработает.
- Для Трекера отдельно напишите в его поддержку, иначе будет
401.
Порядок подключения любого сервера к любому агенту — в общей инструкции. Что подключают первым — в подборке рабочих серверов.