Yandex Audience MCP

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

A1 Яндекс Аудитории MCP подключает AI-приложение к сегментам, пикселям и доступам Яндекс Аудиторий. Попросите на естественном языке показать, что уже есть в аккаунте, подготовить сегмент из CRM, собрать похожую аудиторию или выдать доступ коллегам — ассистент выполнит это через ваш аккаунт. Подключение начинается прямо в диалоге: не нужно заранее создавать токен или редактировать конфигурацию.

• 20 инструментов. Сегменты, пиксели, доступы, подключение аккаунта и дополнительный прямой вызов API.
• Подключение в чате. Яндекс откроет страницу входа; одноразовый код действует 10 минут, а сервер проверит доступ к сегментам сразу после подключения.
• CRM и идентификаторы. CSV с email и телефонами, а также TSV/TXT с device ID, MAC-адресами или SHA256-хешами.
• Два шага для сегмента из файла. Сначала загрузка, затем отдельное подтверждение параметров и запуск обработки.
• Без глобальной установки. Пакет запускается через npx на Node.js 20+ и подключается к AI-клиенту по stdio.

Попробуйте первым сообщением:

Покажи мои сегменты в Яндекс Аудиториях: названия, типы и текущие статусы.

Подключить сервер · Посмотреть сценарии · Открыть техническую документацию

---

Увидеть работу за минуту

Вы: Подключи Яндекс Аудитории.

Ассистент: Даёт ссылку на вход в Яндекс. Откройте её под аккаунтом, которому принадлежат нужные сегменты (или которому они доверены), подтвердите доступ и пришлите показанный код.

Вы: Отправляет код со страницы Яндекса.

Ассистент: Подключает Аудитории, проверяет, видны ли сегменты, и сообщает результат. Перезапускать приложение не нужно.

Вы: Загрузи buyers.csv как CRM-сегмент «Покупатели 2026» и остановись после загрузки.

Ассистент: Загружает файл — в аккаунте появляется сегмент со статусом uploaded, показывает его id, имя и параметры и ждёт отдельного подтверждения. После подтверждения обработка идёт не мгновенно, поэтому статус проверяется через список сегментов.

Содержание

• Быстрый старт
• Что можно поручить
• Как это работает
• Что может изменить данные
• Подключение и настройка
• Данные и телеметрия
• Ограничения
• Техническая документация
• Поддержка

Быстрый старт

Нужны Node.js 20 или новее и аккаунт Яндекс Аудиторий. Сервер запускается через npx, поэтому отдельно устанавливать пакет не требуется. Токен заранее не нужен — подключение проходит прямо в диалоге; для CI можно задать готовый токен, см. Подключение и настройка.

1. Добавьте сервер в AI-приложение — ниже открыт пример для Codex, остальные приложения собраны в сворачиваемые инструкции.
2. Напишите: «Подключи Яндекс Аудитории». Ассистент проведёт через вход в Яндекс и проверит доступ к сегментам.
3. Начните с безопасного запроса, например: «Покажи мои сегменты в Яндекс Аудиториях: названия, типы и текущие статусы».

Codex

Через интерфейс приложения:

1. Откройте Settings → MCP servers.
2. Нажмите Add server.
3. Выберите STDIO, затем укажите команду запуска npx -y mcp-yandex-audience@latest.

1. Нажмите Save, затем Restart.

Через командную строку:

codex mcp add yandex-audience -- npx -y mcp-yandex-audience@latest

Проверьте подключение:

codex mcp list

Затем в чате Codex попросите: «Подключи Яндекс Аудитории».

Официальная инструкция Codex

Claude Code

claude mcp add --transport stdio --scope user yandex-audience -- npx -y mcp-yandex-audience@latest

Проверьте подключение:

claude mcp list

Затем начните диалог с просьбы подключить Яндекс Аудитории.

Официальная инструкция Claude Code

Claude Desktop

Актуальный официальный путь — Settings → Extensions. Для пользовательского desktop extension откройте Advanced settings → Extension Developer → Install Extension…, выберите файл .mcpb и следуйте подсказкам.

Этот репозиторий сейчас публикует npm-пакет со stdio и пока не содержит .mcpb. Поэтому используйте приведённый ниже JSON stdio-конфиг как fallback только в сборках Claude Desktop, где ещё поддерживается локальная конфигурация:

{

"mcpServers": { "yandex-audience": { "command": "npx", "args": ["-y", "mcp-yandex-audience@latest"] } } }

В таких сборках сохраните его в ~/Library/Application Support/Claude/claude_desktop_config.json на macOS или %APPDATA%\Claude\claude_desktop_config.json на Windows.

После сохранения откройте новый диалог и попросите подключить Яндекс Аудитории.

Официальная инструкция Claude Desktop

Cursor

Пользовательский локальный сервер добавляется в Cursor через файл mcp.json:

