MCP Яндекс Директа как HTTP-коннектор Claude

ya-direct-mcp

MCP-сервер Яндекс Директа на Streamable HTTP, разворачивается на Railway и подключается к Claude как пользовательский коннектор по секретному URL

  • 0 ★ репозитория
  • Последний коммит
MCP-сервер

Широкий доступ

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

  • Утечка MCP_SECRET дает полный доступ к аккаунту, включая необратимое удаление кампаний
  • Создает, приостанавливает и архивирует кампании, группы, объявления и ключевые фразы
Все причины и проверки
Российский стек

dmburov/ya-direct-mcp

Установка

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

npx skillfoxx add mcp/ya-direct-mcp

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

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

Доступ и проверки

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

Широкий доступИнструмент может менять данные, выполнять команды или работать с секретами.

  • Утечка MCP_SECRET дает полный доступ к аккаунту, включая необратимое удаление кампаний
  • Создает, приостанавливает и архивирует кампании, группы, объявления и ключевые фразы

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

Что делает

В отличие от большинства серверов Директа, работающих локально по stdio, этот развернут как облачный HTTP-эндпоинт и подключается в Claude через Settings, Connectors, Add custom connector, без локальной установки и без .mcp.json. Дает управление текстово-графическими кампаниями: список, карточка, создание, обновление, приостановка, возобновление, архивация и удаление кампаний, групп объявлений, объявлений и ключевых фраз, плюс отчет и баланс аккаунта. Все инструменты принимают необязательный client_login, что позволяет одним развернутым сервером обслуживать нескольких рекламодателей сразу. Авторизация клиента идет через собственный секрет MCP_SECRET, зашитый в путь URL или переданный заголовком, а OAuth-токен Директа живет только в окружении сервера на Railway и Claude его не видит.

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

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

  • Нужен MCP-сервер Директа, доступный из Claude без локального процесса на компьютере
  • Нужно обслуживать несколько рекламодателей одним развернутым сервером через client_login
  • Уже есть или не страшно завести аккаунт Railway для быстрого деплоя

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

  • Не хочется открывать эндпоинт в интернет: единственная защита: секрет MCP_SECRET в пути или заголовке
  • Нужна локальная установка по stdio без облачного хостинга
  • Нужна защита от случайного удаления на все методы: предохранитель есть только у delete_campaign

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

Покажи баланс аккаунта и приостанови кампании, у которых расход за неделю превысил 5000 рублей без конверсий

MCP

Транспорт
http
Авторизация
API-ключ

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

YD_TOKEN обязательная, секрет
OAuth-токен Яндекс Директа
YD_LOGIN обязательная
Логин рекламодателя по умолчанию
MCP_SECRET обязательная, секрет
Собственный секрет сервера для защиты HTTP-эндпоинта, не токен Яндекса

Ограничения

Эндпоинт открыт в интернет, единственная защита: секрет MCP_SECRET, его утечка означает полный доступ к рекламному аккаунту, включая удаление кампаний. Предохранитель с подтверждением точного имени есть только у delete_campaign, у остальных delete_* его нет, и удаление необратимо. Поддерживаются только текстово-графические кампании TEXT_CAMPAIGN, деплой рассчитан на Railway.

Как отключить. Удалите коннектор yandex-direct в настройках Claude и остановите или удалите сервис на Railway.

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

Что делать, если секрет утек?

Сменить MCP_SECRET в переменных Railway, сервис перезапустится сам, затем пересоздать коннектор в Claude с новым URL.

Все ли удаляющие методы защищены от опечатки?

Нет, только delete_campaign требует точного совпадения имени кампании с confirm_name, остальные delete_* выполняются без такой проверки.

Обсуждение

Вопросов и отзывов пока нет.

Российский стек

MCP-сервер Direct API v5 одним файлом на Node.js без зависимостей, с инструментом direct_call на все сервисы API и режимом только для чтения

MCP-серверШирокий доступ

Yandex Direct MCP

yandex-direct-mcp

Российский стек

Плагин Claude Code и Codex для Яндекс Директа: MCP-сервер на 147 инструментов, OAuth и скиллы для объявлений и анализа статистики

ПлагинШирокий доступ14Звезды репозитория
Российский стек

MCP-сервер на чистом Ruby без зависимостей: 30 инструментов для кампаний, групп, объявлений, ключевых слов и отчетов Яндекс Директа

MCP-серверШирокий доступ6Звезды репозитория
Российский стек

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

MCP-серверШирокий доступ
Российский стек

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

MCP-серверШирокий доступ2Звезды репозитория
Российский стек

20 инструментов Яндекс Директа, где каждая правка по умолчанию только показывает план запроса и требует confirm=True для реальной отправки

MCP-серверШирокий доступ

Коротко о README

README дает пошаговый деплой на Railway: New Project, переменные окружения, генерация публичного домена и проверка готовности через /health. Отдельно описано подключение как кастомного коннектора Claude по URL с секретом в пути или заголовке и раздел безопасности, честно называющий единственной защитой секрет MCP_SECRET и отмечающий, какой из delete-методов имеет предохранитель, а какие нет.

Бейдж для README

Сообщить о проблеме