Яндекс Директ MCP: hardened форк

yandex-direct-mcp

Форк популярного MCP-сервера Яндекс Директа с чтением по умолчанию и явными флагами для записи и финансов

nikolaymokh-dev/yandex-direct-mcpАвтор:nikolaymokh-dev

Установка

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

npx skillfoxx add mcp/nikolaymokh-dev-yandex-direct-mcp

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

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

Собрано автоматически, проверьте перед установкой.

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

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

claude mcp add --transport stdio yandex-direct -- uvx --from git+https://github.com/nikolaymokh-dev/yandex-direct-mcp@v0.1.0 yandex-direct-mcp

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

{
  "mcpServers": {
    "yandex-direct": {
      "command": "uvx",
      "args": [
        "--from",
        "git+https://github.com/nikolaymokh-dev/yandex-direct-mcp@v0.1.0",
        "yandex-direct-mcp"
      ]
    }
  }
}

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

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

YANDEX_DIRECT_ENABLE_WRITESнеобязательная: true → активирует профиль campaign-editor. По умолчанию не установлена (только чтение).
YANDEX_DIRECT_ENABLE_FINANCEнеобязательная: true → включает финансовые инструменты. Работает только вместе с ENABLE_WRITES; на профиле analytics не даёт эффекта.
YANDEX_DIRECT_TOOL_PROFILEнеобязательная: Явный выбор профиля: analytics | core | campaign-editor | full. Переопределяет логику ENABLE_WRITES.
YANDEX_DIRECT_ENABLED_GROUPSнеобязательная: Allow-list групп (через запятую): campaigns, ads, read, mutate, analytics, …
YANDEX_DIRECT_DISABLED_GROUPSнеобязательная: Убрать группы из активной поверхности (не расширяет до full — safe-by-default).
YANDEX_DIRECT_ENABLED_TOOLSнеобязательная: Allow-list конкретных инструментов (через запятую).
YANDEX_DIRECT_DISABLED_TOOLSнеобязательная: Убрать конкретные инструменты из активной поверхности.

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

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

{
  "mcpServers": {
    "yandex-direct": {
      "command": "uvx",
      "args": [
        "--from",
        "git+https://github.com/nikolaymokh-dev/yandex-direct-mcp@v0.1.0",
        "yandex-direct-mcp"
      ]
    }
  }
}

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

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

YANDEX_DIRECT_ENABLE_WRITESнеобязательная: true → активирует профиль campaign-editor. По умолчанию не установлена (только чтение).
YANDEX_DIRECT_ENABLE_FINANCEнеобязательная: true → включает финансовые инструменты. Работает только вместе с ENABLE_WRITES; на профиле analytics не даёт эффекта.
YANDEX_DIRECT_TOOL_PROFILEнеобязательная: Явный выбор профиля: analytics | core | campaign-editor | full. Переопределяет логику ENABLE_WRITES.
YANDEX_DIRECT_ENABLED_GROUPSнеобязательная: Allow-list групп (через запятую): campaigns, ads, read, mutate, analytics, …
YANDEX_DIRECT_DISABLED_GROUPSнеобязательная: Убрать группы из активной поверхности (не расширяет до full — safe-by-default).
YANDEX_DIRECT_ENABLED_TOOLSнеобязательная: Allow-list конкретных инструментов (через запятую).
YANDEX_DIRECT_DISABLED_TOOLSнеобязательная: Убрать конкретные инструменты из активной поверхности.

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

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

code --add-mcp '{"name":"yandex-direct","type":"stdio","command":"uvx","args":["--from","git+https://github.com/nikolaymokh-dev/yandex-direct-mcp@v0.1.0","yandex-direct-mcp"]}'

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

{
  "servers": {
    "yandex-direct": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "--from",
        "git+https://github.com/nikolaymokh-dev/yandex-direct-mcp@v0.1.0",
        "yandex-direct-mcp"
      ]
    }
  }
}

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

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

