SkillFoxx

Начните вводить название, задачу или сервис

MCP для Яндекс Директа: 59 инструментов

yandex-direct-mcp-plus

MCP-сервер API v5 Яндекс Директа с 59 инструментами, dry-run на каждой записи и честной таблицей того, что тратит бюджет и что необратимо

MCP-сервер

Высокий риск

Высокий уровень ставим, когда инструмент пишет во внешние системы, работает с деньгами, рабочими базами или секретами либо выполняет произвольные команды. CLI поставит его только после вашего согласия.

Почему такой уровень

  • Инструменты resume, moderate_ads и update_campaign запускают реальные показы и тратят бюджет
  • 12 инструментов помечены DESTRUCTIVE и удаляют объекты без возможности восстановления
Все причины и проверки
Российский стек

pavelsiba/yandex-direct-mcp-plusАвтор:Pavelsiba

Установка

В терминале, через SkillFoxx CLI

npx skillfoxx add mcp/yandex-direct-mcp-plus

Определит агенты на машине, проверит риск и зафиксирует версию.

Другие способы установки

У записи высокий риск, поэтому установки в один клик нет. Посмотрите код и добавьте конфиг вручную.

Выполните в терминале

claude mcp add --transport stdio --env 'YANDEX_DIRECT_TOKEN=<ваш YANDEX_DIRECT_TOKEN>' yandex-direct-mcp-plus -- npx -y yandex-direct-mcp-plus@1.7.0

Или добавьте в файл .mcp.json, в проекте

{
  "mcpServers": {
    "yandex-direct-mcp-plus": {
      "command": "npx",
      "args": [
        "-y",
        "yandex-direct-mcp-plus@1.7.0"
      ],
      "env": {
        "YANDEX_DIRECT_TOKEN": "<ваш YANDEX_DIRECT_TOKEN>"
      }
    }
  }
}

Если файл уже есть, добавьте сервер внутрь ключа mcpServers.

Ключи и настройки

YANDEX_DIRECT_TOKENсекрет, обязательная
OAuth-токен Яндекс.Директа
YANDEX_DIRECT_LOGINнеобязательная
Логин клиента (Client-Login), нужен для агентского токена

Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.

Добавьте в файл ~/.cursor/mcp.json, для всех проектов

{
  "mcpServers": {
    "yandex-direct-mcp-plus": {
      "command": "npx",
      "args": [
        "-y",
        "yandex-direct-mcp-plus@1.7.0"
      ],
      "env": {
        "YANDEX_DIRECT_TOKEN": "<ваш YANDEX_DIRECT_TOKEN>"
      }
    }
  }
}

Если файл уже есть, добавьте сервер внутрь ключа mcpServers. Для одного проекта тот же блок кладут в .cursor/mcp.json.

Ключи и настройки

YANDEX_DIRECT_TOKENсекрет, обязательная
OAuth-токен Яндекс.Директа
YANDEX_DIRECT_LOGINнеобязательная
Логин клиента (Client-Login), нужен для агентского токена

Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.

Выполните в терминале

code --add-mcp '{"name":"yandex-direct-mcp-plus","type":"stdio","command":"npx","args":["-y","yandex-direct-mcp-plus@1.7.0"],"env":{"YANDEX_DIRECT_TOKEN":"<ваш YANDEX_DIRECT_TOKEN>"}}'

Или добавьте в файл .vscode/mcp.json, в проекте

{
  "servers": {
    "yandex-direct-mcp-plus": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "yandex-direct-mcp-plus@1.7.0"
      ],
      "env": {
        "YANDEX_DIRECT_TOKEN": "<ваш YANDEX_DIRECT_TOKEN>"
      }
    }
  }
}

Если файл уже есть, добавьте сервер внутрь ключа servers.

Ключи и настройки

YANDEX_DIRECT_TOKENсекрет, обязательная
OAuth-токен Яндекс.Директа
YANDEX_DIRECT_LOGINнеобязательная
Логин клиента (Client-Login), нужен для агентского токена

Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.

