Yandex Direct MCP — MCP-сервер для Claude Code: обзор и запуск
Управляет кампаниями, объявлениями, ставками и отчётами Яндекс Директа через API v5 прямо из чата с моделью. Помогает автоматизировать контекстную рекламу без перехода в веб-интерфейс.
claude mcp add --env YANDEX_DIRECT_TOKEN=<YANDEX_DIRECT_TOKEN> --env YANDEX_DIRECT_CLIENT_LOGIN=<YANDEX_DIRECT_CLIENT_LOGIN> --env YANDEX_DIRECT_SANDBOX=<YANDEX_DIRECT_SANDBOX> --transport stdio yandex-direct-mcp -- npx -y @stufently/yandex-direct-mcpЧто делает Yandex Direct MCP
Сервер предоставляет 43 инструмента для Директа: создание и редактирование кампаний, ключевых фраз, групп, визиток, быстрых ссылок и получение статистики. Управление ставками идёт в микроединицах (миллионных долях валюты). Поэтому любая ошибка в расчётах обойдётся дорого.
Защита от случайных трат встроена на уровне протокола. Четырнадцать опасных вызовов, включая удаление сущностей, перезапись текстов и смену ставок, требуют обязательный параметр confirm: true. Если агент забудет передать этот флаг, сервер вернёт ошибку — запрос в Яндекс даже не отправится.
Для старта нужен OAuth-токен в переменной YANDEX_DIRECT_TOKEN, а агентствам понадобится ещё и YANDEX_DIRECT_CLIENT_LOGIN. Тестировать сценарии безопаснее с включённым флагом YANDEX_DIRECT_SANDBOX=true. Эндпоинт v501 для единой перфоманс-кампании здесь недоступен из-за жёстко заданного пути /json/v5.
Какие задачи решает
- остановить или возобновить показы рекламных кампаний
- обновить ставки по ключевым фразам
- выгрузить отчёт со статистикой кликов и расходов
- отправить новые объявления на модерацию
Примеры запросов агенту
- Покажи список активных кампаний и их текущие дневные бюджеты
- Выстави ставку 45 рублей на ключевую фразу 987654321 с подтверждением
- Сформируй отчёт по расходам и показам за прошлую неделю
Как установить Yandex Direct MCP
Командой платформы
claude mcp add --env YANDEX_DIRECT_TOKEN=<YANDEX_DIRECT_TOKEN> --env YANDEX_DIRECT_CLIENT_LOGIN=<YANDEX_DIRECT_CLIENT_LOGIN> --env YANDEX_DIRECT_SANDBOX=<YANDEX_DIRECT_SANDBOX> --transport stdio yandex-direct-mcp -- npx -y @stufently/yandex-direct-mcpВместо <…> подставьте свои значения
Командой платформы
codex mcp add yandex-direct-mcp --env YANDEX_DIRECT_TOKEN=<YANDEX_DIRECT_TOKEN> --env YANDEX_DIRECT_CLIENT_LOGIN=<YANDEX_DIRECT_CLIENT_LOGIN> --env YANDEX_DIRECT_SANDBOX=<YANDEX_DIRECT_SANDBOX> -- npx -y @stufently/yandex-direct-mcpВместо <…> подставьте свои значения
Файл настроек
{
"mcpServers": {
"yandex-direct-mcp": {
"command": "npx",
"args": [
"-y",
"@stufently/yandex-direct-mcp"
],
"env": {
"YANDEX_DIRECT_TOKEN": "<YANDEX_DIRECT_TOKEN>",
"YANDEX_DIRECT_CLIENT_LOGIN": "<YANDEX_DIRECT_CLIENT_LOGIN>",
"YANDEX_DIRECT_SANDBOX": "<YANDEX_DIRECT_SANDBOX>"
}
}
}
}Вместо <…> подставьте свои значения
Файл настроек
{
"servers": {
"yandex-direct-mcp": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@stufently/yandex-direct-mcp"
],
"env": {
"YANDEX_DIRECT_TOKEN": "<YANDEX_DIRECT_TOKEN>",
"YANDEX_DIRECT_CLIENT_LOGIN": "<YANDEX_DIRECT_CLIENT_LOGIN>",
"YANDEX_DIRECT_SANDBOX": "<YANDEX_DIRECT_SANDBOX>"
}
}
}
}Вместо <…> подставьте свои значения
Командой платформы
gemini mcp add -e YANDEX_DIRECT_TOKEN=<YANDEX_DIRECT_TOKEN> -e YANDEX_DIRECT_CLIENT_LOGIN=<YANDEX_DIRECT_CLIENT_LOGIN> -e YANDEX_DIRECT_SANDBOX=<YANDEX_DIRECT_SANDBOX> yandex-direct-mcp npx -y @stufently/yandex-direct-mcpВместо <…> подставьте свои значения
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о Yandex Direct MCP
Как установить Yandex Direct MCP в Claude Code?
Выполните команду claude mcp add yandex-direct-mcp -e YANDEX_DIRECT_TOKEN=<YANDEX_DIRECT_TOKEN> -- npx -y @stufently/yandex-direct-mcp. При необходимости добавьте логин клиента и тестовый режим через дополнительные флаги окружения.
Что делает Yandex Direct MCP?
Он связывает ассистента с Яндекс Директом через API v5. Сервер позволяет запускать кампании, менять тексты объявлений, регулировать ставки и выгружать отчёты.
Как работает защита от ошибочного списания денег?
Четырнадцать разрушительных методов, включая удаление и смену ставок, отклоняют вызов без флага confirm: true. Запрос без этого параметра отменяется до отправки в API, поэтому баланс и баллы аккаунта не тратятся.