YANDEX_DIRECT_ENABLE_WRITESнеобязательная: true → активирует профиль campaign-editor. По умолчанию не установлена (только чтение).
YANDEX_DIRECT_ENABLE_FINANCEнеобязательная: true → включает финансовые инструменты. Работает только вместе с ENABLE_WRITES; на профиле analytics не даёт эффекта.
YANDEX_DIRECT_TOOL_PROFILEнеобязательная: Явный выбор профиля: analytics | core | campaign-editor | full. Переопределяет логику ENABLE_WRITES.
YANDEX_DIRECT_ENABLED_GROUPSнеобязательная: Allow-list групп (через запятую): campaigns, ads, read, mutate, analytics, …
YANDEX_DIRECT_DISABLED_GROUPSнеобязательная: Убрать группы из активной поверхности (не расширяет до full — safe-by-default).
YANDEX_DIRECT_ENABLED_TOOLSнеобязательная: Allow-list конкретных инструментов (через запятую).
YANDEX_DIRECT_DISABLED_TOOLSнеобязательная: Убрать конкретные инструменты из активной поверхности.

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

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

codex mcp add yandex-direct -- uvx --from git+https://github.com/nikolaymokh-dev/yandex-direct-mcp@v0.1.0 yandex-direct-mcp

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

[mcp_servers.yandex-direct]
command = "uvx"
args = ["--from", "git+https://github.com/nikolaymokh-dev/yandex-direct-mcp@v0.1.0", "yandex-direct-mcp"]

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

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

YANDEX_DIRECT_ENABLE_WRITESнеобязательная: true → активирует профиль campaign-editor. По умолчанию не установлена (только чтение).
YANDEX_DIRECT_ENABLE_FINANCEнеобязательная: true → включает финансовые инструменты. Работает только вместе с ENABLE_WRITES; на профиле analytics не даёт эффекта.
YANDEX_DIRECT_TOOL_PROFILEнеобязательная: Явный выбор профиля: analytics | core | campaign-editor | full. Переопределяет логику ENABLE_WRITES.
YANDEX_DIRECT_ENABLED_GROUPSнеобязательная: Allow-list групп (через запятую): campaigns, ads, read, mutate, analytics, …
YANDEX_DIRECT_DISABLED_GROUPSнеобязательная: Убрать группы из активной поверхности (не расширяет до full — safe-by-default).
YANDEX_DIRECT_ENABLED_TOOLSнеобязательная: Allow-list конкретных инструментов (через запятую).
YANDEX_DIRECT_DISABLED_TOOLSнеобязательная: Убрать конкретные инструменты из активной поверхности.

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

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

{
  "mcpServers": {
    "yandex-direct": {
      "command": "uvx",
      "args": [
        "--from",
        "git+https://github.com/nikolaymokh-dev/yandex-direct-mcp@v0.1.0",
        "yandex-direct-mcp"
      ]
    }
  }
}

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

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

YANDEX_DIRECT_ENABLE_WRITESнеобязательная: true → активирует профиль campaign-editor. По умолчанию не установлена (только чтение).
YANDEX_DIRECT_ENABLE_FINANCEнеобязательная: true → включает финансовые инструменты. Работает только вместе с ENABLE_WRITES; на профиле analytics не даёт эффекта.
YANDEX_DIRECT_TOOL_PROFILEнеобязательная: Явный выбор профиля: analytics | core | campaign-editor | full. Переопределяет логику ENABLE_WRITES.
YANDEX_DIRECT_ENABLED_GROUPSнеобязательная: Allow-list групп (через запятую): campaigns, ads, read, mutate, analytics, …
YANDEX_DIRECT_DISABLED_GROUPSнеобязательная: Убрать группы из активной поверхности (не расширяет до full — safe-by-default).
YANDEX_DIRECT_ENABLED_TOOLSнеобязательная: Allow-list конкретных инструментов (через запятую).
YANDEX_DIRECT_DISABLED_TOOLSнеобязательная: Убрать конкретные инструменты из активной поверхности.

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

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

{
  "mcpServers": {
    "yandex-direct": {
      "command": "uvx",
      "args": [
        "--from",
        "git+https://github.com/nikolaymokh-dev/yandex-direct-mcp@v0.1.0",
        "yandex-direct-mcp"
      ]
    }
  }
}

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

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

