yandex-direct-mcp: Instructions file for Codex

Инструкция для ИИ-агента: установить yandex-direct-mcp

Скопируйте этот файл целиком агенту (Claude / Cursor / ChatGPT Desktop / Antigravity / Grok), если пользователь дал страницу блога или репозиторий.

Цель

Развернуть open-source MCP-сервер Яндекс Директ (yandex-direct-mcp) на машине пользователя и подключить к его AI-клиенту. Сервер даёт ~80 tools: кампании, ключи, объявления, РСЯ exclude, бюджеты, SQ-отчёты, автотаргетинг, max-conv, видео-расширения, dry-run write.

Предусловия

• Node.js ≥ 18 (node -v)
• OAuth-токен Яндекс Директ (приложение + доступ к кабинету)
• Права писать конфиг AI-клиента

Шаги (выполни сам)

1. Клон

   git clone https://github.com/gmen1057/yandex-direct-mcp.git
   cd yandex-direct-mcp
   npm install
   

2. Секреты

   cp .env.example .env
   # Запиши YANDEX_DIRECT_TOKEN=...
   chmod 600 .env
   

   Токен: https://yandex.ru/dev/direct/doc/dg/concepts/auth-token.html
   Если токен агентский — YANDEX_DIRECT_CLIENT_LOGIN=login_рекламодателя.

3. Разметка брендов — отредактируй projects.json:

   • ключи brand, brand2 → свои имена
   • name_prefixes: префиксы в названии кампаний, напр. "[shop]"
   • campaign_ids: явные Id кампаний

4. Smoke

   npm run smoke
   

   Ожидай registered 80 tools и при наличии токена — live ping.

5. Подключи MCP (выбери клиент пользователя):

Claude Desktop (macOS/Windows)

Файл:

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "yandex-direct": {
      "command": "node",
      "args": ["/АБСОЛЮТНЫЙ/ПУТЬ/yandex-direct-mcp/index.mjs"],
      "env": {
        "YANDEX_DIRECT_TOKEN": "ТОКЕН"
      }
    }
  }
}

Перезапусти Claude Desktop.

Cursor

Settings → MCP → Add server, или .cursor/mcp.json / ~/.cursor/mcp.json:

{
  "mcpServers": {
    "yandex-direct": {
      "command": "node",
      "args": ["/АБСОЛЮТНЫЙ/ПУТЬ/yandex-direct-mcp/index.mjs"],
      "env": { "YANDEX_DIRECT_TOKEN": "ТОКЕН" }
    }
  }
}