Synter Ads

официальный

Кроссплатформенное управление рекламными кампаниями для AI-агентов в Google, Meta, LinkedIn, Reddit, TikTok и других. 140+ инструментов с доступом на чтение и запись.

Что можно делать с Synter Ads MCP?

  • List campaigns across platforms — Ask your assistant to pull all campaigns from connected ad accounts with list_campaigns.
  • Create search campaigns — Use create_search_campaign to launch a Google Search campaign with keywords, ads, and budget.
  • Pause underperformers — Stop any campaign instantly via pause_campaign when spend or ROAS looks off.
  • Pull performance metrics — Get impressions, clicks, spend, conversions, and ROAS with get_performance.
  • Generate ad creatives — Have generate_image or generate_video produce ad assets ready for upload.
  • Run any of 140+ tools — Access the full Synter catalog directly with run_tool for advanced actions.

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

Synter MCP Server

npm version License: MIT

Самый полный MCP-сервер для рекламы.

Отчётность по 19 рекламным платформам и полное создание кампаний на 14 из них (действия записи на 16), охватывая все основные каналы закупки, со встроенными подтверждениями для деструктивных действий.

Создавайте кампании. Корректируйте бюджеты. Приостанавливайте неэффективные. Генерируйте креативы. Получайте данные об эффективности. Всё через естественный диалог, на платформах Google, Meta, LinkedIn, Microsoft, Reddit, TikTok, X и других.

Это первый Model Context Protocol (MCP) сервер, который даёт AI-агентам кредитную карту.

Примечание: Synter-Media-AI/plugin — это канонический устанавливаемый репозиторий плагина Claude. Копия .claude-plugin/ в этом репозитории не является источником для установки.


Сравнение с Synter

Официальный MCP-сервер Google Ads по замыслу доступен только для чтения: согласно документации Google, он «строго read-only» и «не может изменять ставки, приостанавливать кампании или создавать новые объекты». Большинство сторонних MCP-серверов для рекламы охватывают одну платформу. Мы создали Synter, чтобы выполнять обе задачи на всех основных каналах закупки с одного сервера.

Synter MCPОфициальный Google Ads MCPТипичные сторонние рекламные MCP
ДоступЧтение на всех 19 платформах, создание кампаний на 14, действия записи на 16Только чтение (текущий релиз)Часто только чтение или частичная запись
Платформы19 для отчётности, 14 с полным созданием кампаний (списки ниже)Только Google AdsОбычно одна платформа
Создание кампаний✅ Google Search, Display, PMax, Meta, LinkedIn, Reddit и другие через run_tool❌Редко
Бюджеты и пауза✅❌Различается
AI-генерация креативов✅ Изображения, видео, тексты❌❌
Синхронизация аудиторий✅ Google, Meta, LinkedIn, Microsoft, Reddit, TikTok, X❌❌
БезопасностьПодтверждения для деструктивных действийн/д (только чтение)Различается
Открытый исходный код✅ MIT✅Различается

Охват отчётности (19 платформ): Google Ads, Microsoft Ads (Bing), Meta (Facebook и Instagram), LinkedIn Ads, X (Twitter) Ads, Reddit Ads, TikTok Ads, Snapchat Ads, Pinterest Ads, Spotify Ads, Amazon Ads, Amazon DSP, Walmart Connect, Instacart Ads, Target Roundel, Criteo, The Trade Desk, Display & Video 360 и OpenAI Ads (ChatGPT).

Полное создание кампаний (14 платформ): Google Ads, Microsoft Ads, Meta, LinkedIn, X, Reddit, TikTok, Snapchat, Pinterest, Spotify, Amazon Ads (Sponsored Products, Brands и Display), Amazon DSP, The Trade Desk и OpenAI Ads. Display & Video 360 и StackAdapt дополнительно поддерживают действия записи (пауза, обновление бюджета и позиций, загрузка аудиторий) без создания кампаний. Остальные 4 (Walmart Connect, Instacart, Target Roundel и Criteo) на данный момент доступны только для отчётности.

Пакет npx поставляется с типизированными инструментами для наиболее распространённых операций, а также с доступом run_tool к полному каталогу из 140+ инструментов Synter. Удалённый сервер на https://mcp.syntermedia.ai/mcp/ предоставляет полный набор размещённых инструментов, включая выгрузку эффективности для каждой платформы из списка выше.

Для обнаружения MCP в реестровом стиле server.json является машиночитаемым источником истины. Держите его синхронизированным с package.json, manifest.json и примерами настройки в этом README.


⚠️ Честное предупреждение

Ваш AI-агент сможет:

  • Создавать кампании, которые немедленно начнут тратить ваш бюджет
  • Корректировать ставки, влияющие на то, сколько вы платите за клик
  • Приостанавливать кампании (иногда это хорошо)
  • Добавлять ключевые слова, меняющие то, кто видит вашу рекламу
  • Генерировать креативы и загружать их в ваши аккаунты

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


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

