MCP Яндекс Директа на Bun с ЕПК и прокси Click.ru

Yandex Direct MCP

MCP-сервер Direct API v5 на Bun с 50 инструментами, поддержкой ЕПК и подключением либо своим токеном, либо через прокси Click.ru без OAuth

MCP-сервер

Высокий риск

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

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

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

alexf81xxx/yandex-direct-mcp

Установка

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

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

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

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

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

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

claude mcp add --transport stdio yandex-direct-mcp -- npx -y @ai-hub-open/yandex-direct-mcp@0.5.0

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

{
  "mcpServers": {
    "yandex-direct-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@ai-hub-open/yandex-direct-mcp@0.5.0"
      ]
    }
  }
}

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

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

CLICK_RU_PROXYнеобязательная
true — Click.ru proxy mode (primary)
CLICK_RU_TOKENсекрет, необязательная
Click.ru API token
CLICK_RU_CLIENT_LOGINнеобязательная
Yandex Direct account login connected in Click.ru
YANDEX_DIRECT_TOKENсекрет, необязательная
Yandex Direct OAuth token (direct mode)
YANDEX_DIRECT_SANDBOXнеобязательная
true — Yandex sandbox (direct mode only)

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

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

{
  "mcpServers": {
    "yandex-direct-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@ai-hub-open/yandex-direct-mcp@0.5.0"
      ]
    }
  }
}

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

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

CLICK_RU_PROXYнеобязательная
true — Click.ru proxy mode (primary)
CLICK_RU_TOKENсекрет, необязательная
Click.ru API token
CLICK_RU_CLIENT_LOGINнеобязательная
Yandex Direct account login connected in Click.ru
YANDEX_DIRECT_TOKENсекрет, необязательная
Yandex Direct OAuth token (direct mode)
YANDEX_DIRECT_SANDBOXнеобязательная
true — Yandex sandbox (direct mode only)

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

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

code --add-mcp '{"name":"yandex-direct-mcp","type":"stdio","command":"npx","args":["-y","@ai-hub-open/yandex-direct-mcp@0.5.0"]}'

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

{
  "servers": {
    "yandex-direct-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@ai-hub-open/yandex-direct-mcp@0.5.0"
      ]
    }
  }
}

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

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

CLICK_RU_PROXYнеобязательная
true — Click.ru proxy mode (primary)
CLICK_RU_TOKENсекрет, необязательная
Click.ru API token
CLICK_RU_CLIENT_LOGINнеобязательная
Yandex Direct account login connected in Click.ru
YANDEX_DIRECT_TOKENсекрет, необязательная
Yandex Direct OAuth token (direct mode)
YANDEX_DIRECT_SANDBOXнеобязательная
true — Yandex sandbox (direct mode only)

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

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

codex mcp add yandex-direct-mcp -- npx -y @ai-hub-open/yandex-direct-mcp@0.5.0

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

[mcp_servers.yandex-direct-mcp]
command = "npx"
args = ["-y", "@ai-hub-open/yandex-direct-mcp@0.5.0"]

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

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

CLICK_RU_PROXYнеобязательная
true — Click.ru proxy mode (primary)
CLICK_RU_TOKENсекрет, необязательная
Click.ru API token
CLICK_RU_CLIENT_LOGINнеобязательная
Yandex Direct account login connected in Click.ru
YANDEX_DIRECT_TOKENсекрет, необязательная
Yandex Direct OAuth token (direct mode)
YANDEX_DIRECT_SANDBOXнеобязательная
true — Yandex sandbox (direct mode only)

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

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

{
  "mcpServers": {
    "yandex-direct-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@ai-hub-open/yandex-direct-mcp@0.5.0"
      ]
    }
  }
}

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

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

CLICK_RU_PROXYнеобязательная
true — Click.ru proxy mode (primary)
CLICK_RU_TOKENсекрет, необязательная
Click.ru API token
CLICK_RU_CLIENT_LOGINнеобязательная
Yandex Direct account login connected in Click.ru
YANDEX_DIRECT_TOKENсекрет, необязательная
Yandex Direct OAuth token (direct mode)
YANDEX_DIRECT_SANDBOXнеобязательная
true — Yandex sandbox (direct mode only)

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

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

{
  "mcpServers": {
    "yandex-direct-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@ai-hub-open/yandex-direct-mcp@0.5.0"
      ]
    }
  }
}

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

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

