MCP для Яндекс Директа с двумя режимами

Яндекс Директ MCP

MCP Яндекс Директа с двумя способами подключения: удаленный только для чтения по URL и локальный с полным доступом через npx

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

askads/mcp-yandex-directАвтор:Ask Ads

Установка

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

npx skillfoxx add mcp/yandeks-direkt-mcp

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

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

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

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

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

claude mcp add --transport stdio --env YANDEX_DIRECT_SANDBOX=true --env YANDEX_DIRECT_LANG=ru --env YANDEX_DIRECT_TIMEOUT_MS=60000 --env YANDEX_DIRECT_MAX_RETRIES=3 yandex-direct -- npx -y mcp-yandex-direct@latest

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

{
  "mcpServers": {
    "yandex-direct": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-yandex-direct@latest"
      ],
      "env": {
        "YANDEX_DIRECT_SANDBOX": "true",
        "YANDEX_DIRECT_LANG": "ru",
        "YANDEX_DIRECT_TIMEOUT_MS": "60000",
        "YANDEX_DIRECT_MAX_RETRIES": "3"
      }
    }
  }
}

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

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

YANDEX_DIRECT_TOKENсекрет, необязательная: Готовый OAuth-токен; имеет приоритет над входом из чата
YANDEX_DIRECT_LOGINнеобязательная: Логин клиента при работе через агентский аккаунт; иначе API покажет аккаунт агентства
YANDEX_DIRECT_OAUTH_CLIENT_IDсекрет, необязательная: Client ID собственного OAuth-приложения вместо встроенного

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

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

{
  "mcpServers": {
    "yandex-direct": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-yandex-direct@latest"
      ],
      "env": {
        "YANDEX_DIRECT_SANDBOX": "true",
        "YANDEX_DIRECT_LANG": "ru",
        "YANDEX_DIRECT_TIMEOUT_MS": "60000",
        "YANDEX_DIRECT_MAX_RETRIES": "3"
      }
    }
  }
}

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

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

YANDEX_DIRECT_TOKENсекрет, необязательная: Готовый OAuth-токен; имеет приоритет над входом из чата
YANDEX_DIRECT_LOGINнеобязательная: Логин клиента при работе через агентский аккаунт; иначе API покажет аккаунт агентства
YANDEX_DIRECT_OAUTH_CLIENT_IDсекрет, необязательная: Client ID собственного OAuth-приложения вместо встроенного

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

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

code --add-mcp '{"name":"yandex-direct","type":"stdio","command":"npx","args":["-y","mcp-yandex-direct@latest"],"env":{"YANDEX_DIRECT_SANDBOX":"true","YANDEX_DIRECT_LANG":"ru","YANDEX_DIRECT_TIMEOUT_MS":"60000","YANDEX_DIRECT_MAX_RETRIES":"3"}}'

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

{
  "servers": {
    "yandex-direct": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "mcp-yandex-direct@latest"
      ],
      "env": {
        "YANDEX_DIRECT_SANDBOX": "true",
        "YANDEX_DIRECT_LANG": "ru",
        "YANDEX_DIRECT_TIMEOUT_MS": "60000",
        "YANDEX_DIRECT_MAX_RETRIES": "3"
      }
    }
  }
}

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

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

YANDEX_DIRECT_TOKENсекрет, необязательная: Готовый OAuth-токен; имеет приоритет над входом из чата
YANDEX_DIRECT_LOGINнеобязательная: Логин клиента при работе через агентский аккаунт; иначе API покажет аккаунт агентства
YANDEX_DIRECT_OAUTH_CLIENT_IDсекрет, необязательная: Client ID собственного OAuth-приложения вместо встроенного

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

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

codex mcp add yandex-direct --env YANDEX_DIRECT_SANDBOX=true --env YANDEX_DIRECT_LANG=ru --env YANDEX_DIRECT_TIMEOUT_MS=60000 --env YANDEX_DIRECT_MAX_RETRIES=3 -- npx -y mcp-yandex-direct@latest

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

[mcp_servers.yandex-direct]
command = "npx"
args = ["-y", "mcp-yandex-direct@latest"]
env = { YANDEX_DIRECT_SANDBOX = "true", YANDEX_DIRECT_LANG = "ru", YANDEX_DIRECT_TIMEOUT_MS = "60000", YANDEX_DIRECT_MAX_RETRIES = "3" }

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

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

YANDEX_DIRECT_TOKENсекрет, необязательная: Готовый OAuth-токен; имеет приоритет над входом из чата
YANDEX_DIRECT_LOGINнеобязательная: Логин клиента при работе через агентский аккаунт; иначе API покажет аккаунт агентства
YANDEX_DIRECT_OAUTH_CLIENT_IDсекрет, необязательная: Client ID собственного OAuth-приложения вместо встроенного

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

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

