1. Что такое HilltopAds MCP и что с его помощью можно делать

Что такое HilltopAds MCP?

MCP-сервер (Model Context Protocol) – это официальный коннектор HilltopAds для AI-клиентов. После подключения AI читает данные вашего аккаунта и, когда вы это подтверждаете, вносит изменения – например, создаёт или обновляет кампании – по защищённому отдельному каналу, без ручного переноса данных.

Логин и пароль AI-клиенту не передаются. Подключение авторизуется API-ключом, который вы генерируете в своём аккаунте.

Коннектор открывает доступ к аккаунту HilltopAds через набор операций (инструментов). AI сам выбирает нужный инструмент под ваш запрос, вызывает его и превращает результат в понятный ответ – таблицу, сводку или даже график.

Что можно делать с помощью HilltopAds MCP?

Инструменты делают две вещи. Операции чтения получают данные – баланс, инвентарь, статистику, одну кампанию или списки источников кампании. Операции действия меняют аккаунт – создают и обновляют кампании, запускают и останавливают их, меняют ставки и целевые URL, а также ведут чёрные и белые списки источников.

Какие инструменты вы увидите, зависит от типа аккаунта – рекламодатель, паблишер или оба сразу. Сейчас доступ охватывает 27 операций: 23 для рекламодателей и 4 для паблишеров.

Операции действия выполняются только с вашего подтверждения. AI-клиенты помечают инструменты как только чтение или запись/удаление и запрашивают согласие перед любым изменением.

Аккаунт и отчёты

Инструмент	Что делает
`advertiser_get_balance`	Текущий баланс рекламного аккаунта.
`advertiser_list_inventory`	Ваши кампании и их объявления.
`advertiser_get_stats`	Статистика с фильтрацией или группировкой по дате, зоне, GEO, кампании, ОС, часу или источнику.
`advertiser_get_campaign`	Полные данные одной кампании по её ID.

Управление кампаниями

Важно: В примерах ниже ассистент создаёт каждую кампанию неактивной, чтобы вы могли проверить её до начала расходов. Это разумное поведение, которое выбрал сам ассистент, а не жёсткое правило. Если нужно, чтобы кампания была создана неактивной (или сразу запущена), укажите это в запросе явно.

Инструмент	Что делает
`advertiser_create_campaign`	Создать новую кампанию.
`advertiser_update_campaign`	Частично обновить настройки кампании.
`advertiser_start_campaign`	Активировать одобренную кампанию.
`advertiser_stop_campaign`	Остановить работающую кампанию.
`advertiser_archive_campaign`	Отправить кампанию в архив.
`advertiser_unarchive_campaign`	Восстановить кампанию из архива.
`advertiser_set_bid`	Изменить ставку для wildcard-GEO.
`advertiser_set_destination_url`	Изменить целевой URL Popunder.
`advertiser_replace_domain`	Заменить домен во всех объявлениях аккаунта рекламодателя.

Чёрный список источников

Инструмент	Что делает
`advertiser_get_blacklist`	Чёрный список источников кампании.
`advertiser_add_to_blacklist`	Добавить источники в чёрный список.
`advertiser_remove_from_blacklist`	Убрать источники из чёрного списка.
`advertiser_clear_campaign_blacklist`	Очистить чёрный список кампании.
`advertiser_set_blacklist`	Заменить весь список целиком и перевести кампанию в режим BLACKLIST.

Белый список источников

Инструмент	Что делает
`advertiser_get_whitelist`	Белый список источников кампании.
`advertiser_add_to_whitelist`	Добавить источники в белый список.
`advertiser_remove_from_whitelist`	Убрать источники из белого списка.
`advertiser_clear_campaign_whitelist`	Очистить белый список кампании.
`advertiser_set_whitelist`	Заменить весь список целиком и перевести кампанию в режим WHITELIST.