yandex-direct-mcp

Hardened форк axisrow/yandex-direct-mcp-plugin. Управление Яндекс.Директом из MCP-клиента (Claude Code, Cursor и другие). Только чтение по умолчанию — запись включается явно через YANDEX_DIRECT_ENABLE_WRITES=true. OAuth реализован пакетом direct-cli (бинарь direct); каждый пользователь авторизуется под своим Яндекс-аккаунтом.

Профили и поверхность инструментов

Переменные окружения

Важно: DISABLED_* переменные уточняют активную поверхность, но не расширяют её до полного набора. Если одновременно не указаны ENABLED_*, не выставлен явный TOOL_PROFILE и не установлен ENABLE_WRITES=true — сервер стартует в профиле analytics (только чтение).

Приоритет: YANDEX_DIRECT_ENABLE_WRITES игнорируется, если задан YANDEX_DIRECT_TOOL_PROFILE или любая из YANDEX_DIRECT_ENABLED_GROUPS/YANDEX_DIRECT_ENABLED_TOOLS — явный профиль или allow-list имеют приоритет.

Related MCP server: vk-ads-mcp

Установка

Claude Code (рекомендуемый способ — uvx)

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

Чтобы включить запись:

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

.claude.json / Cursor / другие MCP-клиенты

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

Поле "env" не обязательно — без него сервер запускается в read-only (analytics) режиме.

Запуск standalone (без MCP-клиента, для проверки)

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

Запускает stdio-сервер напрямую (для теста установки; обычно сервер запускает MCP-клиент).

Первый вход (OAuth / PKCE)

После установки и запуска MCP-сервера вызовите инструмент auth_login:

mcp__yandex_direct__auth_login()

Сервер напечатает URL. Откройте его в браузере и авторизуйтесь в своём Яндекс-аккаунте. PKCE-поток реализован пакетом direct-cli; токен сохраняется локально в ~/.direct-cli/auth.json (права 0600).

Не используйте auth_setup(code=...) на общих машинах — код авторизации будет виден в ps и системных логах.

Включение управления кампаниями и финансов

Запись (управление кампаниями, группами, объявлениями, ставками):

# В ~/.claude/settings.json
{
  "env": {
    "YANDEX_DIRECT_ENABLE_WRITES": "true"
  }
}

Финансовые инструменты (пополнение, счета, переводы) — отдельное осознанное решение:

{
  "env": {
    "YANDEX_DIRECT_ENABLE_WRITES": "true",
    "YANDEX_DIRECT_ENABLE_FINANCE": "true"
  }
}

⚠ Финансовые операции работают с реальными деньгами. Включайте только в окружениях с явными правами на финансовые транзакции.

(Опционально) Запуск как Claude Code плагин

Если репозиторий клонирован локально, плагин запускается через hooks/run-server.sh:

// .mcp.json (пример для Claude Code plugin channel)
{
  "mcpServers": {
    "yandex-direct-mcp": {
      "command": "bash",
      "args": ["${CLAUDE_PLUGIN_ROOT}/hooks/run-server.sh"]
    }
  }
}

Детали bootstrap и troubleshooting — в hooks/setup.sh и CLAUDE.md.

Документация

• Настройка доступа к API → docs/SETUP.md

• Модель угроз и безопасность → docs/SECURITY.md

• Синхронизация с upstream → docs/SYNC.md

Лицензия

MIT — форк axisrow/yandex-direct-mcp-plugin, см. NOTICE.