{
  "mcpServers": {
    "yandex-direct": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-yandex-direct@latest"
      ],
      "env": {
        "YANDEX_DIRECT_SANDBOX": "true",
        "YANDEX_DIRECT_LANG": "ru",
        "YANDEX_DIRECT_TIMEOUT_MS": "60000",
        "YANDEX_DIRECT_MAX_RETRIES": "3"
      }
    }
  }
}

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

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

YANDEX_DIRECT_TOKENсекрет, необязательная: Готовый OAuth-токен; имеет приоритет над входом из чата
YANDEX_DIRECT_LOGINнеобязательная: Логин клиента при работе через агентский аккаунт; иначе API покажет аккаунт агентства
YANDEX_DIRECT_OAUTH_CLIENT_IDсекрет, необязательная: Client ID собственного OAuth-приложения вместо встроенного

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

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

{
  "mcpServers": {
    "yandex-direct": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-yandex-direct@latest"
      ],
      "env": {
        "YANDEX_DIRECT_SANDBOX": "true",
        "YANDEX_DIRECT_LANG": "ru",
        "YANDEX_DIRECT_TIMEOUT_MS": "60000",
        "YANDEX_DIRECT_MAX_RETRIES": "3"
      }
    }
  }
}

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

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

YANDEX_DIRECT_TOKENсекрет, необязательная: Готовый OAuth-токен; имеет приоритет над входом из чата
YANDEX_DIRECT_LOGINнеобязательная: Логин клиента при работе через агентский аккаунт; иначе API покажет аккаунт агентства
YANDEX_DIRECT_OAUTH_CLIENT_IDсекрет, необязательная: Client ID собственного OAuth-приложения вместо встроенного

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

Бывший Windsurf.

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

{
  "mcpServers": {
    "yandex-direct": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-yandex-direct@latest"
      ],
      "env": {
        "YANDEX_DIRECT_SANDBOX": "true",
        "YANDEX_DIRECT_LANG": "ru",
        "YANDEX_DIRECT_TIMEOUT_MS": "60000",
        "YANDEX_DIRECT_MAX_RETRIES": "3"
      }
    }
  }
}

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

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

YANDEX_DIRECT_TOKENсекрет, необязательная: Готовый OAuth-токен; имеет приоритет над входом из чата
YANDEX_DIRECT_LOGINнеобязательная: Логин клиента при работе через агентский аккаунт; иначе API покажет аккаунт агентства
YANDEX_DIRECT_OAUTH_CLIENT_IDсекрет, необязательная: Client ID собственного OAuth-приложения вместо встроенного

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

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

{
  "mcpServers": {
    "yandex-direct": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-yandex-direct@latest"
      ],
      "env": {
        "YANDEX_DIRECT_SANDBOX": "true",
        "YANDEX_DIRECT_LANG": "ru",
        "YANDEX_DIRECT_TIMEOUT_MS": "60000",
        "YANDEX_DIRECT_MAX_RETRIES": "3"
      }
    }
  }
}

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

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

YANDEX_DIRECT_TOKENсекрет, необязательная: Готовый OAuth-токен; имеет приоритет над входом из чата
YANDEX_DIRECT_LOGINнеобязательная: Логин клиента при работе через агентский аккаунт; иначе API покажет аккаунт агентства
YANDEX_DIRECT_OAUTH_CLIENT_IDсекрет, необязательная: Client ID собственного OAuth-приложения вместо встроенного

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

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

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

{
  "mcp": {
    "yandex-direct": {
      "type": "local",
      "command": [
        "npx",
        "-y",
        "mcp-yandex-direct@latest"
      ],
      "environment": {
        "YANDEX_DIRECT_SANDBOX": "true",
        "YANDEX_DIRECT_LANG": "ru",
        "YANDEX_DIRECT_TIMEOUT_MS": "60000",
        "YANDEX_DIRECT_MAX_RETRIES": "3"
      }
    }
  }
}

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

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

YANDEX_DIRECT_TOKENсекрет, необязательная: Готовый OAuth-токен; имеет приоритет над входом из чата
YANDEX_DIRECT_LOGINнеобязательная: Логин клиента при работе через агентский аккаунт; иначе API покажет аккаунт агентства
YANDEX_DIRECT_OAUTH_CLIENT_IDсекрет, необязательная: Client ID собственного OAuth-приложения вместо встроенного

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

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

