MCP для Яндекс Аудиторий

A1 Яндекс Аудитории MCP

MCP-сервер Яндекс Аудиторий: сегменты из CRM, похожие аудитории, пиксели и доступы с входом через Яндекс прямо в чате

MCP-сервер

Высокий риск

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

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

  • Может безвозвратно удалить сегмент или изменить чужой доступ к нему
  • Загружает персональные данные из CRM: email, телефоны и хешированные идентификаторы
Все причины и проверки
Российский стек

a1-x-tech/mcp-yandex-audience

Установка

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

npx skillfoxx add mcp/a1-yandeks-auditorii-mcp

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

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

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

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

claude mcp add --transport stdio --env 'YANDEX_AUDIENCE_TOKEN=<ваш YANDEX_AUDIENCE_TOKEN>' mcp-yandex-audience -- npx -y mcp-yandex-audience@1.1.1

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

{
  "mcpServers": {
    "mcp-yandex-audience": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-yandex-audience@1.1.1"
      ],
      "env": {
        "YANDEX_AUDIENCE_TOKEN": "<ваш YANDEX_AUDIENCE_TOKEN>"
      }
    }
  }
}

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

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

YANDEX_AUDIENCE_TOKENсекрет, обязательная
Yandex OAuth token, sent as `Authorization: OAuth …`. Treat it as a secret.
YANDEX_AUDIENCE_API_HOSTнеобязательная
API host override (https://api-audience.yandex.com for international accounts).
YANDEX_AUDIENCE_TIMEOUT_MSнеобязательная
Per-request timeout in milliseconds.
YANDEX_AUDIENCE_MAX_RETRIESнеобязательная
Retries on 429 (5xx/network retried for GET only).

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

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

{
  "mcpServers": {
    "mcp-yandex-audience": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-yandex-audience@1.1.1"
      ],
      "env": {
        "YANDEX_AUDIENCE_TOKEN": "<ваш YANDEX_AUDIENCE_TOKEN>"
      }
    }
  }
}

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

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

YANDEX_AUDIENCE_TOKENсекрет, обязательная
Yandex OAuth token, sent as `Authorization: OAuth …`. Treat it as a secret.
YANDEX_AUDIENCE_API_HOSTнеобязательная
API host override (https://api-audience.yandex.com for international accounts).
YANDEX_AUDIENCE_TIMEOUT_MSнеобязательная
Per-request timeout in milliseconds.
YANDEX_AUDIENCE_MAX_RETRIESнеобязательная
Retries on 429 (5xx/network retried for GET only).

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

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

code --add-mcp '{"name":"mcp-yandex-audience","type":"stdio","command":"npx","args":["-y","mcp-yandex-audience@1.1.1"],"env":{"YANDEX_AUDIENCE_TOKEN":"<ваш YANDEX_AUDIENCE_TOKEN>"}}'

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

{
  "servers": {
    "mcp-yandex-audience": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "mcp-yandex-audience@1.1.1"
      ],
      "env": {
        "YANDEX_AUDIENCE_TOKEN": "<ваш YANDEX_AUDIENCE_TOKEN>"
      }
    }
  }
}

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

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

YANDEX_AUDIENCE_TOKENсекрет, обязательная
Yandex OAuth token, sent as `Authorization: OAuth …`. Treat it as a secret.
YANDEX_AUDIENCE_API_HOSTнеобязательная
API host override (https://api-audience.yandex.com for international accounts).
YANDEX_AUDIENCE_TIMEOUT_MSнеобязательная
Per-request timeout in milliseconds.
YANDEX_AUDIENCE_MAX_RETRIESнеобязательная
Retries on 429 (5xx/network retried for GET only).

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

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

codex mcp add mcp-yandex-audience --env 'YANDEX_AUDIENCE_TOKEN=<ваш YANDEX_AUDIENCE_TOKEN>' -- npx -y mcp-yandex-audience@1.1.1

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

[mcp_servers.mcp-yandex-audience]
command = "npx"
args = ["-y", "mcp-yandex-audience@1.1.1"]
env = { YANDEX_AUDIENCE_TOKEN = "<ваш YANDEX_AUDIENCE_TOKEN>" }

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

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

YANDEX_AUDIENCE_TOKENсекрет, обязательная
Yandex OAuth token, sent as `Authorization: OAuth …`. Treat it as a secret.
YANDEX_AUDIENCE_API_HOSTнеобязательная
API host override (https://api-audience.yandex.com for international accounts).
YANDEX_AUDIENCE_TIMEOUT_MSнеобязательная
Per-request timeout in milliseconds.
YANDEX_AUDIENCE_MAX_RETRIESнеобязательная
Retries on 429 (5xx/network retried for GET only).

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

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

{
  "mcpServers": {
    "mcp-yandex-audience": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-yandex-audience@1.1.1"
      ],
      "env": {
        "YANDEX_AUDIENCE_TOKEN": "<ваш YANDEX_AUDIENCE_TOKEN>"
      }
    }
  }
}

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

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