CLICK_RU_PROXYнеобязательная
true — Click.ru proxy mode (primary)
CLICK_RU_TOKENсекрет, необязательная
Click.ru API token
CLICK_RU_CLIENT_LOGINнеобязательная
Yandex Direct account login connected in Click.ru
YANDEX_DIRECT_TOKENсекрет, необязательная
Yandex Direct OAuth token (direct mode)
YANDEX_DIRECT_SANDBOXнеобязательная
true — Yandex sandbox (direct mode only)

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

Бывший Windsurf.

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

{
  "mcpServers": {
    "yandex-direct-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@ai-hub-open/yandex-direct-mcp@0.5.0"
      ]
    }
  }
}

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

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

CLICK_RU_PROXYнеобязательная
true — Click.ru proxy mode (primary)
CLICK_RU_TOKENсекрет, необязательная
Click.ru API token
CLICK_RU_CLIENT_LOGINнеобязательная
Yandex Direct account login connected in Click.ru
YANDEX_DIRECT_TOKENсекрет, необязательная
Yandex Direct OAuth token (direct mode)
YANDEX_DIRECT_SANDBOXнеобязательная
true — Yandex sandbox (direct mode only)

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

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

{
  "mcpServers": {
    "yandex-direct-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@ai-hub-open/yandex-direct-mcp@0.5.0"
      ]
    }
  }
}

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

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

CLICK_RU_PROXYнеобязательная
true — Click.ru proxy mode (primary)
CLICK_RU_TOKENсекрет, необязательная
Click.ru API token
CLICK_RU_CLIENT_LOGINнеобязательная
Yandex Direct account login connected in Click.ru
YANDEX_DIRECT_TOKENсекрет, необязательная
Yandex Direct OAuth token (direct mode)
YANDEX_DIRECT_SANDBOXнеобязательная
true — Yandex sandbox (direct mode only)

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

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

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

{
  "mcp": {
    "yandex-direct-mcp": {
      "type": "local",
      "command": [
        "npx",
        "-y",
        "@ai-hub-open/yandex-direct-mcp@0.5.0"
      ]
    }
  }
}

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

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

CLICK_RU_PROXYнеобязательная
true — Click.ru proxy mode (primary)
CLICK_RU_TOKENсекрет, необязательная
Click.ru API token
CLICK_RU_CLIENT_LOGINнеобязательная
Yandex Direct account login connected in Click.ru
YANDEX_DIRECT_TOKENсекрет, необязательная
Yandex Direct OAuth token (direct mode)
YANDEX_DIRECT_SANDBOXнеобязательная
true — Yandex sandbox (direct mode only)

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

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

{
  "context_servers": {
    "yandex-direct-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@ai-hub-open/yandex-direct-mcp@0.5.0"
      ]
    }
  }
}

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

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

CLICK_RU_PROXYнеобязательная
true — Click.ru proxy mode (primary)
CLICK_RU_TOKENсекрет, необязательная
Click.ru API token
CLICK_RU_CLIENT_LOGINнеобязательная
Yandex Direct account login connected in Click.ru
YANDEX_DIRECT_TOKENсекрет, необязательная
Yandex Direct OAuth token (direct mode)
YANDEX_DIRECT_SANDBOXнеобязательная
true — Yandex sandbox (direct mode only)

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

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

{
  "mcpServers": {
    "yandex-direct-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@ai-hub-open/yandex-direct-mcp@0.5.0"
      ]
    }
  }
}

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

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

CLICK_RU_PROXYнеобязательная
true — Click.ru proxy mode (primary)
CLICK_RU_TOKENсекрет, необязательная
Click.ru API token
CLICK_RU_CLIENT_LOGINнеобязательная
Yandex Direct account login connected in Click.ru
YANDEX_DIRECT_TOKENсекрет, необязательная
Yandex Direct OAuth token (direct mode)
YANDEX_DIRECT_SANDBOXнеобязательная
true — Yandex sandbox (direct mode only)

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

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

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

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

Установи зависимости через bun install, задай в .env либо YANDEX_DIRECT_TOKEN для прямого режима, либо CLICK_RU_PROXY=true с CLICK_RU_TOKEN и CLICK_RU_CLIENT_LOGIN для режима через Click.ru, затем подключи src/index.ts как локальный stdio MCP-сервер.