YANDEX_DIRECT_ENABLE_WRITESнеобязательная: true → активирует профиль campaign-editor. По умолчанию не установлена (только чтение).
YANDEX_DIRECT_ENABLE_FINANCEнеобязательная: true → включает финансовые инструменты. Работает только вместе с ENABLE_WRITES; на профиле analytics не даёт эффекта.
YANDEX_DIRECT_TOOL_PROFILEнеобязательная: Явный выбор профиля: analytics | core | campaign-editor | full. Переопределяет логику ENABLE_WRITES.
YANDEX_DIRECT_ENABLED_GROUPSнеобязательная: Allow-list групп (через запятую): campaigns, ads, read, mutate, analytics, …
YANDEX_DIRECT_DISABLED_GROUPSнеобязательная: Убрать группы из активной поверхности (не расширяет до full — safe-by-default).
YANDEX_DIRECT_ENABLED_TOOLSнеобязательная: Allow-list конкретных инструментов (через запятую).
YANDEX_DIRECT_DISABLED_TOOLSнеобязательная: Убрать конкретные инструменты из активной поверхности.

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

Бывший Windsurf.

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

{
  "mcpServers": {
    "yandex-direct": {
      "command": "uvx",
      "args": [
        "--from",
        "git+https://github.com/nikolaymokh-dev/yandex-direct-mcp@v0.1.0",
        "yandex-direct-mcp"
      ]
    }
  }
}

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

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

YANDEX_DIRECT_ENABLE_WRITESнеобязательная: true → активирует профиль campaign-editor. По умолчанию не установлена (только чтение).
YANDEX_DIRECT_ENABLE_FINANCEнеобязательная: true → включает финансовые инструменты. Работает только вместе с ENABLE_WRITES; на профиле analytics не даёт эффекта.
YANDEX_DIRECT_TOOL_PROFILEнеобязательная: Явный выбор профиля: analytics | core | campaign-editor | full. Переопределяет логику ENABLE_WRITES.
YANDEX_DIRECT_ENABLED_GROUPSнеобязательная: Allow-list групп (через запятую): campaigns, ads, read, mutate, analytics, …
YANDEX_DIRECT_DISABLED_GROUPSнеобязательная: Убрать группы из активной поверхности (не расширяет до full — safe-by-default).
YANDEX_DIRECT_ENABLED_TOOLSнеобязательная: Allow-list конкретных инструментов (через запятую).
YANDEX_DIRECT_DISABLED_TOOLSнеобязательная: Убрать конкретные инструменты из активной поверхности.

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

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

{
  "mcpServers": {
    "yandex-direct": {
      "command": "uvx",
      "args": [
        "--from",
        "git+https://github.com/nikolaymokh-dev/yandex-direct-mcp@v0.1.0",
        "yandex-direct-mcp"
      ]
    }
  }
}

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

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

YANDEX_DIRECT_ENABLE_WRITESнеобязательная: true → активирует профиль campaign-editor. По умолчанию не установлена (только чтение).
YANDEX_DIRECT_ENABLE_FINANCEнеобязательная: true → включает финансовые инструменты. Работает только вместе с ENABLE_WRITES; на профиле analytics не даёт эффекта.
YANDEX_DIRECT_TOOL_PROFILEнеобязательная: Явный выбор профиля: analytics | core | campaign-editor | full. Переопределяет логику ENABLE_WRITES.
YANDEX_DIRECT_ENABLED_GROUPSнеобязательная: Allow-list групп (через запятую): campaigns, ads, read, mutate, analytics, …
YANDEX_DIRECT_DISABLED_GROUPSнеобязательная: Убрать группы из активной поверхности (не расширяет до full — safe-by-default).
YANDEX_DIRECT_ENABLED_TOOLSнеобязательная: Allow-list конкретных инструментов (через запятую).
YANDEX_DIRECT_DISABLED_TOOLSнеобязательная: Убрать конкретные инструменты из активной поверхности.

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

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

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

{
  "mcp": {
    "yandex-direct": {
      "type": "local",
      "command": [
        "uvx",
        "--from",
        "git+https://github.com/nikolaymokh-dev/yandex-direct-mcp@v0.1.0",
        "yandex-direct-mcp"
      ]
    }
  }
}

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

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