YANDEX_AUDIENCE_TOKENсекрет, обязательная
Yandex OAuth token, sent as `Authorization: OAuth …`. Treat it as a secret.
YANDEX_AUDIENCE_API_HOSTнеобязательная
API host override (https://api-audience.yandex.com for international accounts).
YANDEX_AUDIENCE_TIMEOUT_MSнеобязательная
Per-request timeout in milliseconds.
YANDEX_AUDIENCE_MAX_RETRIESнеобязательная
Retries on 429 (5xx/network retried for GET only).

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

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

{
  "mcpServers": {
    "mcp-yandex-audience": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-yandex-audience@1.1.1"
      ],
      "env": {
        "YANDEX_AUDIENCE_TOKEN": "<ваш YANDEX_AUDIENCE_TOKEN>"
      }
    }
  }
}

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

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

YANDEX_AUDIENCE_TOKENсекрет, обязательная
Yandex OAuth token, sent as `Authorization: OAuth …`. Treat it as a secret.
YANDEX_AUDIENCE_API_HOSTнеобязательная
API host override (https://api-audience.yandex.com for international accounts).
YANDEX_AUDIENCE_TIMEOUT_MSнеобязательная
Per-request timeout in milliseconds.
YANDEX_AUDIENCE_MAX_RETRIESнеобязательная
Retries on 429 (5xx/network retried for GET only).

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

Бывший Windsurf.

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

{
  "mcpServers": {
    "mcp-yandex-audience": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-yandex-audience@1.1.1"
      ],
      "env": {
        "YANDEX_AUDIENCE_TOKEN": "<ваш YANDEX_AUDIENCE_TOKEN>"
      }
    }
  }
}

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

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

YANDEX_AUDIENCE_TOKENсекрет, обязательная
Yandex OAuth token, sent as `Authorization: OAuth …`. Treat it as a secret.
YANDEX_AUDIENCE_API_HOSTнеобязательная
API host override (https://api-audience.yandex.com for international accounts).
YANDEX_AUDIENCE_TIMEOUT_MSнеобязательная
Per-request timeout in milliseconds.
YANDEX_AUDIENCE_MAX_RETRIESнеобязательная
Retries on 429 (5xx/network retried for GET only).

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

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

{
  "mcpServers": {
    "mcp-yandex-audience": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-yandex-audience@1.1.1"
      ],
      "env": {
        "YANDEX_AUDIENCE_TOKEN": "<ваш YANDEX_AUDIENCE_TOKEN>"
      }
    }
  }
}

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

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

YANDEX_AUDIENCE_TOKENсекрет, обязательная
Yandex OAuth token, sent as `Authorization: OAuth …`. Treat it as a secret.
YANDEX_AUDIENCE_API_HOSTнеобязательная
API host override (https://api-audience.yandex.com for international accounts).
YANDEX_AUDIENCE_TIMEOUT_MSнеобязательная
Per-request timeout in milliseconds.
YANDEX_AUDIENCE_MAX_RETRIESнеобязательная
Retries on 429 (5xx/network retried for GET only).

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

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

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

{
  "mcp": {
    "mcp-yandex-audience": {
      "type": "local",
      "command": [
        "npx",
        "-y",
        "mcp-yandex-audience@1.1.1"
      ],
      "environment": {
        "YANDEX_AUDIENCE_TOKEN": "<ваш YANDEX_AUDIENCE_TOKEN>"
      }
    }
  }
}

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

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

YANDEX_AUDIENCE_TOKENсекрет, обязательная
Yandex OAuth token, sent as `Authorization: OAuth …`. Treat it as a secret.
YANDEX_AUDIENCE_API_HOSTнеобязательная
API host override (https://api-audience.yandex.com for international accounts).
YANDEX_AUDIENCE_TIMEOUT_MSнеобязательная
Per-request timeout in milliseconds.
YANDEX_AUDIENCE_MAX_RETRIESнеобязательная
Retries on 429 (5xx/network retried for GET only).

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

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

{
  "context_servers": {
    "mcp-yandex-audience": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-yandex-audience@1.1.1"
      ],
      "env": {
        "YANDEX_AUDIENCE_TOKEN": "<ваш YANDEX_AUDIENCE_TOKEN>"
      }
    }
  }
}

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

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

YANDEX_AUDIENCE_TOKENсекрет, обязательная
Yandex OAuth token, sent as `Authorization: OAuth …`. Treat it as a secret.
YANDEX_AUDIENCE_API_HOSTнеобязательная
API host override (https://api-audience.yandex.com for international accounts).
YANDEX_AUDIENCE_TIMEOUT_MSнеобязательная
Per-request timeout in milliseconds.
YANDEX_AUDIENCE_MAX_RETRIESнеобязательная
Retries on 429 (5xx/network retried for GET only).

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

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

{
  "mcpServers": {
    "mcp-yandex-audience": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-yandex-audience@1.1.1"
      ],
      "env": {
        "YANDEX_AUDIENCE_TOKEN": "<ваш YANDEX_AUDIENCE_TOKEN>"
      }
    }
  }
}

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

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

