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

Yurich-ru/yandex-ads-mcp· Проверено 12.11.2026· 50на GitHub

Подключает агента к кабинету Яндекс Директа: кампании, группы, объявления, ключевые фразы, ставки и статистика. Расширенный вариант добавляет Метрику, Яндекс Аудитории и Wordstat.

2 реализации:

152 инструмента на Python: Директ, Метрика, Аудитории и Wordstat в одном сервере, режимы только чтения и подтверждения изменений; ставится клонированием репозитория.

Как подключить

Что сделать до подключения

Python 3 и копия репозитория с зависимостями из requirements.txt в виртуальном окружении venv

Одобренная заявка на доступ к API Директа: Настройки → API → «Получить доступ к API»

YD_OAUTH_TOKEN

создайте приложение на oauth.yandex.ru с правами direct:api, metrika:read, metrika:write, доступом к Аудиториям и cloud:auth, затем откройте oauth.yandex.ru/authorize?response_type=token&client_id=<Client ID>; токен будет в адресной строке после access_token=

YC_FOLDER_ID

нужен только для Wordstat: ID каталога в консоли Yandex Cloud, у пользователя роль search-api.executor и платёжный аккаунт

Конфиг для вашего клиента

Команда в терминале, в папке проекта. Флаг --scope user подключит сервер для всех проектов. Подробно о Claude Code

claude mcp add --env 'YD_OAUTH_TOKEN=<OAuth-токен>' --env 'YC_FOLDER_ID=<ID каталога Yandex Cloud>' --transport stdio yandex-direct \
  -- /path/to/yandex-ads-mcp/venv/bin/python /path/to/yandex-ads-mcp/server.py

Проверка: claude mcp list показывает статус рядом с каждым сервером: ✔ Connected, ! Needs authentication или ✘ Failed to connect. Внутри сессии то же видно по команде /mcp.

Файл ~/.codex/config.toml или .codex/config.toml в доверенном проекте. Можно и командой codex mcp add. Подробно о Codex

[mcp_servers.yandex-direct]
command = "/path/to/yandex-ads-mcp/venv/bin/python"
args = ["/path/to/yandex-ads-mcp/server.py"]

[mcp_servers.yandex-direct.env]
YD_OAUTH_TOKEN = "<OAuth-токен>"
YC_FOLDER_ID = "<ID каталога Yandex Cloud>"

Проверка: В интерфейсе codex введите /mcp: появится список активных серверов. Из терминала то же покажет codex mcp list.

Файл ~/.cursor/mcp.json для всех проектов или .cursor/mcp.json в папке проекта. Подробно о Cursor

{
  "mcpServers": {
    "yandex-direct": {
      "command": "/path/to/yandex-ads-mcp/venv/bin/python",
      "args": ["/path/to/yandex-ads-mcp/server.py"],
      "env": {
        "YD_OAUTH_TOKEN": "<OAuth-токен>",
        "YC_FOLDER_ID": "<ID каталога Yandex Cloud>"
      }
    }
  }
}

Проверка: Откройте Customize в боковой панели: там список серверов с переключателями. Ошибки подключения смотрите в панели Output (Cmd+Shift+U), пункт MCP Logs в выпадающем списке.

Файл .mcp.json в корне проекта или ~/.copilot/mcp-config.json для всех проектов. Подробно о VS Code

{
  "mcpServers": {
    "yandex-direct": {
      "type": "stdio",
      "command": "/path/to/yandex-ads-mcp/venv/bin/python",
      "args": ["/path/to/yandex-ads-mcp/server.py"],
      "env": {
        "YD_OAUTH_TOKEN": "<OAuth-токен>",
        "YC_FOLDER_ID": "<ID каталога Yandex Cloud>"
      }
    }
  }
}

Проверка: Попросите Copilot выполнить безобидную задачу через сервер и раскройте вызов инструмента в чате. Одна запись в конфиге подключение не подтверждает.

Файл ~/.qwen/settings.json или .qwen/settings.json в проекте. Подробно о Qwen Code