Выполните в терминале

codex mcp add yandex-direct-mcp-plus --env 'YANDEX_DIRECT_TOKEN=<ваш YANDEX_DIRECT_TOKEN>' -- npx -y yandex-direct-mcp-plus@1.7.0

Или добавьте в файл ~/.codex/config.toml, для всех проектов

[mcp_servers.yandex-direct-mcp-plus]
command = "npx"
args = ["-y", "yandex-direct-mcp-plus@1.7.0"]
env = { YANDEX_DIRECT_TOKEN = "<ваш YANDEX_DIRECT_TOKEN>" }

Если файл уже есть, допишите блок в конец.

Ключи и настройки

YANDEX_DIRECT_TOKENсекрет, обязательная
OAuth-токен Яндекс.Директа
YANDEX_DIRECT_LOGINнеобязательная
Логин клиента (Client-Login), нужен для агентского токена

Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.

Добавьте в файл ~/.gemini/settings.json, для всех проектов

{
  "mcpServers": {
    "yandex-direct-mcp-plus": {
      "command": "npx",
      "args": [
        "-y",
        "yandex-direct-mcp-plus@1.7.0"
      ],
      "env": {
        "YANDEX_DIRECT_TOKEN": "<ваш YANDEX_DIRECT_TOKEN>"
      }
    }
  }
}

Если файл уже есть, добавьте сервер внутрь ключа mcpServers.

Ключи и настройки

YANDEX_DIRECT_TOKENсекрет, обязательная
OAuth-токен Яндекс.Директа
YANDEX_DIRECT_LOGINнеобязательная
Логин клиента (Client-Login), нужен для агентского токена

Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.

Добавьте в файл ~/.config/devin/mcp_config.json, для всех проектов

{
  "mcpServers": {
    "yandex-direct-mcp-plus": {
      "command": "npx",
      "args": [
        "-y",
        "yandex-direct-mcp-plus@1.7.0"
      ],
      "env": {
        "YANDEX_DIRECT_TOKEN": "<ваш YANDEX_DIRECT_TOKEN>"
      }
    }
  }
}

Если файл уже есть, добавьте сервер внутрь ключа mcpServers. В легаси Cascade конфиг MCP лежит в ~/.codeium/windsurf/mcp_config.json.

Ключи и настройки

YANDEX_DIRECT_TOKENсекрет, обязательная
OAuth-токен Яндекс.Директа
YANDEX_DIRECT_LOGINнеобязательная
Логин клиента (Client-Login), нужен для агентского токена

Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.

Бывший Windsurf.

Добавьте в файл cline_mcp_settings.json, для всех проектов

{
  "mcpServers": {
    "yandex-direct-mcp-plus": {
      "command": "npx",
      "args": [
        "-y",
        "yandex-direct-mcp-plus@1.7.0"
      ],
      "env": {
        "YANDEX_DIRECT_TOKEN": "<ваш YANDEX_DIRECT_TOKEN>"
      }
    }
  }
}

Если файл уже есть, добавьте сервер внутрь ключа mcpServers. Файл настроек открывается в Cline: вкладка MCP Servers, кнопка Configure MCP Servers.

Ключи и настройки

YANDEX_DIRECT_TOKENсекрет, обязательная
OAuth-токен Яндекс.Директа
YANDEX_DIRECT_LOGINнеобязательная
Логин клиента (Client-Login), нужен для агентского токена

Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.

Добавьте в файл .roo/mcp.json, в проекте

{
  "mcpServers": {
    "yandex-direct-mcp-plus": {
      "command": "npx",
      "args": [
        "-y",
        "yandex-direct-mcp-plus@1.7.0"
      ],
      "env": {
        "YANDEX_DIRECT_TOKEN": "<ваш YANDEX_DIRECT_TOKEN>"
      }
    }
  }
}

Если файл уже есть, добавьте сервер внутрь ключа mcpServers.

Ключи и настройки