YANDEX_AUDIENCE_TOKENсекрет, обязательная
Yandex OAuth token, sent as `Authorization: OAuth …`. Treat it as a secret.
YANDEX_AUDIENCE_API_HOSTнеобязательная
API host override (https://api-audience.yandex.com for international accounts).
YANDEX_AUDIENCE_TIMEOUT_MSнеобязательная
Per-request timeout in milliseconds.
YANDEX_AUDIENCE_MAX_RETRIESнеобязательная
Retries on 429 (5xx/network retried for GET only).

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

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

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

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

Подключи сервер: claude mcp add --transport stdio --scope user yandex-audience -- npx -y mcp-yandex-audience@latest, затем в чате напиши «подключи Яндекс Аудитории» и пройди вход через Яндекс.

Другие способы из описания автора
claude mcp add --transport stdio --scope user yandex-audience -- npx -y mcp-yandex-audience@latest

Токен не нужен заранее, вход в Яндекс проходит в диалоге после подключения.

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

Что делает

Сервер дает агенту 20 инструментов для сегментов, пикселей и доступов Яндекс Аудиторий. Подключение аккаунта проходит прямо в диалоге через OAuth с PKCE: Яндекс присылает одноразовый код, токен сохраняется локально с правами только владельца и обновляется сам. Агент может посмотреть сегменты и пиксели с их охватами, загрузить CRM-файл с email, телефонами или хешированными идентификаторами как сегмент в два шага, собрать похожую или пиксельную аудиторию, выдать или отозвать доступ коллеге. Загрузка сегмента и подтверждение параметров разделены: обработка запускается только после явного второго шага. Инструмент raw_request открывает прямой доступ к остальным методам API для технических операций вроде восстановления пикселя.

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

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

  • Нужно посмотреть, какие сегменты и пиксели уже есть в аккаунте и их статусы
  • Нужно загрузить список клиентов из CRM как новый сегмент
  • Нужно собрать похожую аудиторию на основе существующего сегмента или выдать доступ агентству

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

  • Нужно управлять рекламными кампаниями и ставками в Яндекс Директе: этот сервер туда не ходит
  • Сегмент меньше 100 записей: Аудитории не примут его в Директ без роста объема
  • Нужны данные с MD5-хешами: API принимает только SHA256

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

Загрузи buyers.csv как сегмент «Покупатели 2026» и покажи его параметры перед запуском обработки

Ограничения

Удаление сегмента необратимо, восстановление пикселя возможно только через raw_request отдельным методом API. Минимум 100 записей и максимум 1 ГБ на сегмент. Квоты: 30 запросов в секунду с IP, 5000 в сутки на логин, создание и изменение сегментов ограничено 10 в минуту, 100 в час, 500 в сутки. Сервер не объединяет загрузку и подтверждение сегмента в один вызов и не повторяет операции записи автоматически при сбое.

Как отключить. Напишите агенту «отключи Аудитории» или удалите блок yandex-audience из конфигурации клиента, затем отзовите доступ в Яндекс ID.

MCP

Транспорт
stdio
Авторизация
OAuth
Переменные окружения
Переменные окружения
YANDEX_AUDIENCE_TOKEN
секрет
Готовый OAuth-токен для CI, имеет приоритет над входом в чате
YANDEX_AUDIENCE_OAUTH_CLIENT_ID
Client ID собственного OAuth-приложения вместо приложения A1-x-Tech
ASKADS_TELEMETRY
Значение 0 отключает анонимную телеметрию использования

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

  • Может безвозвратно удалить сегмент или изменить чужой доступ к нему
  • Загружает персональные данные из CRM: email, телефоны и хешированные идентификаторы

Коротко о README

README подробно описывает поток OAuth с PKCE прямо в чате, таблицу «Что может изменить данные» с явной отметкой необратимых действий, готовые инструкции для Codex, Claude Code, Claude Desktop, Cursor и VS Code и раздел про анонимную телеметрию, отключаемую переменной ASKADS_TELEMETRY. Отдельно расписаны форматы CRM-файлов, ограничение в 100 записей и квоты API Яндекс Аудиторий.

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

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

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

Что произойдет при удалении сегмента?

Удаление необратимо. Для пикселя восстановление возможно отдельным методом API через raw_request.

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

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

СкиллНизкий рискБез VPN52,7 тыс.Звезды репозитория
Выбор редакции

Около пятидесяти скиллов по CRO, копирайтингу, SEO, аналитике, рекламе и запуску продукта для кодовых агентов

СкиллНизкий риск51,8 тыс.Звезды репозитория
Официальный

Официальный удаленный MCP-сервер SendPulse: статистика, рассылки и данные пользователей через чат с агентом

MCP-серверВысокий рискРоссийский стек1Звезды репозитория
Выбор редакции

MCP-сервер и CLI на всех 113 методах API v5 Яндекс Директа, собранных из WSDL: по умолчанию только 9 читающих, запись включается явно

MCP-серверВысокий рискРоссийский стекБез VPN1Звезды репозитория
Foxx AIMCP для Яндекс Аудиторий

Я Foxx AI и уже разобрал этот инструмент. Спросите про установку, настройку или что угодно еще, отвечу простыми словами.