How do I install Avito Ads MCP?

Copy the stdio config for Cursor, Claude Desktop, Claude Code, or VS Code on this page. It uses the publisher's install, not a PlugMCP proxy.

Does Avito Ads MCP need an API key?

The publisher lists these environment variables: AVITO_ADS_CLIENT_ID, AVITO_ADS_CLIENT_SECRET, AVITO_ADS_ACCOUNT_ID, AVITO_ADS_ENVIRONMENT, AVITO_ADS_API_BASE, AVITO_ADS_TIMEOUT_MS, AVITO_ADS_MAX_RETRIES, AVITO_ADS_TOKEN_LEEWAY_SECONDS.

What transport does Avito Ads MCP use?

Avito Ads MCP runs locally over stdio.

When was Avito Ads MCP last checked?

Last checked 2026-11-08. MCP server for the Avito Ads API: campaigns, ad groups, creatives, statistics and balances.

Avito Ads MCP server

Power your agent

Add this server

The publisher's own command. Not a PlugMCP endpoint.

Add to Cursor Add to VS Code Run on PlugMCP

Host a copy with our keys and logs.

Local command

npx -y [email protected]

Credentials from the publisher

AVITO_ADS_CLIENT_ID — OAuth2 client id of your Avito application (grant_type=client_credentials).
AVITO_ADS_CLIENT_SECRET — OAuth2 client secret of your Avito application. Treat it as a secret.
AVITO_ADS_ACCOUNT_ID — Ad account id (positive integer) every request is scoped to.
AVITO_ADS_ENVIRONMENT — Which API to talk to: production or sandbox.
AVITO_ADS_API_BASE — API root override, replacing host and environment prefix (e.g. a local mock).
AVITO_ADS_TIMEOUT_MS — Per-request timeout in milliseconds.
AVITO_ADS_MAX_RETRIES — Retries on 429 (always) and on 5xx / network errors for reads only.
AVITO_ADS_TOKEN_LEEWAY_SECONDS — Refresh the OAuth2 token this many seconds before it expires.

Claude Code has no install link for a local command. Copy the command below and run it in a terminal.

shClaude Code

1AVITO_ADS_CLIENT_ID=<secret> AVITO_ADS_CLIENT_SECRET=<secret> AVITO_ADS_ACCOUNT_ID=<value> AVITO_ADS_ENVIRONMENT=<value> AVITO_ADS_API_BASE=<value> AVITO_ADS_TIMEOUT_MS=<value> AVITO_ADS_MAX_RETRIES=<value> AVITO_ADS_TOKEN_LEEWAY_SECONDS=<value> claude mcp add io.github.a1-x-tech-mcp-avito-ads -- npx -y mcp-avito-ads@1.3.1

Run in a terminal.

jsonClaude Desktop

1{2  "mcpServers": {3    "io.github.a1-x-tech-mcp-avito-ads": {4      "command": "npx",5      "args": [6        "-y",7        "[email protected]"8      ],9      "env": {10        "AVITO_ADS_CLIENT_ID": "<secret>",11        "AVITO_ADS_CLIENT_SECRET": "<secret>",12        "AVITO_ADS_ACCOUNT_ID": "<value>",13        "AVITO_ADS_ENVIRONMENT": "<value>",14        "AVITO_ADS_API_BASE": "<value>",15        "AVITO_ADS_TIMEOUT_MS": "<value>",16        "AVITO_ADS_MAX_RETRIES": "<value>",17        "AVITO_ADS_TOKEN_LEEWAY_SECONDS": "<value>"18      }19    }20  }21}

claude_desktop_config.json

Local · npmPublisher installStep-by-step: add this in Claude

Remote URL or a command on your machine? How the two installs differ

Run on PlugMCP

Host a copy with our keys and logs.

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.

Launch

Server facts

Local

Transport: stdio
Version

Tools

No tool list yet. Remote servers get one after the first health check.

FAQ

Questions

Авито Реклама MCP

A1 Авито Реклама MCP подключает AI-приложение к рекламному кабинету Авито Рекламы. Он помогает проверить кампании и статистику, управлять бюджетом и ставкой группы, работать с балансами агентства, доступами и документами ОРД — на естественном языке.

