Как подключить Авито Рекламу к Claude и ChatGPT

Подключить Авито Рекламу к Claude, ChatGPT или Codex можно через MCP-коннектор Direct Manager. После подключения ассистент читает реальные кампании, группы, креативы и статистику из официального Ads API Авито — без скриншотов и ручных выгрузок.

В этой инструкции важно не перепутать два разных продукта. Авито Реклама — отдельный рекламный кабинет с кампаниями, CPM/CPC, группами и креативами. Это не платное поднятие обычного объявления на классифайде.

Что понадобится

Перед началом подготовьте:

1. Рекламный кабинет Авито Реклама.
2. Роль Администратор в этом кабинете.
3. Три значения: Account ID, Client ID, Client Secret.
4. Аккаунт Direct Manager с MCP-тарифом.
5. Claude, ChatGPT, Codex или другой MCP-совместимый клиент.

По официальной документации Авито, ключи создаются во вкладке «API» кабинета Авито Реклама. Сделать это может только администратор. Пара ключей привязана к конкретному рекламному аккаунту; для дочернего аккаунта нужны отдельные ключи.

Шаг 1. Откройте вкладку API в Авито Рекламе

1. Войдите в рекламный кабинет Авито Реклама.
2. Переключитесь на тот рекламный аккаунт, который хотите подключить.
3. Откройте вкладку «API».
4. Убедитесь, что ваша роль — Администратор. Если вкладки или кнопки создания ключей нет, попросите администратора кабинета выдать роль либо создать ключи.

Не используйте credentials из разделов API обычного профиля Авито, Автозагрузки, Messenger или VAS. Direct Manager подключает именно Ads API с путями вида /ads/v1/account/{accountID}.

Шаг 2. Получите Client ID и Client Secret

Во вкладке «API» создайте пару ключей и сохраните:

• Client ID — публичный идентификатор ключа;
• Client Secret — секретная часть, которую нельзя отправлять в чат или публиковать;
• Account ID — числовой ID именно этого рекламного аккаунта.

Ключи и Account ID должны относиться к одному аккаунту. Это принципиально: официальный API ограничивает токен аккаунтом, в котором выпущены ключи.

Как не ошибиться с Account ID

Нужен ID рекламного аккаунта, а не:

• ID обычного профиля Авито;
• ID объявления;
• ID кампании;
• Client ID приложения.

Если Client ID и Client Secret правильные, но Account ID взят от другого аккаунта, получение токена пройдёт успешно, а запрос кабинета вернёт 403 Forbidden. Именно так API сообщает, что токен не имеет прав на Account ID в адресе запроса.

Шаг 3. Подключите кабинет в Direct Manager

1. Войдите в Direct Manager.
2. Откройте страницу «Подключения».
3. Найдите секцию «Авито Реклама · Только MCP».
4. Вставьте Account ID, Client ID и Client Secret.
5. Нажмите «Подключить Авито Рекламу».

Direct Manager сначала получает временный access token по стандартному client_credentials, затем выполняет безопасный read-only запрос к аккаунту. Кабинет сохраняется только после успешной проверки.

Client Secret хранится на сервере в зашифрованном виде. Access token живёт ограниченное время; Direct Manager выпускает и кэширует его автоматически, поэтому вручную обновлять токен не нужно.

Шаг 4. Подключите MCP к Claude

После сохранения кабинета откройте раздел «ИИ-ассистент». Адрес удалённого MCP-сервера:

https://app.marketscore.ru/api/mcp

В Claude откройте настройки коннекторов, добавьте пользовательский удалённый коннектор и укажите этот URL. Claude откроет авторизацию Direct Manager — войдите и подтвердите доступ.

Если коннектор был подключён раньше, переподключите его или обновите список инструментов. Клиенты MCP могут кэшировать перечень инструментов, поэтому новые avito_* не всегда появляются мгновенно.

Шаг 5. Подключите ChatGPT или Codex

Для ChatGPT и Codex используется тот же URL MCP-сервера. Добавьте его в настройках коннекторов/интеграций и авторизуйтесь через Direct Manager.

Клиенты, которые понимают только локальные MCP-серверы, подключаются через mcp-remote. Готовая команда и резервный MCP-ключ доступны на странице «ИИ-ассистент».

Как проверить подключение

Начните с запроса:

Покажи информацию о кабинете Авито Рекламы и список кампаний.

Ассистент должен вызвать avito_account_info и avito_list_campaigns. Затем попробуйте:

• «Покажи группы кампании 520043093»;
• «Какие креативы есть в группе?»;
• «Собери статистику кампаний Авито за последние 14 дней»;
• «Отсортируй кампании по расходу и сравни CTR».

Если кампания находится в черновике или ещё не имеет креативов, статистика может быть пустой — это нормальный ответ API.

Какие инструменты доступны

Все инструменты Авито сейчас только читают данные. Ассистент не может изменить ставку, бюджет или запустить рекламу через эти инструменты.

Ошибки и их решение

401 Unauthorized

Client ID или Client Secret неверны либо access token просрочен. Перепроверьте пару ключей во вкладке «API» и переподключите кабинет.

403 Forbidden

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

Кампании видны, статистика пустая

Проверьте статус кампании, наличие групп и креативов, а также выбранный период. По официальному Ads API максимальный диапазон статистики — 100 дней.

Инструменты avito_* не появились

Переподключите MCP-коннектор. Claude и другие клиенты иногда кэшируют список инструментов на момент первого подключения.

Безопасность

Direct Manager не передаёт Client Secret в Claude, ChatGPT или Codex. MCP-клиент видит только названия инструментов и возвращённые рекламные данные. Секрет хранится зашифрованным, а каждый MCP-запрос выполняется от имени авторизованного пользователя Direct Manager.

Подробное описание возможностей находится на странице «Авито Реклама в Claude и ChatGPT».