Power your agent
คำสั่งของผู้เผยแพร่เอง ไม่ใช่เอนด์พอยต์ของ PlugMCP
Host a copy with our keys and logs.
npx -y [email protected]Claude Code ไม่มีลิงก์ติดตั้งสำหรับคำสั่งแบบโลคัล ให้คัดลอกคำสั่งด้านล่างแล้วรันในเทอร์มินัล
YANDEX_AUDIENCE_TOKEN=<secret> YANDEX_AUDIENCE_API_HOST=<value> YANDEX_AUDIENCE_TIMEOUT_MS=<value> YANDEX_AUDIENCE_MAX_RETRIES=<value> claude mcp add io.github.a1-x-tech-mcp-yandex-audience -- npx -y mcp-yandex-audience@1.2.1รันในเทอร์มินัล
{ "mcpServers": { "io.github.a1-x-tech-mcp-yandex-audience": { "command": "npx", "args": [ "-y", "[email protected]" ], "env": { "YANDEX_AUDIENCE_TOKEN": "<secret>", "YANDEX_AUDIENCE_API_HOST": "<value>", "YANDEX_AUDIENCE_TIMEOUT_MS": "<value>", "YANDEX_AUDIENCE_MAX_RETRIES": "<value>" } } }}claude_desktop_config.json
URL แบบรีโมตหรือคำสั่งบนเครื่องของคุณ? การติดตั้งสองแบบต่างกันอย่างไร
รันบน PlugMCP
A new server you create. It is not this listing's official endpoint. Use the publisher install when you want their URL and their credentials.
เปิดA1 Яндекс Аудитории MCP подключает AI-приложение к сегментам, пикселям и доступам Яндекс Аудиторий. Попросите на естественном языке показать, что уже есть в аккаунте, подготовить сегмент из CRM, собрать похожую аудиторию или выдать доступ коллегам — ассистент выполнит это через ваш аккаунт. Подключение начинается прямо в диалоге: не нужно заранее создавать токен или редактировать конфигурацию.
npx на Node.js 20+ и подключается к AI-клиенту по stdio.Попробуйте первым сообщением:
Покажи мои сегменты в Яндекс Аудиториях: названия, типы и текущие статусы.
Вы: Подключи Яндекс Аудитории.
Ассистент: Даёт ссылку на вход в Яндекс. Откройте её под аккаунтом, которому принадлежат нужные сегменты (или которому они доверены), подтвердите доступ и пришлите показанный код.
Вы: Отправляет код со страницы Яндекса.
Ассистент: Подключает Аудитории, проверяет, видны ли сегменты, и сообщает результат. Перезапускать приложение не нужно.
Вы: Загрузи
buyers.csvкак CRM-сегмент «Покупатели 2026» и остановись после загрузки.Ассистент: Загружает файл — в аккаунте появляется сегмент со статусом
uploaded, показывает его id, имя и параметры и ждёт отдельного подтверждения. После подтверждения обработка идёт не мгновенно, поэтому статус проверяется через список сегментов.
Нужны Node.js 20 или новее и аккаунт Яндекс Аудиторий. Сервер запускается через npx, поэтому отдельно устанавливать пакет не требуется. Токен заранее не нужен — подключение проходит прямо в диалоге; для CI можно задать готовый токен, см. Подключение и настройка.
Через интерфейс приложения:
Откройте Settings → MCP servers.
Нажмите Add server.
Выберите STDIO, затем укажите команду запуска npx -y mcp-yandex-audience@latest.
Нажмите Save, затем Restart.
Через командную строку:
codex mcp add yandex-audience -- npx -y mcp-yandex-audience@latest
Проверьте подключение:
codex mcp list
Затем в чате Codex попросите: «Подключи Яндекс Аудитории».
claude mcp add --transport stdio --scope user yandex-audience -- npx -y mcp-yandex-audience@latest
Проверьте подключение:
claude mcp list
Затем начните диалог с просьбы подключить Яндекс Аудитории.
Актуальный официальный путь — 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.
После сохранения откройте новый диалог и попросите подключить Яндекс Аудитории.
Пользовательский локальный сервер добавляется в Cursor через файл mcp.json:
~/.cursor/mcp.json%USERPROFILE%\.cursor\mcp.json{
"mcpServers": {
"yandex-audience": {
"type": "stdio",
"command": "npx",
"args": ["-y", "mcp-yandex-audience@latest"]
}
}
}
В чате Cursor сервер появится среди доступных инструментов. Попросите подключить Яндекс Аудитории и пройдите вход через Яндекс.
Откройте палитру команд и выполните MCP: Open User Configuration. VS Code создаст пользовательский файл MCP. Добавьте в него:
{
"servers": {
"yandex-audience": {
"type": "stdio",
"command": "npx",
"args": ["-y", "mcp-yandex-audience@latest"]
}
}
}
Проверьте запуск командой MCP: List Servers, затем откройте чат и попросите подключить Яндекс Аудитории.
email, phone, ext_id или external_id.raw_request нужен для операций, у которых пока нет отдельного инструмента: например, повторной обработки сегмента или восстановления пикселя. Это инструмент для технических специалистов: он может выполнить запись или удаление, поэтому для обычных задач лучше использовать отдельные команды выше.
Полные входные параметры, ответы и статусы собраны в справочнике инструментов.
Сервер работает с тремя сущностями Яндекс Аудиторий:
Сегмент из файла создаётся в два шага:
uploaded.Готовность появляется не мгновенно: сервер проверяет статус через список сегментов, где возможны состояния обработки, ошибки или недостаточного объёма данных. Для CRM используйте CSV с заголовками email, phone, ext_id или external_id. Для хешированных данных API принимает SHA256; MD5 не поддерживается.
Сервер не управляет рекламными кампаниями, ставками и объявлениями в Яндекс Директе. Готовый сегмент подключается к кампании вне этого MCP-сервера.
Яндекс Аудитории — API с операциями записи. MCP-сервер передаёт AI-клиенту информацию о том, какие инструменты читают, изменяют или удаляют данные, но правила подтверждения задаёт само AI-приложение.
Сервер не объединяет загрузку файла и подтверждение в один скрытый вызов. При сетевой ошибке или ответе сервера 5xx он не повторяет операции записи автоматически: операция могла уже выполниться. В такой ситуации сначала проверьте состояние через список сегментов, пикселей или доступов.
Для обычного использования токен заранее не нужен:
Сервер использует PKCE: код из чата сам по себе нельзя обменять на токен. Полученный токен хранится локально в ~/.config/mcp-yandex-audience/credentials.json с правами только для владельца, а доступ продлевается автоматически. Сервер просит два права — чтение и изменение сегментов Аудиторий; кампании, объявления и остальные сервисы Яндекса ему недоступны.
Проверить состояние — попросите «покажи статус подключения к Аудиториям», отключить — «отключи Аудитории». Выданный приложению доступ отзывается в Яндекс ID.
Для CI и нестандартных установок доступна настройка через переменные окружения:
Готовый токен для YANDEX_AUDIENCE_TOKEN можно получить через собственное OAuth-приложение:
YANDEX_AUDIENCE_TOKEN.Токен привязан к аккаунту Яндекса: сервер увидит только собственные и доверенные сегменты владельца токена. Такой токен хранится открытым текстом в конфигурации AI-клиента — относитесь к нему как к паролю и не добавляйте конфигурацию с реальным токеном в Git. Подробнее — в официальной документации по авторизации API Яндекс Аудиторий.
Сервер запускается на вашей машине и обращается к api-audience.yandex.ru напрямую. OAuth-токен добавляется только к запросам Audience API — даже raw_request принимает относительный путь, а переход на посторонний хост блокируется. При входе из диалога сервер дополнительно ходит на oauth.yandex.ru, чтобы обменять код подтверждения и продлевать доступ; при загрузке через file_path читает указанный локальный файл и передаёт его в Яндекс Аудитории.
По умолчанию сервер отправляет на usage.gistrec.cloud анонимную техническую телеметрию: запуск сервера (в том числе без настроенного токена), имя вызванного инструмента и код причины проблемы с конфигурацией — вместе со случайным идентификатором установки, версией пакета, именем и версией AI-клиента, версией Node.js и операционной системой. OAuth-токен, данные аккаунта, содержимое файлов, аргументы инструментов и тексты запросов не читаются и не отправляются. Отправка выполняется в фоне с таймаутом 2 секунды и не влияет на работу сервера; реализация находится в src/telemetry.ts.
Чтобы отключить телеметрию, задайте переменную окружения:
ASKADS_TELEMETRY=0
raw_request.check_size: false, но такой сегмент нельзя использовать в Директе, пока размер не вырастет.YANDEX_AUDIENCE_MAX_RETRIES; ответ 429 не означает, что нужно создавать объект заново.mcp-yandex-audience.Нашли ошибку или не хватает сценария? Создайте issue или напишите в Telegram.
MCP server for Yandex Audience API: segments (CRM, lookalike, pixel), pixels, grants.
{ "mcpServers": { "io.github.a1-x-tech-mcp-yandex-audience": { "command": "npx", "args": [ "-y", "[email protected]" ], "env": { "YANDEX_AUDIENCE_TOKEN": "<secret>", "YANDEX_AUDIENCE_API_HOST": "<value>", "YANDEX_AUDIENCE_TIMEOUT_MS": "<value>", "YANDEX_AUDIENCE_MAX_RETRIES": "<value>" } } }}เครื่องมือ
ยังไม่มีรายการเครื่องมือ เซิร์ฟเวอร์แบบรีโมตจะได้รายการหลังการตรวจสอบสถานะครั้งแรก
FAQ
คัดลอกคอนฟิก stdio สำหรับ Cursor, Claude Desktop, Claude Code หรือ VS Code ได้ในหน้านี้ คอนฟิกนี้ใช้การติดตั้งของผู้เผยแพร่ ไม่ใช่พร็อกซีของ PlugMCP
ผู้เผยแพร่ระบุตัวแปรสภาพแวดล้อมเหล่านี้: YANDEX_AUDIENCE_TOKEN, YANDEX_AUDIENCE_API_HOST, YANDEX_AUDIENCE_TIMEOUT_MS, YANDEX_AUDIENCE_MAX_RETRIES
Yandex Audience MCP ทำงานแบบโลคัลผ่าน stdio
ตรวจสอบล่าสุดเมื่อ 2026-11-08 MCP server for Yandex Audience API: segments (CRM, lookalike, pixel), pixels, grants.