SkillFoxx

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

MCP, CLI и модели Яндекс Директа с поиском действий

mcp-server-yandex-direct

MCP-сервер, CLI-утилита и Pydantic-модели для API v5 Яндекс Директа: 79 действий через два инструмента вместо 79 отдельных

MCP-сервер

Высокий риск

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

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

  • 79 действий покрывают создание, изменение и архивацию кампаний, объявлений и ключевых слов
  • Работает по боевому аккаунту, встроенного dry-run в README не описано
Все причины и проверки
Российский стек

dontsovcmc/mcp-server-yandex-directАвтор:dontsovcmc

Установка

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

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

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

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

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

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

claude mcp add --transport stdio --env 'YD_TOKEN=<ваш YD_TOKEN>' yandex-direct -- uvx mcp-server-yandex-direct==0.3.0

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

{
  "mcpServers": {
    "yandex-direct": {
      "command": "uvx",
      "args": [
        "mcp-server-yandex-direct==0.3.0"
      ],
      "env": {
        "YD_TOKEN": "<ваш YD_TOKEN>"
      }
    }
  }
}

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

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

YD_TOKENсекрет, обязательная
YD_CLIENT_LOGINнеобязательная
YD_LANGнеобязательная
YD_TIMEOUTнеобязательная
YD_FILE_TIMEOUTнеобязательная

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

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

{
  "mcpServers": {
    "yandex-direct": {
      "command": "uvx",
      "args": [
        "mcp-server-yandex-direct==0.3.0"
      ],
      "env": {
        "YD_TOKEN": "<ваш YD_TOKEN>"
      }
    }
  }
}

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

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

YD_TOKENсекрет, обязательная
YD_CLIENT_LOGINнеобязательная
YD_LANGнеобязательная
YD_TIMEOUTнеобязательная
YD_FILE_TIMEOUTнеобязательная

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

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

code --add-mcp '{"name":"yandex-direct","type":"stdio","command":"uvx","args":["mcp-server-yandex-direct==0.3.0"],"env":{"YD_TOKEN":"<ваш YD_TOKEN>"}}'

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

{
  "servers": {
    "yandex-direct": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "mcp-server-yandex-direct==0.3.0"
      ],
      "env": {
        "YD_TOKEN": "<ваш YD_TOKEN>"
      }
    }
  }
}

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

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

YD_TOKENсекрет, обязательная
YD_CLIENT_LOGINнеобязательная
YD_LANGнеобязательная
YD_TIMEOUTнеобязательная
YD_FILE_TIMEOUTнеобязательная

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

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

codex mcp add yandex-direct --env 'YD_TOKEN=<ваш YD_TOKEN>' -- uvx mcp-server-yandex-direct==0.3.0

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

[mcp_servers.yandex-direct]
command = "uvx"
args = ["mcp-server-yandex-direct==0.3.0"]
env = { YD_TOKEN = "<ваш YD_TOKEN>" }

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

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

YD_TOKENсекрет, обязательная
YD_CLIENT_LOGINнеобязательная
YD_LANGнеобязательная
YD_TIMEOUTнеобязательная
YD_FILE_TIMEOUTнеобязательная

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

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

gemini mcp add -s user -e 'YD_TOKEN=<ваш YD_TOKEN>' yandex-direct uvx mcp-server-yandex-direct==0.3.0

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

{
  "mcpServers": {
    "yandex-direct": {
      "command": "uvx",
      "args": [
        "mcp-server-yandex-direct==0.3.0"
      ],
      "env": {
        "YD_TOKEN": "<ваш YD_TOKEN>"
      }
    }
  }
}

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

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

YD_TOKENсекрет, обязательная
YD_CLIENT_LOGINнеобязательная
YD_LANGнеобязательная
YD_TIMEOUTнеобязательная
YD_FILE_TIMEOUTнеобязательная

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

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

{
  "mcpServers": {
    "yandex-direct": {
      "command": "uvx",
      "args": [
        "mcp-server-yandex-direct==0.3.0"
      ],
      "env": {
        "YD_TOKEN": "<ваш YD_TOKEN>"
      }
    }
  }
}

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

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

YD_TOKENсекрет, обязательная
YD_CLIENT_LOGINнеобязательная
YD_LANGнеобязательная
YD_TIMEOUTнеобязательная
YD_FILE_TIMEOUTнеобязательная

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

Бывший Windsurf.

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

{
  "mcpServers": {
    "yandex-direct": {
      "command": "uvx",
      "args": [
        "mcp-server-yandex-direct==0.3.0"
      ],
      "env": {
        "YD_TOKEN": "<ваш YD_TOKEN>"
      }
    }
  }
}

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

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

YD_TOKENсекрет, обязательная
YD_CLIENT_LOGINнеобязательная
YD_LANGнеобязательная
YD_TIMEOUTнеобязательная
YD_FILE_TIMEOUTнеобязательная

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

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

{
  "mcpServers": {
    "yandex-direct": {
      "command": "uvx",
      "args": [
        "mcp-server-yandex-direct==0.3.0"
      ],
      "env": {
        "YD_TOKEN": "<ваш YD_TOKEN>"
      }
    }
  }
}

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

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

YD_TOKENсекрет, обязательная
YD_CLIENT_LOGINнеобязательная
YD_LANGнеобязательная
YD_TIMEOUTнеобязательная
YD_FILE_TIMEOUTнеобязательная

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

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

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

