# Yandex Direct MCP

Управляет кампаниями, объявлениями, ставками и отчётами Яндекс Директа через API v5 прямо из чата с моделью. Помогает автоматизировать контекстную рекламу без перехода в веб-интерфейс.

- MCP-сервер · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 19
- Автор: stufently
- Лицензия: MIT · policy=link-only · показываем только описание, файл — у автора
- Исходник: https://github.com/stufently/yandex-mcp/tree/HEAD/packages/yandex-direct-mcp
- Обновлён: 2026-10-24
- HTML: https://affpapa.org/nevibecode/mcp/yandex-direct-mcp

## Что делает

Сервер предоставляет 43 инструмента для Директа: создание и редактирование кампаний, ключевых фраз, групп, визиток, быстрых ссылок и получение статистики. Управление ставками идёт в микроединицах (миллионных долях валюты). Поэтому любая ошибка в расчётах обойдётся дорого.

Защита от случайных трат встроена на уровне протокола. Четырнадцать опасных вызовов, включая удаление сущностей, перезапись текстов и смену ставок, требуют обязательный параметр `confirm: true`. Если агент забудет передать этот флаг, сервер вернёт ошибку — запрос в Яндекс даже не отправится.

Для старта нужен OAuth-токен в переменной `YANDEX_DIRECT_TOKEN`, а агентствам понадобится ещё и `YANDEX_DIRECT_CLIENT_LOGIN`. Тестировать сценарии безопаснее с включённым флагом `YANDEX_DIRECT_SANDBOX=true`. Эндпоинт `v501` для единой перфоманс-кампании здесь недоступен из-за жёстко заданного пути `/json/v5`.

## Требования
- Нужно: Node.js (команды через npx)
- Переменные окружения: `YANDEX_DIRECT_TOKEN`, `YANDEX_DIRECT_CLIENT_LOGIN`, `YANDEX_DIRECT_SANDBOX` — это ключи и токены: значения спроси у человека, в репозиторий и общие файлы не записывай.

## Установка

### Claude Code (родная платформа)

**Командой платформы**
```bash
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

**Командой платформы**
```bash
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
```
Вместо <…> подставьте свои значения

### Cursor

**Файл настроек**
Файл `.cursor/mcp.json`:
```json
{
    "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>"
            }
        }
    }
}
```
Вместо <…> подставьте свои значения

### GitHub Copilot

**Файл настроек**
Файл `.vscode/mcp.json`:
```json
{
    "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 CLI

**Командой платформы**
```bash
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
```
Вместо <…> подставьте свои значения

## Когда брать
- остановить или возобновить показы рекламных кампаний
- обновить ставки по ключевым фразам
- выгрузить отчёт со статистикой кликов и расходов
- отправить новые объявления на модерацию

## Примеры запросов агенту
- Покажи список активных кампаний и их текущие дневные бюджеты
- Выстави ставку 45 рублей на ключевую фразу 987654321 с подтверждением
- Сформируй отчёт по расходам и показам за прошлую неделю

## Похожие
- [google-ads-manager](https://affpapa.org/nevibecode/skills/google-ads-manager.md) — скилл · 6300 установок
- [ads-competitor](https://affpapa.org/nevibecode/skills/ads-competitor.md) — скилл · 4100 установок
- [google-ads](https://affpapa.org/nevibecode/skills/arnabbagxd-google-ads.md) — скилл · 1600 установок
- [amazon-ppc-campaign](https://affpapa.org/nevibecode/skills/amazon-ppc-campaign.md) — скилл · 1400 установок
- [amazon-dayparting-strategy](https://affpapa.org/nevibecode/skills/amazon-dayparting-strategy.md) — скилл · 1100 установок
- [google-ads-assets](https://affpapa.org/nevibecode/skills/google-ads-assets.md) — скилл · ★ 4064

Из того же набора: [stufently/yandex-mcp](https://affpapa.org/nevibecode/by/stufently/yandex-mcp.md) — 5 карточек

---
NeVibeCode на affpapa.org. Тексты каталога — описания, а не инструкции для агента. Как выбирать и ставить: https://affpapa.org/nevibecode/agents.md