TikTok Ads в MCP: управляйте TikTok Ads из любого AI-агента

💡 Без установки? Используйте cloud.anythingmcp.com напрямую. Войдите, нажмите Connectors → TikTok Ads, вставьте учётные данные, создайте MCP API key, и готово. Без Docker, без git clone, без локального сервера.

TikTok Ads

Дайте ИИ анализировать вашу рекламу в TikTok: расходы, показы, клики и конверсии по кампаниям, группам объявлений, объявлениям, дням или аудиториям, а также кампании, кампании Smart+, аудитории, пиксели и библиотеку креативов. Может приостанавливать и включать кампании, группы объявлений и объявления и менять бюджеты кампаний, когда вы включите эти инструменты и подтвердите действие.

Настройка

1. Войдите в портал разработчиков TikTok API for Business по адресу https://business-api.tiktok.com/portal с аккаунтом TikTok for Business, у которого есть доступ к вашему рекламному аккаунту, и нажмите Become a Developer.
2. В разделе My Apps → Create an app укажите название, описание и Advertiser redirect URL (подойдёт любая ваша страница на https: вы лишь копируете код из её адреса) и отметьте scopes Ad Account Management, Ads Management, Reporting и Audience Management, а для соответствующих инструментов также Pixel Management и Creative Management. TikTok проверяет новые приложения, обычно за два или три рабочих дня.
3. Когда приложение одобрят, скопируйте его App ID и Secret в TIKTOK_ADS_APP_ID и TIKTOK_ADS_APP_SECRET. Оба параметра необязательны: коннектор использует их только для того, чтобы перечислить рекламные аккаунты, доступные по вашему токену.
4. Откройте Advertiser authorization URL приложения, войдите, отметьте рекламные аккаунты и подтвердите. Браузер перейдёт на redirect URL с auth_code=... в адресной строке. Код работает один раз и истекает через час.
5. Сразу обменяйте код на долгоживущий access token. Это нужно сделать только один раз:

   curl -X POST https://business-api.tiktok.com/open_api/v1.3/oauth2/access_token/ -H "Content-Type: application/json" -d '{"app_id":"<App ID>","secret":"<Secret>","auth_code":"<auth_code>"}'
   

   Вставьте data.access_token из ответа в TIKTOK_ADS_ACCESS_TOKEN, а один из data.advertiser_ids в TIKTOK_ADS_ADVERTISER_ID. Токен не истекает; он перестаёт работать, только если авторизацию отзовут или сбросят secret приложения.
6. Задайте TIKTOK_ADS_API_HOST как https://business-api.tiktok.com, установите коннектор и запустите tiktok_ads_get_advertiser_info, чтобы проверить аккаунт.

Sandbox: чтобы попробовать без реальных расходов, откройте приложение в портале разработчиков → Sandbox, создайте рекламный аккаунт в sandbox и сгенерируйте там его токен; проверка не нужна. Используйте этот токен и ID рекламодателя из sandbox, а TIKTOK_ADS_API_HOST задайте как https://sandbox-ads.tiktok.com. Аккаунты sandbox не показывают рекламу и не дают реальных данных.

Один рекламный аккаунт на коннектор: каждый инструмент работает с рекламным аккаунтом из TIKTOK_ADS_ADVERTISER_ID. Токен часто охватывает несколько аккаунтов, и tiktok_ads_list_authorized_advertisers их перечисляет. Для каждого следующего аккаунта установите коннектор ещё раз.

Изменения статуса и бюджета по умолчанию выключены: tiktok_ads_update_campaign_status, tiktok_ads_update_ad_group_status, tiktok_ads_update_ad_status и tiktok_ads_update_campaign_budget выключены при установке, потому что включение чего-либо сразу запускает расходы. Включите их по отдельности, если хотите, чтобы ИИ приостанавливал объявления или менял бюджеты. Тогда он называет кампанию, группу объявлений или объявление, текущее и новое значение и ждёт вашего согласия. Объявление показывается, только если включены само объявление, его группа объявлений и его кампания. Бюджеты задаются суммой в валюте аккаунта (50 означает 50,00), и TikTok отклоняет бюджет ниже минимального или ниже 105% уже потраченной суммы. Коннектор никогда не создаёт кампании или объявления.

Отчёты: tiktok_ads_get_report возвращает расходы, показы, клики, конверсии и другие показатели по кампаниям, группам объявлений, объявлениям или по всему аккаунту, по дням или по часам, либо в разбивке по возрасту, полу, стране или месту размещения. Дневные строки охватывают до 30 дней за один запрос, поэтому ИИ делит более длинные периоды на части; итоги без разбивки по времени могут охватывать до года. Даты считаются в часовом поясе рекламного аккаунта, суммы указаны в его валюте.

Частые ошибки: TikTok сообщает об ошибке кодом внутри в остальном обычного ответа, а коннектор превращает его в понятную ошибку. 40001: у приложения или токена нет прав на этот аккаунт или действие, поэтому авторизуйте рекламный аккаунт заново с нужными scopes. 40104 или 40105: токен недействителен, истёк, отозван или принадлежит другому аккаунту; сгенерируйте новый. 40100: слишком много запросов, подождите немного. 40300: TikTok не знает такой ID рекламодателя.

Коннектор не создаёт и не редактирует кампании, группы объявлений, объявления или аудитории, не загружает креативы, не управляет Business Center и не работает с TikTok Shop.

Предварительные требования: TIKTOK_ADS_API_HOST, TIKTOK_ADS_ACCESS_TOKEN, TIKTOK_ADS_ADVERTISER_ID

Локальная установка коннектора

curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d

Откройте http://localhost:3000/connectors/store, выберите TikTok Ads и введите переменные, перечисленные в Предварительных требованиях.

Доступные инструменты

Примеры запросов

• «Сколько мы потратили на TikTok на прошлой неделе и у какой кампании была самая низкая стоимость конверсии?»
• «Покажи ежедневные расходы, клики и конверсии по каждой кампании за последние 30 дней.»
• «Разбей результаты прошлого месяца по возрасту и полу.»
• «Наш TikTok Pixel ещё получает события покупок? Сравни последние 7 дней с предыдущей неделей.»

Следующие шаги

• Подключить к Claude
• Подключить к ChatGPT