1. Получите свой API-ключ

Зарегистрируйтесь на syntermedia.ai и создайте API-ключ в Developer Settings.

2. Настройте свой AI-клиент

Для Claude Desktop: Добавьте в ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "synter": {
      "command": "npx",
      "args": ["@synterai/mcp-server"],
      "env": {
        "SYNTER_API_KEY": "syn_your_api_key_here"
      }
    }
  }
}

Для Cursor: Добавьте в .cursor/mcp.json в вашем проекте:

{
  "mcpServers": {
    "synter": {
      "command": "npx",
      "args": ["@synterai/mcp-server"],
      "env": {
        "SYNTER_API_KEY": "syn_your_api_key_here"
      }
    }
  }
}

Для Amp: Добавьте в .amp/settings.json:

{
  "mcpServers": {
    "synter": {
      "command": "npx",
      "args": ["@synterai/mcp-server"],
      "env": {
        "SYNTER_API_KEY": "syn_your_api_key_here"
      }
    }
  }
}

Удалённо (Streamable HTTP): Для ChatGPT, n8n, Zapier или любого MCP-клиента, поддерживающего HTTP-транспорт:

URL: https://mcp.syntermedia.ai/mcp/
Header: X-Synter-Key: syn_your_api_key_here

Локальная установка не требуется. Работает с любым MCP-клиентом, поддерживающим транспорт Streamable HTTP.

3. Начните использовать

Перезапустите ваш AI-клиент и начните общение:

«Покажи все мои кампании Google Ads»

«Создай поисковую кампанию для "программного обеспечения для управления проектами" с бюджетом $50 в день»

«Приостанови кампанию, которая превышает бюджет»


Предпочитаете полноценный плагин? (Claude Code / Claude Desktop)

Этот пакет — сырой MCP-сервер. Если вы используете Claude Code или Claude Desktop, плагин Synter оборачивает этот же сервер с готовыми навыками (/synter:launch, /synter:audience, /synter:optimize, …), специализированными агентами и защитным механизмом подтверждения перед тратой:

/plugin marketplace add Synter-Media-AI/plugin
/plugin install synter@synter

Он также включает headless-раннер Claude Agent SDK для автоматизации. См. репозиторий плагина или руководство по плагинам Claude. Используйте этот MCP-пакет напрямую, когда нужны только инструменты, или при подключении другого клиента.


Что может ваш агент?

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

ИнструментОписание
list_campaignsСписок кампаний на всех подключённых платформах
create_search_campaignСоздание поисковой кампании Google с ключевыми словами и объявлениями
create_display_campaignСоздание медийной кампании Google с изображениями
create_pmax_campaignСоздание кампании Performance Max
create_meta_campaignСоздание кампании Facebook/Instagram
create_linkedin_campaignСоздание кампании LinkedIn для B2B
create_reddit_campaignСоздание кампании Reddit
pause_campaignПриостановка любой кампании
update_campaign_budgetИзменение дневного бюджета

📈 Эффективность и аналитика

ИнструментОписание
get_performanceПолучение показов, кликов, расходов, конверсий, ROAS
get_daily_spendРазбивка ежедневных расходов по платформам

🎯 Ключевые слова и таргетинг

ИнструментОписание
add_keywordsДобавление ключевых слов в кампанию или группу объявлений
add_negative_keywordsБлокировка нежелательных поисковых запросов

🔄 Отслеживание конверсий

ИнструментОписание
create_conversionНастройка действия конверсии
list_conversionsСписок существующих действий конверсии
diagnose_trackingПроверка корректности установки отслеживания

🎨 Генерация креативов

ИнструментОписание
generate_imageAI-генерация изображений для объявлений
generate_videoAI-генерация видеорекламы
upload_imageЗагрузка изображений как рекламных материалов

🔧 Утилиты

ИнструментОписание
list_ad_accountsСписок всех подключённых рекламных аккаунтов
run_toolЗапуск любого из 140+ инструментов Synter напрямую

Нет опыта в рекламе? Не проблема.

Если вы никогда не запускали рекламу, вот что нужно знать:

Что такое кампания?

Кампания — это как папка проекта. Она содержит ваши объявления, аудиторию и бюджет.

Campaign: "Q1 Lead Generation"
├── Budget: $50/day
├── Targeting: USA, people searching "project management"
└── Ads: Headlines, descriptions, images

Какие платформы можно использовать?