YANDEX_DIRECT_ENABLE_WRITESнеобязательная: true → активирует профиль campaign-editor. По умолчанию не установлена (только чтение).
YANDEX_DIRECT_ENABLE_FINANCEнеобязательная: true → включает финансовые инструменты. Работает только вместе с ENABLE_WRITES; на профиле analytics не даёт эффекта.
YANDEX_DIRECT_TOOL_PROFILEнеобязательная: Явный выбор профиля: analytics | core | campaign-editor | full. Переопределяет логику ENABLE_WRITES.
YANDEX_DIRECT_ENABLED_GROUPSнеобязательная: Allow-list групп (через запятую): campaigns, ads, read, mutate, analytics, …
YANDEX_DIRECT_DISABLED_GROUPSнеобязательная: Убрать группы из активной поверхности (не расширяет до full — safe-by-default).
YANDEX_DIRECT_ENABLED_TOOLSнеобязательная: Allow-list конкретных инструментов (через запятую).
YANDEX_DIRECT_DISABLED_TOOLSнеобязательная: Убрать конкретные инструменты из активной поверхности.

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

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

{
  "context_servers": {
    "yandex-direct": {
      "command": "uvx",
      "args": [
        "--from",
        "git+https://github.com/nikolaymokh-dev/yandex-direct-mcp@v0.1.0",
        "yandex-direct-mcp"
      ]
    }
  }
}

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

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

YANDEX_DIRECT_ENABLE_WRITESнеобязательная: true → активирует профиль campaign-editor. По умолчанию не установлена (только чтение).
YANDEX_DIRECT_ENABLE_FINANCEнеобязательная: true → включает финансовые инструменты. Работает только вместе с ENABLE_WRITES; на профиле analytics не даёт эффекта.
YANDEX_DIRECT_TOOL_PROFILEнеобязательная: Явный выбор профиля: analytics | core | campaign-editor | full. Переопределяет логику ENABLE_WRITES.
YANDEX_DIRECT_ENABLED_GROUPSнеобязательная: Allow-list групп (через запятую): campaigns, ads, read, mutate, analytics, …
YANDEX_DIRECT_DISABLED_GROUPSнеобязательная: Убрать группы из активной поверхности (не расширяет до full — safe-by-default).
YANDEX_DIRECT_ENABLED_TOOLSнеобязательная: Allow-list конкретных инструментов (через запятую).
YANDEX_DIRECT_DISABLED_TOOLSнеобязательная: Убрать конкретные инструменты из активной поверхности.

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

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

{
  "mcpServers": {
    "yandex-direct": {
      "command": "uvx",
      "args": [
        "--from",
        "git+https://github.com/nikolaymokh-dev/yandex-direct-mcp@v0.1.0",
        "yandex-direct-mcp"
      ]
    }
  }
}

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

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

YANDEX_DIRECT_ENABLE_WRITESнеобязательная: true → активирует профиль campaign-editor. По умолчанию не установлена (только чтение).
YANDEX_DIRECT_ENABLE_FINANCEнеобязательная: true → включает финансовые инструменты. Работает только вместе с ENABLE_WRITES; на профиле analytics не даёт эффекта.
YANDEX_DIRECT_TOOL_PROFILEнеобязательная: Явный выбор профиля: analytics | core | campaign-editor | full. Переопределяет логику ENABLE_WRITES.
YANDEX_DIRECT_ENABLED_GROUPSнеобязательная: Allow-list групп (через запятую): campaigns, ads, read, mutate, analytics, …
YANDEX_DIRECT_DISABLED_GROUPSнеобязательная: Убрать группы из активной поверхности (не расширяет до full — safe-by-default).
YANDEX_DIRECT_ENABLED_TOOLSнеобязательная: Allow-list конкретных инструментов (через запятую).
YANDEX_DIRECT_DISABLED_TOOLSнеобязательная: Убрать конкретные инструменты из активной поверхности.

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

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

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

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

Поставь сервер командой claude mcp add yandex-direct -- uvx --from git+https://github.com/nikolaymokh-dev/yandex-direct-mcp@v0.1.0 yandex-direct-mcp, вызови auth_login() и авторизуйся в браузере. Для управления кампаниями добавь переменную YANDEX_DIRECT_ENABLE_WRITES=true, для финансовых операций отдельно YANDEX_DIRECT_ENABLE_FINANCE=true.

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