YANDEX_DIRECT_TOKENсекрет, обязательная
OAuth-токен Яндекс.Директа
YANDEX_DIRECT_LOGINнеобязательная
Логин клиента (Client-Login), нужен для агентского токена

Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.

Форк Roo Code, папки .roo те же.

Добавьте в файл opencode.json, в проекте

{
  "mcp": {
    "yandex-direct-mcp-plus": {
      "type": "local",
      "command": [
        "npx",
        "-y",
        "yandex-direct-mcp-plus@1.7.0"
      ],
      "environment": {
        "YANDEX_DIRECT_TOKEN": "<ваш YANDEX_DIRECT_TOKEN>"
      }
    }
  }
}

Если файл уже есть, добавьте сервер внутрь ключа mcp.

Ключи и настройки

YANDEX_DIRECT_TOKENсекрет, обязательная
OAuth-токен Яндекс.Директа
YANDEX_DIRECT_LOGINнеобязательная
Логин клиента (Client-Login), нужен для агентского токена

Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.

Добавьте в файл ~/.config/zed/settings.json, для всех проектов

{
  "context_servers": {
    "yandex-direct-mcp-plus": {
      "command": "npx",
      "args": [
        "-y",
        "yandex-direct-mcp-plus@1.7.0"
      ],
      "env": {
        "YANDEX_DIRECT_TOKEN": "<ваш YANDEX_DIRECT_TOKEN>"
      }
    }
  }
}

Если файл уже есть, добавьте сервер внутрь ключа context_servers.

Ключи и настройки

YANDEX_DIRECT_TOKENсекрет, обязательная
OAuth-токен Яндекс.Директа
YANDEX_DIRECT_LOGINнеобязательная
Логин клиента (Client-Login), нужен для агентского токена

Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.

Добавьте в файл .codeassistant/mcp.json, в проекте

{
  "mcpServers": {
    "yandex-direct-mcp-plus": {
      "command": "npx",
      "args": [
        "-y",
        "yandex-direct-mcp-plus@1.7.0"
      ],
      "env": {
        "YANDEX_DIRECT_TOKEN": "<ваш YANDEX_DIRECT_TOKEN>"
      }
    }
  }
}

Если файл уже есть, добавьте сервер внутрь ключа mcpServers.

Ключи и настройки

YANDEX_DIRECT_TOKENсекрет, обязательная
OAuth-токен Яндекс.Директа
YANDEX_DIRECT_LOGINнеобязательная
Логин клиента (Client-Login), нужен для агентского токена

Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.

Понадобится: Node.js

Сверено с репозиторием 25 сент. 2026, коммит 194f9eb.

Текст для агента

Получи OAuth-токен Яндекс Директа и подключи сервер: claude mcp add yandex-direct -e YANDEX_DIRECT_TOKEN=ваш_токен -- npx -y yandex-direct-mcp-plus. Перед первым изменением попроси агента вызвать инструмент с dry_run: true.

Другие способы из описания автора
claude mcp add yandex-direct -e YANDEX_DIRECT_TOKEN=ваш_токен -- npx -y yandex-direct-mcp-plus

Node.js 22+, OAuth-токен с правом direct:api.

Это чужой код. Посмотрите файлы в репозитории перед установкой.

Что делает

Сервер дает 59 инструментов почти по всем сервисам Direct API v5: кампании и стратегии, группы объявлений, объявления и модерация, ключевые фразы и ставки, минус-фразы и общие наборы, быстрые ссылки, уточнения, изображения, визитки, корректировки ставок, ретаргетинг, аудиторные и динамические цели, фиды, расписание показов, статистика, поисковые запросы, баланс и справочники. Суммы принимаются и возвращаются в рублях, а не в микроединицах API, а 64-битные идентификаторы Директа передаются строками, чтобы JavaScript их не обрезал. У каждого пишущего инструмента есть параметр dry_run: с ним вызов проверяет схему и делает нужные чтения, но не отправляет запрос в Директ. README отдельно и честно делит инструменты на три группы: только читающие, тратящие бюджет или запускающие показы, и необратимо удаляющие с аннотацией DESTRUCTIVE.