{
  "mcpServers": {
    "yandex-direct": {
      "command": "/path/to/yandex-ads-mcp/venv/bin/python",
      "args": ["/path/to/yandex-ads-mcp/server.py"],
      "env": {
        "YD_OAUTH_TOKEN": "<OAuth-токен>",
        "YC_FOLDER_ID": "<ID каталога Yandex Cloud>"
      }
    }
  }
}

Проверка: Запустите qwen и введите /mcp: откроется окно управления серверами. Из терминала статус покажет qwen mcp list.

Файл ~/.gemini/settings.json или .gemini/settings.json в проекте. Подробно о Gemini CLI

{
  "mcpServers": {
    "yandex-direct": {
      "command": "/path/to/yandex-ads-mcp/venv/bin/python",
      "args": ["/path/to/yandex-ads-mcp/server.py"],
      "env": {
        "YD_OAUTH_TOKEN": "<OAuth-токен>",
        "YC_FOLDER_ID": "<ID каталога Yandex Cloud>"
      }
    }
  }
}

Проверка: gemini mcp list показывает каждый сервер, его настройки и статус Connected или Disconnected. В сессии /mcp выводит CONNECTED, CONNECTING или DISCONNECTED и список инструментов.

Файл opencode.json в папке проекта или ~/.config/opencode/opencode.json. Подробно о OpenCode

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "servers": {
      "yandex-direct": {
        "type": "local",
        "command": [
          "/path/to/yandex-ads-mcp/venv/bin/python",
          "/path/to/yandex-ads-mcp/server.py"
        ],
        "environment": {
          "YD_OAUTH_TOKEN": "<OAuth-токен>",
          "YC_FOLDER_ID": "<ID каталога Yandex Cloud>"
        }
      }
    }
  }
}

Проверка: opencode mcp list показывает состояние каждого сервера, подключённый выглядит как ✓ context7 connected. Внутри OpenCode то же видно в /mcps.

Настройки → Разработчик → Изменить конфиг: файл claude_desktop_config.json. После правки перезапустите приложение. Подробно о Claude Desktop

{
  "mcpServers": {
    "yandex-direct": {
      "command": "/path/to/yandex-ads-mcp/venv/bin/python",
      "args": ["/path/to/yandex-ads-mcp/server.py"],
      "env": {
        "YD_OAUTH_TOKEN": "<OAuth-токен>",
        "YC_FOLDER_ID": "<ID каталога Yandex Cloud>"
      }
    }
  }
}

Проверка: Нажмите «Add files, connectors, and more /» в левом нижнем углу поля ввода, наведите на Connectors и откройте Manage connectors. Выберите сервер, чтобы увидеть его инструменты.

Вкладка Program → Install → Edit mcp.json. Подробно о LM Studio

{
  "mcpServers": {
    "yandex-direct": {
      "command": "/path/to/yandex-ads-mcp/venv/bin/python",
      "args": ["/path/to/yandex-ads-mcp/server.py"],
      "env": {
        "YD_OAUTH_TOKEN": "<OAuth-токен>",
        "YC_FOLDER_ID": "<ID каталога Yandex Cloud>"
      }
    }
  }
}

Проверка: Попросите модель в чате выполнить задачу через инструмент сервера. Через API сервер из mcp.json вызывают по id в integrations, например mcp/playwright.

Инструменты сервера

yd_campaigns_getперечисляет кампании

yd_campaigns_addсоздаёт кампанию

yd_campaigns_actionостанавливает и архивирует кампанию

yd_campaign_strategy_updateменяет стратегию и бюджет

yd_ads_addсоздаёт текстовые объявления

yd_keywords_addдобавляет ключевые фразы

yd_keyword_bids_setставит ставки на фразы

yd_bid_modifiers_addдобавляет корректировки ставок

yd_negative_keywords_sets_addсоздаёт набор минус-фраз

yd_sitelinks_addсоздаёт быстрые ссылки

yd_excluded_sites_updateблокирует площадки

yd_reportвыгружает статистику

yd_metrika_counters_getперечисляет счётчики Метрики

yd_audience_segment_uploadзагружает сегмент из CRM

yd_audience_segment_create_lookalikeстроит похожую аудиторию

yd_wordstat_top_requestsпоказывает частотность запросов

yd_wordstat_dynamicsпоказывает динамику частотности

Показано 17 из 152.