claude mcp add yandex-direct -- uvx --from git+https://github.com/nikolaymokh-dev/yandex-direct-mcp@v0.1.0 yandex-direct-mcp

Ставит сервер в режиме только чтения. Для записи добавьте --env YANDEX_DIRECT_ENABLE_WRITES=true.

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

Что делает

Сервер дает агенту доступ к API Яндекс Директа через 146 инструментов: отчеты, статистику, прогноз бюджета, Wordstat и словари в профиле по умолчанию analytics, а кампании, группы, объявления и ставки открываются только при явном включении записи. Авторизация идет через пакет direct-cli с PKCE: каждый пользователь входит под своим Яндекс-аккаунтом, токен хранится локально с ограниченными правами доступа к файлу. Финансовые инструменты вроде пополнения счета и переводов требуют отдельного флага сверх записи. Поверхность инструментов можно сузить allow- и deny-списками по группам или по конкретным именам.

Для кого. Для специалистов по контекстной рекламе, которым важно начать с безопасного чтения и включать запись осознанно.

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

Нужен доступ к Директу с чтением по умолчанию, без риска случайных изменений
Нужно постепенно расширять права агента: сначала аналитика, потом кампании, потом финансы
Работаете в Claude Code и хотите поставить сервер одной командой через uvx

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

Нужен пакет с гарантированной стабильностью интерфейсов, а не форк с быстрым циклом правок
Нет времени разбираться в профилях и allow-листах инструментов

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

Покажи статистику кампаний Директа за последние 14 дней, ничего не меняя

Ограничения

Нужно свое OAuth-приложение Яндекса с одобренной заявкой на API Директа. Форк неофициальный, ведется одним автором поверх axisrow/yandex-direct-mcp-plugin с отдельной синхронизацией апстрима. Финансовые инструменты работают с реальными деньгами и требуют осознанного включения флагом отдельно от записи.

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

MCP

Транспорт: stdio
Авторизация: OAuth

Переменные окружения
Переменные окружения
YANDEX_DIRECT_ENABLE_WRITES	true включает профиль campaign-editor с правом на изменения
YANDEX_DIRECT_ENABLE_FINANCE	true включает финансовые инструменты, работает только вместе с ENABLE_WRITES
YANDEX_DIRECT_TOOL_PROFILE	Явный выбор профиля: analytics, core, campaign-editor или full

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

При включенной записи меняет кампании, группы, объявления и ставки в боевом кабинете
Финансовые инструменты пополняют счет и переводят деньги между аккаунтами
Хранит OAuth-токен пользователя локально

Коротко о README

README описывает форк как hardened версию axisrow/yandex-direct-mcp-plugin с профилями analytics, campaign-editor и full, таблицей переменных окружения для управления поверхностью инструментов, установкой через uvx для Claude Code, шагами PKCE-авторизации и отдельным включением финансовых операций. Есть ссылки на документы по настройке доступа, модели угроз и синхронизации с апстримом.

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

Опасно ли ставить сервер сразу без настроек?

Нет, по умолчанию активен только профиль analytics: отчеты и чтение, без прав на изменение кампаний.

Чем это отличается от исходного axisrow/yandex-direct-mcp-plugin?

Тем же покрытием API, но с read-only по умолчанию, раздельными флагами для записи и финансов и закрепленными версиями зависимостей, подробности в FORK.md репозитория.

Humanizer

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

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

СкиллНизкий рискБез VPN52,7 тыс.

Marketing Skills: маркетинговые скиллы для агентов

Marketing Skills for AI Agents

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

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

СкиллНизкий риск51,8 тыс.

MCP-сервер SendPulse

SendPulse MCP

Официальный

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

MCP-серверВысокий рискРоссийский стек1

MCP Яндекс Директа из машиночитаемой схемы

yandex-direct-mcp

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

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

MCP-серверВысокий рискРоссийский стекБез VPN1

Установка

Что делает

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

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

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

Ограничения

MCP

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

Коротко о README

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

Похожие

Humanizer

Marketing Skills: маркетинговые скиллы для агентов

MCP-сервер SendPulse

MCP Яндекс Директа из машиночитаемой схемы