{
  "mcp": {
    "yandex-direct": {
      "type": "local",
      "command": [
        "uvx",
        "mcp-server-yandex-direct==0.3.0"
      ],
      "environment": {
        "YD_TOKEN": "<ваш YD_TOKEN>"
      }
    }
  }
}

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

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

YD_TOKENсекрет, обязательная
YD_CLIENT_LOGINнеобязательная
YD_LANGнеобязательная
YD_TIMEOUTнеобязательная
YD_FILE_TIMEOUTнеобязательная

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

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

{
  "context_servers": {
    "yandex-direct": {
      "command": "uvx",
      "args": [
        "mcp-server-yandex-direct==0.3.0"
      ],
      "env": {
        "YD_TOKEN": "<ваш YD_TOKEN>"
      }
    }
  }
}

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

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

YD_TOKENсекрет, обязательная
YD_CLIENT_LOGINнеобязательная
YD_LANGнеобязательная
YD_TIMEOUTнеобязательная
YD_FILE_TIMEOUTнеобязательная

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

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

{
  "mcpServers": {
    "yandex-direct": {
      "command": "uvx",
      "args": [
        "mcp-server-yandex-direct==0.3.0"
      ],
      "env": {
        "YD_TOKEN": "<ваш YD_TOKEN>"
      }
    }
  }
}

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

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

YD_TOKENсекрет, обязательная
YD_CLIENT_LOGINнеобязательная
YD_LANGнеобязательная
YD_TIMEOUTнеобязательная
YD_FILE_TIMEOUTнеобязательная

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

Понадобится: uv

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

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

Получи OAuth-токен Яндекс Директа в разделе Настройки, API кабинета direct.yandex.ru и подключи сервер: claude mcp add yandex-direct -e YD_TOKEN=ваш_токен -- uvx mcp-server-yandex-direct.

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

Требует uv, не устанавливает пакет заранее.

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

Что делает

Проект дает три способа работы с API v5 Директа поверх одной библиотеки типизированных Pydantic-моделей: MCP-сервер для Claude Code и других клиентов, CLI-утилиту для терминала и скриптов, и саму библиотеку моделей для своих Python-программ. Вместо 79 отдельных инструментов на каждое действие сервер использует паттерн search plus execute: yd_search находит нужное действие по описанию на естественном языке и возвращает его схему параметров, а yd_execute выполняет его по id. 79 действий сгруппированы по 16 доменам: кампании, группы, объявления, ключевые слова, ставки, аудитории, фиды, креативы, лиды, отслеживание изменений, аккаунт, турбо-страницы и отчеты. Все данные остаются на компьютере пользователя, токен никуда не передается, кроме API Яндекса.

Для кого. Для разработчиков, которым нужен и MCP-сервер для агента, и CLI для скриптов, и типизированные модели API v5 для своего Python-кода в одном пакете.

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

  • Нужен и агентский MCP-сервер, и обычная командная строка для автоматизации без модели
  • Нужны типизированные Pydantic-модели Direct API для собственных Python-скриптов
  • Модель модели путается в десятках инструментов: поиск действия по описанию проще, чем держать в контексте все 79

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

  • Нужны отдельные именованные инструменты на каждое действие, а не поиск по описанию
  • Не пишете на Python и библиотека моделей вам не нужна
  • Нужна встроенная защита dry-run: README ее не описывает

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

Найди действие для остановки кампаний и останови кампанию 12345

Ограничения

Нужен собственный OAuth-токен, полученный в разделе Настройки, API личного кабинета Директа. Паттерн search plus execute требует от модели сначала найти действие, а потом вызвать его: это два шага вместо одного прямого инструмента. Лицензия в репозитории не указана явно на уровне GitHub API.

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

MCP

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

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

  • 79 действий покрывают создание, изменение и архивацию кампаний, объявлений и ключевых слов
  • Работает по боевому аккаунту, встроенного dry-run в README не описано

Коротко о README

README описывает архитектуру search plus execute с примером диалога поиска и выполнения действия, таблицу из 16 доменов с количеством действий в каждом и ссылками на подробную документацию, а также три отдельных раздела установки: MCP-сервер, CLI-утилита и библиотека моделей, каждый со своими примерами. Отдельно подчеркнуто, что все данные остаются локально и токен никуда не передается.

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

Как модель находит нужное действие среди 79?

Инструмент yd_search принимает описание задачи на естественном языке, например «остановить кампании», и возвращает список подходящих действий со схемой параметров для yd_execute.

Можно ли использовать без MCP, просто из терминала?

Да, в пакете есть отдельная CLI-утилита для тех же 79 действий и библиотека Pydantic-моделей для своих Python-программ.

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

Набор скиллов, который задает агенту процесс разработки: уточнение задачи, план, TDD, субагенты и ревью кода

ПлагинСредний рискБез VPN292,5 тыс.
Выбор редакции

Небольшие компонуемые скиллы для инженерной работы с агентом: интервью по плану, TDD, диагностика багов, ревью и архитектура

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

Набор GitHub для разработки от спецификации: CLI specify ставит в проект команды и скиллы для агента, от принципов до реализации

CLIСредний рискБез VPN139,3 тыс.

Референсные MCP-серверы

Model Context Protocol servers

Официальный

Официальные референсные MCP-серверы: Filesystem, Fetch, Git, Memory, Sequential Thinking, Time и Everything

MCP-серверСредний риск90,6 тыс.
Foxx AIMCP, CLI и модели Яндекс Директа с поиском действий

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