20 инструментов на Node.js, ставится через npx; по умолчанию работает в песочнице Директа и не тратит деньги. В том же репозитории отдельные серверы для Wordstat, Поиска, Вебмастера и Метрики.

Как подключить

Что сделать до подключения

Node.js с npx

YANDEX_DIRECT_TOKEN

создайте приложение на oauth.yandex.ru/client/new с доступом direct:api и callback https://oauth.yandex.ru/verification_code, затем запустите npx yandex-direct-mcp auth с YANDEX_CLIENT_ID и YANDEX_CLIENT_SECRET

Конфиг для вашего клиента

Команда в терминале, в папке проекта. Флаг --scope user подключит сервер для всех проектов. Подробно о Claude Code

claude mcp add --env 'YANDEX_DIRECT_TOKEN=<OAuth-токен>' --transport stdio yandex-tools-mcp \
  -- npx -y yandex-direct-mcp

Файл ~/.codex/config.toml или .codex/config.toml в доверенном проекте. Можно и командой codex mcp add. Подробно о Codex

[mcp_servers.yandex-tools-mcp]
command = "npx"
args = ["-y", "yandex-direct-mcp"]

[mcp_servers.yandex-tools-mcp.env]
YANDEX_DIRECT_TOKEN = "<OAuth-токен>"

Файл ~/.cursor/mcp.json для всех проектов или .cursor/mcp.json в папке проекта. Подробно о Cursor

{
  "mcpServers": {
    "yandex-tools-mcp": {
      "command": "npx",
      "args": ["-y", "yandex-direct-mcp"],
      "env": {
        "YANDEX_DIRECT_TOKEN": "<OAuth-токен>"
      }
    }
  }
}

Файл .mcp.json в корне проекта или ~/.copilot/mcp-config.json для всех проектов. Подробно о VS Code

{
  "mcpServers": {
    "yandex-tools-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "yandex-direct-mcp"],
      "env": {
        "YANDEX_DIRECT_TOKEN": "<OAuth-токен>"
      }
    }
  }
}

Файл ~/.qwen/settings.json или .qwen/settings.json в проекте. Подробно о Qwen Code

{
  "mcpServers": {
    "yandex-tools-mcp": {
      "command": "npx",
      "args": ["-y", "yandex-direct-mcp"],
      "env": {
        "YANDEX_DIRECT_TOKEN": "<OAuth-токен>"
      }
    }
  }
}

Файл ~/.gemini/settings.json или .gemini/settings.json в проекте. Подробно о Gemini CLI

{
  "mcpServers": {
    "yandex-tools-mcp": {
      "command": "npx",
      "args": ["-y", "yandex-direct-mcp"],
      "env": {
        "YANDEX_DIRECT_TOKEN": "<OAuth-токен>"
      }
    }
  }
}

Файл opencode.json в папке проекта или ~/.config/opencode/opencode.json. Подробно о OpenCode

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "servers": {
      "yandex-tools-mcp": {
        "type": "local",
        "command": ["npx", "-y", "yandex-direct-mcp"],
        "environment": {
          "YANDEX_DIRECT_TOKEN": "<OAuth-токен>"
        }
      }
    }
  }
}

{
  "mcpServers": {
    "yandex-tools-mcp": {
      "command": "npx",
      "args": ["-y", "yandex-direct-mcp"],
      "env": {
        "YANDEX_DIRECT_TOKEN": "<OAuth-токен>"
      }
    }
  }
}

Вкладка Program → Install → Edit mcp.json. Подробно о LM Studio

{
  "mcpServers": {
    "yandex-tools-mcp": {
      "command": "npx",
      "args": ["-y", "yandex-direct-mcp"],
      "env": {
        "YANDEX_DIRECT_TOKEN": "<OAuth-токен>"
      }
    }
  }
}

Инструменты сервера

list-campaignsперечисляет кампании с бюджетами

create-campaignсоздаёт текстовую кампанию

manage-campaignостанавливает или архивирует кампанию

create-adgroupсоздаёт группу с регионами

create-text-adсоздаёт текстовое объявление

upload-ad-imageзагружает картинку

add-keywordsдобавляет ключевые фразы

set-bidsставит ставки в рублях