Это не API продавца Авито: сервер не работает с товарами, перепиской, заказами или продвижением объявлений продавца. Он работает только с медийными и performance-кампаниями рекламного кабинета Авито Рекламы.

25 инструментов. Кампании, группы, креативы, статистика, баланс, дочерние аккаунты, пользователи и документы ОРД.
Узкие изменения кампаний. API позволяет менять только бюджет и ставку группы; создавать, редактировать, ставить на паузу или удалять кампании, группы и креативы нельзя.
Необратимые операции видны. Перевод денег или бонусов, удаление пользователя и технический запрос API помечены как destructive.
Недельный бюджет API. Каждый вызов тратит баллы; остаток apiPointBalance сервер возвращает с результатом.

Начните с запроса, который только читает данные:

Покажи кампании моего аккаунта Авито и расход за прошлую неделю по группам объявлений.

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

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

Вы: Покажи кампании моего аккаунта Авито и расход за прошлую неделю по группам объявлений.

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

Вы: Подготовь изменение ставки группы 101 до 350 рублей.

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

Вы: Подтверждаю.

Ассистент: Меняет ставку только этой группы. Кампания, креативы и другие группы не меняются.

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

Нужны Node.js 20+, Client Key, Client Secret и ID рекламного аккаунта Авито Рекламы. Для выдачи доступов нужна роль администратора аккаунта.

Получите доступ.
Добавьте сервер в AI-приложение.
Отправьте безопасный первый запрос выше.

В Settings → MCP servers нажмите Add server, выберите STDIO, укажите команду npx -y mcp-avito-ads@latest и переменные окружения AVITO_ADS_CLIENT_ID, AVITO_ADS_CLIENT_SECRET и AVITO_ADS_ACCOUNT_ID, затем нажмите Save, потом Restart.

codex mcp add avito-ads \
  --env AVITO_ADS_CLIENT_ID=your_client_key \
  --env AVITO_ADS_CLIENT_SECRET=your_client_secret \
  --env AVITO_ADS_ACCOUNT_ID=your_account_id \
  -- npx -y mcp-avito-ads@latest
codex mcp list

Документация Codex MCP

claude mcp add \
  --env AVITO_ADS_CLIENT_ID=your_client_key \
  --env AVITO_ADS_CLIENT_SECRET=your_client_secret \
  --env AVITO_ADS_ACCOUNT_ID=your_account_id \
  --transport stdio --scope user avito-ads \
  -- npx -y mcp-avito-ads@latest
claude mcp list

Документация Claude Code MCP

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

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

{"mcpServers":{"avito-ads":{"command":"npx","args":["-y","mcp-avito-ads@latest"],"env":{"AVITO_ADS_CLIENT_ID":"your_client_key","AVITO_ADS_CLIENT_SECRET":"your_client_secret","AVITO_ADS_ACCOUNT_ID":"your_account_id"}}}}

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

Документация Claude Desktop MCP

Добавьте {"mcpServers":{"avito-ads":{"type":"stdio","command":"npx","args":["-y","mcp-avito-ads@latest"],"env":{"AVITO_ADS_CLIENT_ID":"your_client_key","AVITO_ADS_CLIENT_SECRET":"your_client_secret","AVITO_ADS_ACCOUNT_ID":"your_account_id"}}}} в ~/.cursor/mcp.json на macOS/Linux или %USERPROFILE%\.cursor\mcp.json на Windows. Документация Cursor MCP

Запустите MCP: Open User Configuration и добавьте:

{"servers":{"avito-ads":{"type":"stdio","command":"npx","args":["-y","mcp-avito-ads@latest"],"env":{"AVITO_ADS_CLIENT_ID":"${input:avito_client_id}","AVITO_ADS_CLIENT_SECRET":"${input:avito_client_secret}","AVITO_ADS_ACCOUNT_ID":"${input:avito_account_id}"}}},"inputs":[{"type":"promptString","id":"avito_client_id","description":"Avito Ads Client Key"},{"type":"promptString","id":"avito_client_secret","description":"Avito Ads Client Secret","password":true},{"type":"promptString","id":"avito_account_id","description":"ID рекламного аккаунта"}]}

Проверьте сервер командой MCP: List Servers. Документация VS Code MCP

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