ПлатформаЛучше всего подходит дляМин. бюджет
Google AdsЛюди, активно ищущие ваш продукт$10/день
Meta (Facebook/Instagram)Визуальные продукты, широкие аудитории$5/день
LinkedInB2B, корпоративные клиенты, соискатели$25/день
RedditНишевые сообщества, технически подкованные пользователи$5/день
Microsoft (Bing)Старшая демография, B2B$10/день
TikTokПоколение Z, развлечения, e-commerce$20/день

Объяснение типов кампаний

Поисковые кампании: Ваше объявление показывается, когда кто-то гуглит определённые ключевые слова.

  • Пример: Кто-то ищет «лучшее CRM-программное обеспечение» → Появляется ваше объявление

Медийные кампании: Имиджевая реклама на сайтах и в приложениях.

  • Пример: Баннер на новостном сайте

Performance Max (PMax): ИИ Google показывает вашу рекламу везде (Поиск, YouTube, Медийная сеть, Gmail, Карты).

  • Пример: Google сам определяет лучшие места размещения

Видеокампании: Видеореклама на YouTube и партнёрских сайтах.

  • Пример: 15-секундное объявление перед видео на YouTube

Часто используемые термины

ТерминЧто означает
ПоказыСколько раз было показано ваше объявление
КликиСколько людей кликнули по вашему объявлению
CTRРейтинг кликов (клики ÷ показы × 100)
CPCСтоимость за клик
КонверсииЦелевые действия (регистрации, покупки и т. д.)
ROASВозврат на рекламные расходы (доход ÷ расходы)

Чек-лист для первой кампании

Перед созданием первой кампании вам понадобится:

  1. ✅ URL целевой страницы, куда перейдут люди после клика
  2. ✅ Представление о целевой аудитории (местоположение, интересы)
  3. ✅ Дневной бюджет, с которым вам комфортно ($10–50 для начала)
  4. ✅ Несколько заголовков и описаний для вашего объявления

Совет: Начните с поисковой кампании в Google. Её проще всего понять, и она показывает рекламу людям, которые уже ищут то, что вы предлагаете.


Примеры диалогов

Создание первой кампании

Вы: Создай поисковую кампанию Google для моего SaaS-продукта. Таргетируй людей, ищущих «программное обеспечение для командной работы» и «инструменты управления проектами». Бюджет — $25 в день. Целевая страница — https://myapp.com/signup

Агент: Я создам поисковую кампанию с этими ключевыми словами. Какие заголовки использовать? Вот несколько предложений:

  • «Командная работа стала проще»
  • «Управление проектами для современных команд»
  • «Начните бесплатно — без кредитной карты»

Проверка эффективности

Вы: Как мои кампании работают на этой неделе?

Агент: Вот ваша эффективность за последние 7 дней:

КампанияРасходыКликиКонверсииROAS
Брендовый поиск$14289124.2x
Ключевые слова конкурентов$984531.5x
Медийный ретаргетинг$6723482.8x

Кампания «Ключевые слова конкурентов» показывает низкую эффективность. Хотите, я приостановлю её или скорректирую таргетинг?

Добавление минус-слов

Вы: Я получаю клики по запросу «бесплатное управление проектами», но у нас нет бесплатного тарифа. Заблокируй эти запросы.

Агент: Добавил «бесплатное» как минус-слово в вашу кампанию. Это остановит показ ваших объявлений по любым запросам, содержащим «бесплатное».

Генерация рекламного креатива

Вы: Мне нужно изображение для медийного объявления для продукта автоматизации маркетинга. Тёмная тема, профессионально, 1200x628.

Агент: Генерирую ваше изображение...

Создано: «Панель автоматизации маркетинга с визуализацией данных на тёмном фоне» Материал сохранён и готов к использованию в вашей следующей медийной кампании.


Подключение рекламных аккаунтов

Чтобы управлять рекламой на каждой платформе, вам нужно подключить аккаунты в Synter:

  1. Перейдите на syntermedia.ai/settings/credentials
  2. Нажмите «Подключить» рядом с каждой платформой
  3. Пройдите OAuth-процесс
  4. Ваш агент теперь может управлять этой платформой

Поддерживаемые платформы (19; ✅ = отчётность + полное выполнение кампаний, 📊 = только отчётность):

  • Google Ads ✅
  • Meta (Facebook/Instagram) ✅
  • LinkedIn Ads ✅
  • Microsoft Ads (Bing) ✅
  • Reddit Ads ✅
  • TikTok Ads ✅
  • X (Twitter) Ads ✅
  • Snapchat Ads ✅
  • Pinterest Ads ✅
  • Spotify Ads ✅
  • Amazon DSP ✅
  • The Trade Desk ✅
  • Amazon Ads 📊
  • Walmart Connect 📊
  • Instacart Ads 📊
  • Target Roundel 📊
  • Criteo 📊
  • Display & Video 360 📊
  • OpenAI Ads (ChatGPT) 📊

