A1-x-Tech/mcp-yandex-audience

**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.
4. Нажмите **Save**, затем **Restart**.
**Через командную строку:**
Проверьте подключение:
Затем в чате Codex попросите: «Подключи Яндекс Аудитории».
Официальная инструкция Codex
Claude Code
Проверьте подключение:
Затем начните диалог с просьбы подключить Яндекс Аудитории.
Официальная инструкция Claude Code
Claude Desktop
Актуальный официальный путь — **Settings → Extensions**. Для пользовательского desktop extension откройте **Advanced settings → Extension Developer → Install Extension…**, выберите файл .mcpb и следуйте подсказкам.
Этот репозиторий сейчас публикует npm-пакет со stdio и пока не содержит .mcpb. Поэтому используйте приведённый ниже JSON stdio-конфиг как fallback только в сборках Claude Desktop, где ещё поддерживается локальная конфигурация:
В таких сборках сохраните его в ~/Library/Application Support/Claude/claude_desktop_config.json на macOS или %APPDATA%\Claude\claude_desktop_config.json на Windows.
После сохранения откройте новый диалог и попросите подключить Яндекс Аудитории.