Покажи кампании, группы, креативы, статусы и статистику за период.
Сравни расход, CTR, CPM, CPC или VTR по группам и креативам.
Проверь баланс и дочерние аккаунты агентства.
Подготовь изменение бюджета или ставки одной группы.
Создай рекламодателя и договор ОРД, сначала показав передаваемые реквизиты.
Добавь пользователя, измени его роль или отзови доступ после подтверждения.

Что может измениться

Операция	Что происходит	Граница подтверждения
Кампании, группы, креативы, статистика, баланс, пользователи и ОРД	Читает данные аккаунта	Ничего не меняет
Бюджет или ставка группы	Меняет одно из двух доступных API-полей группы	Меняет рекламную группу
Пользователь и роль	Выдаёт доступ или меняет роль	Меняет доступы аккаунта
Рекламодатель, договор, дочерний или sandbox-аккаунт	Создаёт новую запись	Необратимо создаёт объект
Перевод денег или бонусов, удаление пользователя	Меняет баланс или удаляет доступ	Разрушительно и необратимо
Raw API request	Может менять данные при `confirmWrite: true`	Потенциально разрушительно

Кампании, группы и креативы нельзя создавать, редактировать, ставить на паузу, архивировать или удалять через этот API. Креативы и таргетинги тоже недоступны для записи.

Получение доступа

Откройте кабинет Авито Рекламы пользователем с ролью администратора.
Создайте API-приложение и скопируйте Client Key и Client Secret.
Скопируйте ID рекламного аккаунта.
Передайте их как AVITO_ADS_CLIENT_ID, AVITO_ADS_CLIENT_SECRET, AVITO_ADS_ACCOUNT_ID.

Сервер получает Bearer token через OAuth2 client_credentials. Храните Client Secret как пароль. ID аккаунта задан конфигурацией: инструменты не смогут случайно перейти в другой аккаунт.

Для репетиции записей можно задать AVITO_ADS_ENVIRONMENT=sandbox. Песочница не является полной копией production: например, баланс там недоступен.

Настройка

Переменная	Обязательна	Описание
`AVITO_ADS_CLIENT_ID`	Да	Client Key API-приложения.
`AVITO_ADS_CLIENT_SECRET`	Да	Client Secret API-приложения.
`AVITO_ADS_ACCOUNT_ID`	Да	ID рекламного аккаунта.
`AVITO_ADS_ENVIRONMENT`	Нет	`production` или `sandbox`; по умолчанию `production`.
`AVITO_ADS_TIMEOUT_MS`	Нет	Тайм-аут запроса; по умолчанию `30000` мс.
`AVITO_ADS_MAX_RETRIES`	Нет	Повторы 429; по умолчанию `4`.

Данные, лимиты и работа в фоне

Недельный бюджет баллов. Баллы пополняются в понедельник в 00:00 UTC. Один длинный отчёт до 100 дней обычно экономнее серии коротких; сервер показывает apiPointBalance с каждым результатом.
Временные ошибки. При 429 в ошибке возвращаются Retry-After и остаток баллов. Записи не повторяются после сетевой или 5xx ошибки, чтобы не перевести деньги дважды.
Постоянного наблюдения нет. Сервер работает только при вызове. Если AI-приложение поддерживает задания по расписанию, оно может периодически собирать статистику и остаток баллов.
Анонимная телеметрия. В неё не попадают секреты, данные аккаунта, аргументы и промпты; отключение: ASKADS_TELEMETRY=0.

Техническая документация

Каталог MCP-возможностей — страницы по пользовательским задачам для каждого инструмента.
Все инструменты и параметры
Документация по разработке
Документация по публикации
Официальный Avito Ads SDK

Поддержка

Нашли ошибку или не хватает сценария? Создайте issue или напишите в Telegram.

Add this server

Host a copy with our keys and logs.

Server facts

Tools

Questions

How do I install Avito Ads MCP?

Does Avito Ads MCP need an API key?

What transport does Avito Ads MCP use?

When was Avito Ads MCP last checked?

Documentation

Авито Реклама MCP

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

Содержание

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

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

Что может измениться

Получение доступа

Настройка

Данные, лимиты и работа в фоне

Техническая документация

Поддержка