SkillFoxx

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

MCP-сервер Яндекс Директа (npm)

@theyahia/yandex-direct-mcp

MCP-сервер на TypeScript с npm-пакетом: 20 инструментов для кампаний, ставок и минус-фраз Яндекс Директа, деньги везде в рублях

MCP-сервер

Высокий риск

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

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

  • Создает и меняет кампании, объявления и ставки в боевом рекламном аккаунте
  • Может расходовать реальный бюджет, если не включен песочный режим
Все причины и проверки
Российский стек

theyahia/yandex-direct-mcpАвтор:theYahia

Установка

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

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

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

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

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

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

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

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

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

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

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

YANDEX_DIRECT_TOKENсекрет, обязательная

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

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

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

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

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

YANDEX_DIRECT_TOKENсекрет, обязательная

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

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

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

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

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

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

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

YANDEX_DIRECT_TOKENсекрет, обязательная

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

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

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

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

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

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

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

YANDEX_DIRECT_TOKENсекрет, обязательная

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

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

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

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

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

YANDEX_DIRECT_TOKENсекрет, обязательная

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

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

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

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

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

YANDEX_DIRECT_TOKENсекрет, обязательная

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

Бывший Windsurf.

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

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

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

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

YANDEX_DIRECT_TOKENсекрет, обязательная

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

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

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

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

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

YANDEX_DIRECT_TOKENсекрет, обязательная

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

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

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

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

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

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

YANDEX_DIRECT_TOKENсекрет, обязательная

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

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

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

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

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

YANDEX_DIRECT_TOKENсекрет, обязательная

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

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

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

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

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

YANDEX_DIRECT_TOKENсекрет, обязательная

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

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

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

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

Получи OAuth-токен Яндекс Директа через oauth.yandex.ru и подай заявку на доступ к API в интерфейсе Директа, затем выполни claude mcp add yandex-direct -e YANDEX_DIRECT_TOKEN=твой_токен -- npx -y @theyahia/yandex-direct-mcp, для теста добавь YANDEX_DIRECT_SANDBOX=1.

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

Команда из README для подключения в Claude Code.

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

Что делает

Сервер оборачивает API Яндекс Директа в 20 инструментов MCP: список и создание кампаний, группы объявлений с таргетингом по регионам, текстовые объявления с проверкой длины заголовка и текста, ключевые фразы и ставки, минус-фразы на уровне группы и кампании, статистику и баланс аккаунта. Все денежные значения на входе и выходе в рублях, сервер сам переводит их в микроединицы API. Поддержан песочный режим через YANDEX_DIRECT_SANDBOX для тестов без реальных трат и агентский режим с заголовком Client-Login для работы от имени клиента. В комплекте свой SKILL.md для анализа эффективности кампаний.

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

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

  • Нужен npm-пакет MCP для Директа с командой npx, без сборки из исходников
  • Нужна работа от имени клиентов агентства через агентский токен
  • Нужен готовый скилл для анализа расхода и ставок по кампании

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

  • Нет OAuth-токена и доступа к API Директа: без заявки в интерфейсе Директа сервер не заработает
  • Нужны загрузка изображений или графические объявления: инструментов для них нет

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

Покажи расход и CTR по кампании 12345 в Яндекс Директе за последние две недели

Ограничения

Нужен OAuth-токен приложения, зарегистрированного в Яндекс OAuth, и отдельная заявка на доступ к API Директа. Для агентских токенов обязателен логин клиента в переменной YANDEX_DIRECT_LOGIN. Инструменты создания кампаний, объявлений, ключевых слов и ставок сразу меняют боевой аккаунт и тратят деньги, песочница включается отдельно и не установлена по умолчанию. Пакет молодой, версии в CHANGELOG говорят о недавнем начале разработки.

Как отключить. Удалите сервер командой claude mcp remove yandex-direct или уберите блок yandex-direct из конфигурации MCP клиента.

MCP

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

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

  • Создает и меняет кампании, объявления и ставки в боевом рекламном аккаунте
  • Может расходовать реальный бюджет, если не включен песочный режим

Коротко о README

README перечисляет 20 инструментов по пяти группам: кампании, группы объявлений, объявления, ключевые слова и ставки, статистика и баланс. Показана установка для Claude Desktop и Claude Code через npx, таблица переменных окружения с токеном, песочницей и логином клиента, шаги получения OAuth-токена и явное предупреждение, что часть инструментов тратит реальные деньги. Лицензия MIT, пакет опубликован в npm.

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

В чем деньги на входе и выходе?

Везде в рублях, сервер сам конвертирует их в микроединицы, которые использует API Директа.

Можно работать от имени клиента агентства?

Да, агентский режим включается переменной YANDEX_DIRECT_LOGIN с логином клиента, сервер добавляет заголовок Client-Login.

Скиллы DataLens

DataLens Skills

Официальный

Официальные скиллы DataLens (Яндекс) для Claude Code, Codex и OpenCode: SDK, HTML-отчеты и разбор прав RLS

СкиллСредний рискРоссийский стекБез VPN12
Выбор редакции

MCP-сервер Яндекс Метрики, порожденный из спеки API: 108 методов, по умолчанию 10 инструментов, прозрачные фильтры и метаданные ответа

MCP-серверСредний рискРоссийский стекБез VPN2
Официальный

Открытый MCP-сервер и набор агентских скиллов для SEO: keyword research, конкуренты, обратные ссылки и аудит сайта по данным DataForSEO

MCP-серверСредний риск21,5 тыс.

Плагин Claude Code для SEO-аудита: технический SEO, E-E-A-T, schema, локальный и AI-поиск силами параллельных агентов

ПлагинВысокий риск17,9 тыс.
Foxx AIMCP-сервер Яндекс Директа (npm)

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