{
  "context_servers": {
    "yandex-direct": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-yandex-direct@latest"
      ],
      "env": {
        "YANDEX_DIRECT_SANDBOX": "true",
        "YANDEX_DIRECT_LANG": "ru",
        "YANDEX_DIRECT_TIMEOUT_MS": "60000",
        "YANDEX_DIRECT_MAX_RETRIES": "3"
      }
    }
  }
}

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

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

YANDEX_DIRECT_TOKENсекрет, необязательная: Готовый OAuth-токен; имеет приоритет над входом из чата
YANDEX_DIRECT_LOGINнеобязательная: Логин клиента при работе через агентский аккаунт; иначе API покажет аккаунт агентства
YANDEX_DIRECT_OAUTH_CLIENT_IDсекрет, необязательная: Client ID собственного OAuth-приложения вместо встроенного

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

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

{
  "mcpServers": {
    "yandex-direct": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-yandex-direct@latest"
      ],
      "env": {
        "YANDEX_DIRECT_SANDBOX": "true",
        "YANDEX_DIRECT_LANG": "ru",
        "YANDEX_DIRECT_TIMEOUT_MS": "60000",
        "YANDEX_DIRECT_MAX_RETRIES": "3"
      }
    }
  }
}

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

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

YANDEX_DIRECT_TOKENсекрет, необязательная: Готовый OAuth-токен; имеет приоритет над входом из чата
YANDEX_DIRECT_LOGINнеобязательная: Логин клиента при работе через агентский аккаунт; иначе API покажет аккаунт агентства
YANDEX_DIRECT_OAUTH_CLIENT_IDсекрет, необязательная: Client ID собственного OAuth-приложения вместо встроенного

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

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

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

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

Для быстрого чтения без токена: claude mcp add --transport http yandex-direct https://mcp.askads.ru/mcp, затем /mcp и вход через Яндекс. Для полного доступа: claude mcp add --transport stdio --scope user yandex-direct -- npx -y mcp-yandex-direct@latest и подключение в диалоге.

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

claude mcp add --transport http yandex-direct https://mcp.askads.ru/mcp

Удаленный read-only режим, авторизация через /mcp и вход в Яндекс.

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

Как мы проверяем

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

Локальный режим меняет настройки рекламы в боевом кабинете и может повлиять на расход
OAuth-токен продлевается автоматически и дает длительный доступ к аккаунту

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

Что делает

Сервер дает 44 инструмента: кампании, группы, объявления, ключевые фразы, ставки, корректировки, расширения, статистику, баланс, справочники. Есть два способа подключения. Удаленный сервер по адресу mcp.askads.ru/mcp работает через OAuth в браузере без ручного получения токена, но только читает: статистику, аудит и объекты кабинета без изменений. Локальный сервер через npx дает полный доступ на запись, подключение тоже начинается в диалоге через одноразовый код Яндекса, токен продлевается автоматически. Бюджеты, ставки и баланс показываются в валюте аккаунта, а не в микроединицах API.

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

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

Нужен быстрый read-only доступ к статистике и структуре кабинета без получения токена заранее
Нужен полный доступ на запись: паузы, ставки, минус-слова из локального сервера
Нужно сравнить кампании, объявления и ключевые фразы и понять, куда уходит бюджет

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

Нужен именно удаленный сервер, но с правом на запись: URL-версия read-only принципиально
Нет Node.js 20+ и нет возможности запускать npx локально
Нужна тестовая среда: README не описывает отдельный режим песочницы

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

Покажи кампании моего аккаунта и расход за прошлую неделю по группам объявлений

MCP

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

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

YANDEX_DIRECT_TOKEN секрет: Готовый токен для CI и агентских установок локального режима
YANDEX_DIRECT_LOGIN: Логин клиента для агентских токенов

Ограничения

Локальные изменения применяются в боевом кабинете и могут повлиять на расход, отдельного флага песочницы README не описывает. Для CI и агентских установок нужен готовый токен и YANDEX_DIRECT_LOGIN. Удаленный режим read-only и не подходит, если нужна запись без установки npx.

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

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

Чем отличаются удаленный и локальный режимы?

Удаленный по URL работает без установки и только читает данные, локальный через npx дает полный доступ на запись и требует Node.js 20+.

Нужен ли токен заранее?

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

MCP-серверы

Humanizer

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

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

СкиллНизкий риск52,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-серверВысокий риск1

Коротко о README

README сравнивает два способа подключения таблицей и дает готовые инструкции для Codex, Claude Code и других клиентов. Отдельные разделы «Как это работает» и «Что может изменить данные» объясняют разницу между read-only и полным доступом, а раздел про телеметрию описывает анонимную статистику использования с отключением через переменную окружения.

Установка

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

Что делает

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

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

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

MCP

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

Ограничения

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

Похожие

Humanizer

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

MCP-сервер SendPulse

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

Коротко о README