Для кого. Для тех, кто ведет рекламу в Яндекс Директе и хочет полный набор инструментов API v5 с явной проверкой каждого действия перед реальной отправкой.

Подходит, если

  • Нужен почти полный охват API v5 одним сервером без сборки нескольких оберток
  • Нужно проверить, что именно уйдет в Директ, прежде чем реально это отправить
  • Нужна точная работа с 64-битными ID и суммами в рублях без ручной конвертации из микроединиц

Не подходит, если

  • Нужны смарт-баннеры, динамические объявления или визитки: их API Директа больше не создает с 22 мая 2026
  • Нужна тестовая среда: песочница Яндекс Директа отключена с июля 2026, отладка идет на черновой кампании
  • Нужна единая перфоманс-кампания с полным управлением: сервер пока только читает ЕПК

Пример запроса к агенту

Подними ставку до 25 рублей там, где CTR выше 8%, а показов меньше сотни, сначала покажи, что изменится

Ограничения

Тестовой среды у Яндекс Директа больше нет, любой вызов идет по боевому аккаунту, поэтому отладка возможна только на отдельной кампании-черновике. Смарт-баннеры, динамические объявления и визитки API больше не создает, хотя сервер их читает и, для визиток, удаляет. Единую перфоманс-кампанию сервер только читает. Нужен OAuth-токен, заявка на доступ к API Директа рассматривается от часа до нескольких суток.

Как отключить. Выполните claude mcp remove yandex-direct в Claude Code или удалите блок yandex-direct из конфигурации MCP клиента.

MCP

Транспорт
stdio
Авторизация
API-ключ
Переменные окружения
YANDEX_DIRECT_TOKEN
обязательная, секрет		OAuth-токен Яндекс Директа
YANDEX_DIRECT_LOGIN
Логин клиента для агентских токенов, заголовок Client-Login

Проверка безопасности

  • Инструменты resume, moderate_ads и update_campaign запускают реальные показы и тратят бюджет
  • 12 инструментов помечены DESTRUCTIVE и удаляют объекты без возможности восстановления

Коротко о README

README дает готовые команды для Claude Code, Claude Desktop и Cursor через npx, таблицу переменных окружения, раздел «Что меняет данные» с явным списком инструментов, которые тратят бюджет, запускают показы или удаляют необратимо, и полную таблицу из 59 инструментов по разделам. Отдельно указано происхождение: проект начат на коде theYahia/yandex-direct-mcp под MIT, расширен другим автором с 20 до 48 инструментов и дальше развивается независимо.

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

Можно ли проверить действие, не тратя бюджет?

Да, у каждого пишущего инструмента есть параметр dry_run: true, который проверяет параметры и делает нужные чтения, но ничего не отправляет в Директ.

Отправляет ли сервер куда-то телеметрию?

Нет, README прямо говорит, что сервер не отправляет никуда ничего, кроме запросов к API Яндекса.

Выбор редакции

Скилл, который убирает из текста приметы ИИ-письма по списку Википедии и не добавляет выдуманных фактов

СкиллНизкий рискБез VPN52,7 тыс.
Выбор редакции

Около пятидесяти скиллов по CRO, копирайтингу, SEO, аналитике, рекламе и запуску продукта для кодовых агентов

СкиллНизкий риск51,8 тыс.
Официальный

Официальный удаленный MCP-сервер SendPulse: статистика, рассылки и данные пользователей через чат с агентом

MCP-серверВысокий рискРоссийский стек1
Выбор редакции

MCP-сервер и CLI на всех 113 методах API v5 Яндекс Директа, собранных из WSDL: по умолчанию только 9 читающих, запись включается явно

MCP-серверВысокий рискРоссийский стекБез VPN1
Foxx AIMCP для Яндекс Директа: 59 инструментов

Я Foxx AI и уже разобрал этот инструмент. Спросите про установку, настройку или что угодно еще, отвечу простыми словами.