• macOS и Linux: ~/.cursor/mcp.json
• Windows: %USERPROFILE%\.cursor\mcp.json

{

"mcpServers": { "yandex-audience": { "type": "stdio", "command": "npx", "args": ["-y", "mcp-yandex-audience@latest"] } } }

В чате Cursor сервер появится среди доступных инструментов. Попросите подключить Яндекс Аудитории и пройдите вход через Яндекс.

Официальная инструкция Cursor

VS Code

Откройте палитру команд и выполните MCP: Open User Configuration. VS Code создаст пользовательский файл MCP. Добавьте в него:

{

"servers": { "yandex-audience": { "type": "stdio", "command": "npx", "args": ["-y", "mcp-yandex-audience@latest"] } } }

Проверьте запуск командой MCP: List Servers, затем откройте чат и попросите подключить Яндекс Аудитории.

Официальная инструкция VS Code

Что можно поручить

Проверить, что уже есть в аккаунте

• Посмотреть сегменты, их типы, статусы и идентификаторы.
• Найти сегменты, которые ещё обрабатываются, завершились ошибкой или содержат недостаточно данных.
• Посмотреть пиксели, их охваты за 7, 30 и 90 дней, а также сегменты, созданные на их основе.
• Узнать, кому выдан доступ к конкретному сегменту.

Подготовить сегмент из CRM

• Загрузить CSV с колонками email, phone, ext_id или external_id.
• Загрузить TSV/TXT с идентификаторами устройств, MAC-адресами или SHA256-хешами.
• Проверить параметры загруженного сегмента перед подтверждением.
• Сохранить сегмент с нужным именем и типом данных, затем проверить ход обработки.

Собрать новую аудиторию

• Создать похожую аудиторию на основе существующего сегмента: от более похожей и узкой до более широкой.
• Собрать сегмент посетителей по пикселю за период от 1 до 90 дней.
• Добавить к пиксельному сегменту условия по числу срабатываний и UTM-меткам.

Работать с пикселями и доступами

• Создать или переименовать пиксель.
• Выдать коллеге или агентству доступ к сегменту: только просмотр или редактирование.
• Отозвать доступ, когда он больше не нужен.

Использовать дополнительные возможности API

raw_request нужен для операций, у которых пока нет отдельного инструмента: например, повторной обработки сегмента или восстановления пикселя. Это инструмент для технических специалистов: он может выполнить запись или удаление, поэтому для обычных задач лучше использовать отдельные команды выше.

Полные входные параметры, ответы и статусы собраны в справочнике инструментов.

Как это работает

Сервер работает с тремя сущностями Яндекс Аудиторий:

Сегмент из файла создаётся в два шага:

1. Вы передаёте CSV, TSV или TXT-файл — путь к локальному файлу или его содержимое, но не оба источника одновременно. Сервер загружает файл в Яндекс Аудитории, и в аккаунте появляется объект со статусом uploaded.
2. Отдельной командой вы подтверждаете имя, тип данных и параметры обработки. Только после этого Яндекс Аудитории начинают обработку.

Готовность появляется не мгновенно: сервер проверяет статус через список сегментов, где возможны состояния обработки, ошибки или недостаточного объёма данных. Для CRM используйте CSV с заголовками email, phone, ext_id или external_id. Для хешированных данных API принимает SHA256; MD5 не поддерживается.

Сервер не управляет рекламными кампаниями, ставками и объявлениями в Яндекс Директе. Готовый сегмент подключается к кампании вне этого MCP-сервера.

Что может изменить данные

Яндекс Аудитории — API с операциями записи. MCP-сервер передаёт AI-клиенту информацию о том, какие инструменты читают, изменяют или удаляют данные, но правила подтверждения задаёт само AI-приложение.

Сервер не объединяет загрузку файла и подтверждение в один скрытый вызов. При сетевой ошибке или ответе сервера 5xx он не повторяет операции записи автоматически: операция могла уже выполниться. В такой ситуации сначала проверьте состояние через список сегментов, пикселей или доступов.

Подключение и настройка

Для обычного использования токен заранее не нужен:

1. В чате попросите подключить Яндекс Аудитории.
2. Откройте ссылку на Яндекс OAuth под аккаунтом, которому принадлежат нужные сегменты (или которому они доверены).
3. Подтвердите доступ и пришлите код ассистенту. Он одноразовый, действует 10 минут и меняется на токен только внутри работающего сервера.

Сервер использует PKCE: код из чата сам по себе нельзя обменять на токен. Полученный токен хранится локально в ~/.config/mcp-yandex-audience/credentials.json с правами только для владельца, а доступ продлевается автоматически. Сервер просит два права — чтение и изменение сегментов Аудиторий; кампании, объявления и остальные сервисы Яндекса ему недоступны.

Проверить состояние — попросите «покажи статус подключения к Аудиториям», отключить — «отк