Продвинутый уровень: прямой доступ к инструментам

Для опытных пользователей: вы можете вызывать любой из 140+ инструментов Synter напрямую:

> Use run_tool to call google_ads_list_audiences

Полный список инструментов см. на docs.syntermedia.ai/tools или спросите вашего агента:

> What tools are available for LinkedIn Ads?

Безопасно по умолчанию: execute пробные запуски, если не указано иное

Универсальный инструмент execute никогда не выполняет действие при первом вызове, если вы явно не согласитесь. По умолчанию (dry_run: true) он проверяет запрос и останавливается — ничего не выполняется, ничего не тратится. Передайте dry_run: false, чтобы фактически запустить действие; для всего, что связано с тратой денег, делайте это только с одобрения владельца аккаунта.


Переменные окружения

ПеременнаяОбязательнаяОписание
SYNTER_API_KEYДаВаш ключ API Synter
SYNTER_API_URLНетПереопределение URL API (по умолчанию: https://syntermedia.ai)

Локальная разработка

# Clone and install
git clone https://github.com/Synter-Media-AI/mcp-server.git
cd mcp-server
npm install

# Build
npm run build

# Run locally
SYNTER_API_KEY=syn_your_key_here node dist/index.js

Устранение неполадок

«SYNTER_API_KEY не задан»

Убедитесь, что ваш ключ API находится в разделе env вашего конфигурационного файла MCP. Ключ должен начинаться с syn_.

«Недействительный или истёкший ключ API»

  1. Проверьте, что вы скопировали полный ключ (они длинные!)
  2. Убедитесь, что ключ активен на syntermedia.ai/developer
  3. Убедитесь, что ключ имеет область действия tools:write

«Нет подключённых рекламных аккаунтов»

Вам необходимо подключить хотя бы одну рекламную платформу:

  1. Перейдите на syntermedia.ai/settings/credentials
  2. Нажмите «Подключить» рядом с Google Ads (или другой платформой)
  3. Завершите авторизацию OAuth

Инструменты не отображаются в Claude/Cursor

  1. Полностью перезапустите ваш ИИ-клиент (не просто обновите)
  2. Проверьте журналы MCP-сервера на наличие ошибок
  3. Проверьте путь к конфигурационному файлу и синтаксис JSON

Часто задаваемые вопросы

Существует ли MCP-сервер для Google Ads?

Да, двух видов. Google выпускает официальный MCP-сервер Google Ads, который в текущей версии доступен только для чтения: он может запрашивать отчёты, метрики и метаданные, но согласно документации Google он «не может изменять ставки, приостанавливать кампании или создавать новые объекты». Наш MCP-сервер охватывает Google Ads как для чтения, так и для записи: создание кампаний Search, Display и Performance Max, добавление ключевых слов и минус-слов, корректировка бюджетов, приостановка кампаний, управление аудиториями Customer Match, настройка отслеживания конверсий и получение данных о производительности. Тот же сервер предоставляет отчёты по 18 другим рекламным платформам и предлагает полное выполнение кампаний на 11 из них.

Могут ли Claude или ChatGPT управлять моими рекламными кампаниями?

Да. С подключённым MCP-сервером Synter клиенты Claude (Claude Desktop, Claude Code), ChatGPT, Cursor и любые другие MCP-совместимые клиенты могут создавать кампании, корректировать бюджеты, приостанавливать неэффективные кампании, генерировать креативы и синхронизировать аудитории на 14 рекламных платформах (действия записи на 16) и получать данные о производительности по всем 19. Claude и другие stdio-клиенты подключаются через npx @synterai/mcp-server с SYNTER_API_KEY; ChatGPT и другие HTTP-клиенты подключаются к удалённому серверу по адресу https://mcp.syntermedia.ai/mcp/ с заголовком X-Synter-Key. Деструктивные действия имеют встроенные подтверждения.

В чём разница между официальным MCP Google Ads и Synter?

Две вещи: доступ на запись и охват платформ. Официальный MCP Google Ads в текущей версии доступен только для чтения и охватывает только Google Ads. Synter предоставляет отчёты по 19 платформам и предлагает полное создание кампаний на 14 из них, включая Google Ads, Meta, LinkedIn, Microsoft, TikTok, Amazon Ads, Amazon DSP, OpenAI Ads и The Trade Desk. Если вам нужны только отчёты Google Ads, официальный сервер — надёжный выбор. Если вам нужен агент, который может действовать на основе найденного, на Google и везде, где вы рекламируетесь, — именно для этого мы создали Synter.


Ресурсы


Лицензия

Лицензия MIT — см. LICENSE для подробностей.


Synter
Расширение MCP, которое они не хотят, чтобы вы использовали.
Потому что ИИ-агенты с рекламными бюджетами меняют всё.