Yandex Direct MCP Server

Режимы подключения

Режим определяется заголовками запроса — сервер универсальный, флаги запуска не нужны.

👤

Прямой рекламодатель

Токен принадлежит рекламодателю напрямую. Никаких дополнительных заголовков не нужно.

🏢

Агентство · один клиент

Агентский токен, жёстко привязанный к одному рекламодателю через заголовок X-Client-Login.

🔀

Агентство · любой клиент

Агентский токен, рекламодатель передаётся в каждом вызове инструмента через X-Client-Login: *.

Конфигурация клиента

Скопируйте нужный конфиг в ~/.claude.json (Claude Code) или .mcp.json (проект).

      
      
      
      
    

        JSON-конфиг
        
      
{
  "mcpServers": {
    "yandex-direct": {
      "type": "http",
      "url":  "https://yandex-direct-mcp.webtm.ru/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_ADVERTISER_TOKEN"
      }
    }
  }
}

        JSON-конфиг
        
      
{
  "mcpServers": {
    "yandex-direct": {
      "type": "http",
      "url":  "https://yandex-direct-mcp.webtm.ru/mcp",
      "headers": {
        "Authorization":  "Bearer YOUR_AGENCY_TOKEN",
        "X-Client-Login": "advertiser-login"
      }
    }
  }
}

        JSON-конфиг
        
      
{
  "mcpServers": {
    "yandex-direct": {
      "type": "http",
      "url":  "https://yandex-direct-mcp.webtm.ru/mcp",
      "headers": {
        "Authorization":  "Bearer YOUR_AGENCY_TOKEN",
        "X-Client-Login": "*"
        // client_login передаётся в каждом вызове инструмента
      }
    }
  }
}

        JSON-конфиг — агентские юниты
        
      
{
  "mcpServers": {
    "yandex-direct": {
      "type": "http",
      "url":  "https://yandex-direct-mcp.webtm.ru/mcp",
      "headers": {
        "Authorization":       "Bearer YOUR_AGENCY_TOKEN",
        "X-Client-Login":     "advertiser-login",
        "Use-Operator-Units": "true"
        // API-юниты списываются с агентского аккаунта
      }
    }
  }
}

Быстрое подключение через CLI

Если используете Claude Code, можно добавить сервер одной командой.

Terminal

# Прямой рекламодатель
claude mcp add --transport http yandex-direct \
  https://yandex-direct-mcp.webtm.ru/mcp \
  --header "Authorization: Bearer YOUR_TOKEN"

# Агентство, один клиент
claude mcp add --transport http yandex-direct \
  https://yandex-direct-mcp.webtm.ru/mcp \
  --header "Authorization: Bearer YOUR_AGENCY_TOKEN" \
  --header "X-Client-Login: advertiser-login"

Заголовки запроса

Все заголовки устанавливаются в конфиге клиента один раз и применяются к каждому запросу.

Заголовок	Обязателен	Значение	Описание
`Authorization`	Да	`Bearer <token>`	OAuth-токен Yandex Direct
`X-Client-Login`	Агентство	Логин клиента или `*`	Конкретный логин — фиксирует клиента. Звёздочка `*` — клиент передаётся в каждом вызове инструмента.
`Use-Operator-Units`	Нет	`true`	Списывать API-юниты с агентского аккаунта вместо клиентского.

Где хранятся конфиги

Конфиг можно положить глобально или на уровне проекта.

Клиент	Путь	Область
Claude Code	`~/.claude.json`	Все проекты
Claude Code	`.mcp.json` в корне проекта	Один проект (можно коммитить)
Claude Desktop	`~/Library/Application Support/Claude/claude_desktop_config.json`	macOS, все проекты
Claude Desktop	`%APPDATA%\Claude\claude_desktop_config.json`	Windows, все проекты
Cursor	`~/.cursor/mcp.json`	Все проекты
Cursor	`.cursor/mcp.json` в корне проекта	Один проект

Yandex DirectMCP Server