set-negative-keywordsзадаёт минус-фразы

get-reportстроит отчёт по статистике

get-balanceпоказывает баланс

get-regionsищет ID регионов

Показано 12 из 20.

Что попросить агента

«Покажи мои кампании в Директе и их бюджеты»Агент вызовет yd_campaigns_get, в yandex-direct-mcp — list-campaigns

«Создай в песочнице кампанию «<название>» с дневным бюджетом 500»В yandex-direct-mcp агент вызовет create-campaign, без YANDEX_DIRECT_LIVE=1 кампания уйдёт в песочницу

«Добавь эти ключевые фразы в группу <ID группы> и поставь ставки 15»Агент вызовет add-keywords и set-bids, в yandex-ads-mcp — yd_keywords_add и yd_keyword_bids_set

«Покажи клики, расход и CTR по кампаниям за прошлый месяц»Агент вызовет yd_report, в yandex-direct-mcp — get-report

«Проверь частотность запроса «<фраза>» и как она менялась за год»В yandex-ads-mcp агент вызовет yd_wordstat_top_requests и yd_wordstat_dynamics

Для каких задач

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

Показать клики, расход и CTR по кампаниям за прошлый месяц

Поднять или снизить ставки и поставить корректировки по устройствам и регионам

Проверить частотность и сезонность запросов через Wordstat

Загрузить сегмент из CRM в Яндекс Аудитории и построить похожую аудиторию

Ограничения

Сервер тратит реальные деньги: в yandex-ads-mcp включайте YD_READONLY=true или YD_CONFIRM=true для боевых кабинетов, у yandex-direct-mcp боевой режим включается только через YANDEX_DIRECT_LIVE=1

Для yandex-ads-mcp нужна одобренная заявка на доступ к API в настройках Директа, ответ приходит через несколько часов

Wordstat в yandex-ads-mcp работает через Yandex Cloud: нужен платёжный аккаунт с привязанной картой, а для токенов после 01.06.2026 ещё API-ключ сервисного аккаунта в YC_API_KEY

yandex-ads-mcp ставится клонированием репозитория и установкой зависимостей в venv; пути к python и server.py прописываются в конфиге вручную

Какую реализацию выбрать

Реализация	Кто делает	Звёзды	Запуск	Ключ	Инструменты	Обновлён
Yandex Ads MCP Server	Yurich-ru	50	локально	токен	152	4 октября 2026
yandex-direct-mcp	Seyka AI	70	локально	токен	20	28 октября 2026

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

Какой вариант выбрать?

yandex-ads-mcp закрывает весь цикл: 86 инструментов Директа, 43 для Метрики, 23 для Аудиторий и 5 для Wordstat. yandex-direct-mcp проще в установке через npx и держит 20 базовых инструментов для кампаний, объявлений, фраз, ставок и отчётов.

Как не слить бюджет на тестах?

yandex-direct-mcp по умолчанию работает в песочнице, боевой кабинет включается только переменной YANDEX_DIRECT_LIVE=1. В yandex-ads-mcp песочница включается через YD_SANDBOX=true, а YD_CONFIRM=true заставляет агента сначала показывать превью изменения.

Можно работать с несколькими кабинетами?

Да. В yandex-ads-mcp агентский логин передаётся аргументом client_login, отдельные кабинеты перечисляются в YD_DIRECT_TOKENS как логин:токен, а YD_ALLOWED_LOGINS ограничивает список. В yandex-direct-mcp логин клиента агентства задаётся в YANDEX_DIRECT_LOGIN.

Сколько ждать доступа к API Директа?

Заявку подают в Директе: Настройки → API → «Получить доступ к API», указав Client ID приложения. Одобрение обычно занимает несколько часов.

Работает ли сервер из России?

Оба сервера запускаются на вашем компьютере и работают с API Яндекса по вашему OAuth-токену; зарубежные аккаунты не нужны.

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

Как подключить

Что сделать до подключения

Конфиг для вашего клиента

Инструменты сервера

Как подключить

Что сделать до подключения

Конфиг для вашего клиента

Инструменты сервера

Что попросить агента

Для каких задач

Ограничения

Какую реализацию выбрать

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

Похожие серверы