Synter Ads MCP Server

официальный

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

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

Synter MCP Server

npm version License: MIT

Расширение MCP, которым Клод не хочет, чтобы вы пользовались.

Потому что как только вы его установите, ваш ИИ-агент сможет тратить реальные деньги.

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

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


Почему Synter?

Большинство рекламных MCP-серверов — только для чтения и одноплатформенные. Synter — единственный кроссплатформенный MCP-сервер для управления рекламой с полными возможностями чтения и записи:

ФункцияSynterGoogle Ads MCPAmazon Ads MCPДругие
Платформы9+ (Google, Meta, LinkedIn, Microsoft, Reddit, TikTok, X, StackAdapt, TTD)Только GoogleТолько Amazon1-2
Создание кампаний❌ Только чтение✅ Только Amazon
Корректировка бюджетов
Приостановка кампаний
Генерация креативов ИИ✅ (Imagen 4, Veo, Flux)
Оптимизация ставок
ИИ-стратег
Открытый исходный кодПо-разному

Один MCP-сервер. Все рекламные платформы. Чтение и запись.


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

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

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

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


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

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

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

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

Для 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. Начните использовать

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

"Покажи все мои кампании 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

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


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

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

ИнструментОписание
list_campaignsСписок кампаний на всех подключённых платформах
create_search_campaignСоздать поисковую кампанию Google с ключевыми словами и объявлениями
create_display_campaignСоздать кампанию Google Display с изображениями
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_imageИИ-генерация рекламных изображений (Imagen 4, Flux, SDXL)
generate_videoИИ-генерация видеорекламы (Veo, Runway, Luma)
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, развлечения, электронная коммерция$20/день

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

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

  • Пример: Кто-то ищет "лучшее ПО для CRM" → Появляется ваше объявление

Медийные кампании (Display) — Графические объявления, показываемые на сайтах и в приложениях.

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

Performance Max (PMax) — ИИ Google показывает ваши объявления везде (Поиск, YouTube, Display, 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.

Агент: Генерирую изображение с помощью Imagen 4...

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


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

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

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

Поддерживаемые платформы:

  • Google Ads ✅
  • Meta (Facebook/Instagram) ✅
  • LinkedIn Ads ✅
  • Microsoft Ads (Bing) ✅
  • Reddit Ads ✅
  • TikTok Ads ✅
  • X (Twitter) Ads ✅
  • StackAdapt ✅
  • The Trade Desk ✅

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

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

> Use run_tool to call google_ads_list_audiences

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

> What tools are available for LinkedIn Ads?

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

ПеременнаяОбязательнаОписание
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

Ресурсы


Лицензия

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


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