Другие способы из описания автора
{
  "mcpServers": {
    "yandex-direct": {
      "command": "bun",
      "args": ["run", "/абсолютный/путь/к/yandex-direct-mcp/src/index.ts"],
      "env": { "YANDEX_DIRECT_TOKEN": "y0__..." }
    }
  }
}

Прямой режим с собственным OAuth-токеном Директа.

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

Что делает

Сервер на Bun и TypeScript дает 50 инструментов Direct API v5: кампании включая единые перфоманс-кампании со стратегиями торгов и целями Метрики, группы объявлений, текстовые и комбинаторные объявления, расширения вроде быстрых ссылок и уточнений, изображения, ставки и прогноз цены клика, корректировки ставок, ключевые фразы, отчеты и справочники. Есть два режима подключения: прямой с собственным OAuth-токеном Яндекс Директа, и через прокси Click.ru, где вместо токена Яндекса используется API-токен из профиля click.ru и логин уже подключенного там аккаунта. По умолчанию используется версия API v501, обязательная для ЕПК. Есть HTTP-режим с обязательным MCP_AUTH_TOKEN и авторизация через доверенного издателя GitHub OIDC при публикации без долгоживущих токенов в секретах.

Для кого. Для тех, кто ведет единые перфоманс-кампании в Директе или уже работает через Click.ru и хочет управлять рекламой без получения отдельного OAuth-токена Яндекса.

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

  • Нужна работа с единой перфоманс-кампанией, а не только текстово-графической
  • Уже есть аккаунт в Click.ru и не хочется отдельно регистрировать OAuth-приложение Яндекса
  • Нужен HTTP-режим с собственным токеном авторизации для удаленного доступа

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

  • Нет ни своего OAuth-токена, ни аккаунта в Click.ru: без одного из двух режим подключения не настроить
  • Нужна тестовая песочница вместе с прокси Click.ru: он работает только с продакшн-API
  • Нужны гарантии от известных ограничений песочницы: часть операций там непроверяема

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

Создай единую перфоманс-кампанию с целью из Метрики и покажи прогноз цены клика по ключевым фразам

Ограничения

Прокси Click.ru работает только с продакшн-API, песочница ему недоступна. У самой песочницы Яндекса есть подтвержденные ограничения: заливка объявлений в группу непроверяема, corrections bidmodifiers.get всегда пуст, сервис sitelinks иногда недоступен, это описано и явно помечено в e2e-тестах как пропуск, а не ошибка. HTTP-режим требует обязательный MCP_AUTH_TOKEN.

Как отключить. Удалите блок yandex-direct из .mcp.json вашего проекта или остановите процесс сервера.

MCP

Транспорт
stdio, http
Авторизация
API-ключ
Переменные окружения
Переменные окружения
YANDEX_DIRECT_TOKEN
секрет
OAuth-токен Яндекс Директа для прямого режима
CLICK_RU_PROXY
true включает режим прокси через Click.ru вместо прямого токена
CLICK_RU_TOKEN
секрет
API-токен из профиля click.ru
MCP_AUTH_TOKEN
секрет
Обязателен в HTTP-режиме для авторизации клиентов

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

  • Создает и изменяет кампании, включая единые перфоманс-кампании, с реальным бюджетом
  • Прогнозирует и меняет ставки, что напрямую влияет на расход

Коротко о README

README дает два независимых блока настройки: прямой режим с YANDEX_DIRECT_TOKEN и режим через Click.ru с отдельными переменными, команды запуска в stdio и HTTP режимах, раздел про мок-тесты без сети и HTTP-транспорт, и честный список известных ограничений песочницы Яндекса, воспроизведенных в e2e-тестах. Отдельно описан процесс релиза: версии сверяются в трех местах, публикация в npm и реестр MCP идет через доверенного издателя GitHub OIDC.

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

Нужен ли токен Яндекса, если я работаю через Click.ru?

Нет, в режиме CLICK_RU_PROXY=true вместо токена Яндекса используется API-токен из профиля click.ru и логин аккаунта Директа, уже подключенного там.

Работает ли песочница с прокси Click.ru?

Нет, прокси работает только с продакшн-API Яндекса, песочница ему недоступна.

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

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

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

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

СкиллНизкий риск51,8 тыс.Звезды репозитория
Официальный

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

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

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

MCP-серверВысокий рискРоссийский стекБез VPN1Звезды репозитория
Foxx AIMCP Яндекс Директа на Bun с ЕПК и прокси Click.ru

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