Synter Ads MCP Server
официальныйКроссплатформенное управление рекламными кампаниями для AI-агентов в Google, Meta, LinkedIn, Reddit, TikTok и других. 140+ инструментов с доступом на чтение и запись.
Документация
Synter MCP Server
Расширение MCP, которым Клод не хочет, чтобы вы пользовались.
Потому что как только вы его установите, ваш ИИ-агент сможет тратить реальные деньги.
Создавайте кампании. Корректируйте бюджеты. Приостанавливайте неэффективные. Генерируйте креативы. Получайте данные о производительности. Всё через естественное общение — в Google, Meta, LinkedIn, Microsoft, Reddit, TikTok и других платформах.
Это первый сервер Model Context Protocol (MCP), который дает ИИ-агентам кредитную карту.
Почему Synter?
Большинство рекламных MCP-серверов — только для чтения и одноплатформенные. Synter — единственный кроссплатформенный MCP-сервер для управления рекламой с полными возможностями чтения и записи:
| Функция | Synter | Google Ads MCP | Amazon Ads MCP | Другие |
|---|---|---|---|---|
| Платформы | 9+ (Google, Meta, LinkedIn, Microsoft, Reddit, TikTok, X, StackAdapt, TTD) | Только Google | Только Amazon | 1-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/день |
| B2B, предприятия, соискатели | $25/день | |
| Нишевые сообщества, технически подкованные пользователи | $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 | Возврат на рекламные расходы (доход ÷ расходы) |
Чек-лист первой кампании
Перед созданием первой кампании вам понадобятся:
- ✅ URL целевой страницы, куда перейдут люди после клика
- ✅ Представление о том, кого вы хотите охватить (местоположение, интересы)
- ✅ Дневной бюджет, который вам комфортен ($10-50 для начала)
- ✅ Несколько заголовков и описаний для вашего объявления
Совет профи: Начните с поисковой кампании в Google. Её легче всего понять, и она показывает объявления людям, которые уже ищут то, что вы предлагаете.
Примеры диалогов
Создание первой кампании
Вы: Создай поисковую кампанию Google для моего SaaS-продукта. Нацель на людей, ищущих "ПО для командной работы" и "инструменты управления проектами". Бюджет $25/день. Целевая страница https://myapp.com/signup
Агент: Я создам поисковую кампанию с этими ключевыми словами. Какие заголовки использовать? Вот несколько предложений:
- "Командная работа стала проще"
- "Управление проектами для современных команд"
- "Начните бесплатно — без кредитной карты"
Проверка производительности
Вы: Как идут мои кампании на этой неделе?
Агент: Вот ваша производительность за последние 7 дней:
Кампания Расходы Клики Конверсии ROAS Поиск по бренду $142 89 12 4.2x Ключевые слова конкурентов $98 45 3 1.5x Медийный ретаргетинг $67 234 8 2.8x Кампания "Ключевые слова конкурентов" неэффективна. Хотите, чтобы я приостановил её или скорректировал таргетинг?
Добавление минус-слов
Вы: Я получаю клики по запросу "бесплатное управление проектами", но у нас нет бесплатного тарифа. Заблокируй их.
Агент: Добавил "бесплатное" как минус-слово в вашу кампанию. Это остановит показ ваших объявлений по любому запросу, содержащему "бесплатное".
Генерация рекламного креатива
Вы: Мне нужно медийное рекламное изображение для продукта по автоматизации маркетинга. Тёмная тема, профессиональное, 1200x628.
Агент: Генерирую изображение с помощью Imagen 4...
Создано: "Панель автоматизации маркетинга с визуализацией данных на тёмном фоне" Ресурс сохранён и готов к использованию в вашей следующей медийной кампании.
Подключите рекламные аккаунты
Для управления рекламой на каждой платформе вам нужно подключить аккаунты в Synter:
- Перейдите на syntermedia.ai/settings/credentials
- Нажмите "Подключить" рядом с каждой платформой
- Пройдите процедуру OAuth
- Теперь ваш агент может управлять этой платформой
Поддерживаемые платформы:
- 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-ключ"
- Проверьте, что вы скопировали ключ полностью (они длинные!)
- Убедитесь, что ключ активен на syntermedia.ai/developer
- Убедитесь, что у ключа есть область действия
tools:write
"Нет подключённых рекламных аккаунтов"
Вам нужно подключить хотя бы одну рекламную платформу:
- Перейдите на syntermedia.ai/settings/credentials
- Нажмите "Подключить" рядом с Google Ads (или другой платформой)
- Завершите авторизацию OAuth
Инструменты не отображаются в Claude/Cursor
- Полностью перезапустите ИИ-клиент (не просто обновите)
- Проверьте логи MCP-сервера на наличие ошибок
- Проверьте путь к файлу конфигурации и синтаксис JSON
Ресурсы
- Руководство Synter: syntermedia.ai/manual
- Документация API: docs.syntermedia.ai
- Плагин Claude: github.com/Synter-Media-AI/plugin — навыки, агенты и этот MCP для Claude Code / Desktop
- Справочник инструментов: docs.syntermedia.ai/tools
- Сравнение MCP-серверов: syntermedia.ai/blog/best-ad-platform-mcp-servers
- Бесплатные навыки агента (47 с открытым кодом): github.com/Synter-Media-AI/free-skills — также на skills.sh
- Поддержка: [email protected]
Лицензия
Лицензия MIT — подробности в LICENSE.
Расширение MCP, которым они не хотят, чтобы вы пользовались.
Потому что ИИ-агенты с рекламными бюджетами меняют всё.