Synter Ads

官方

跨平台广告活动管理,支持AI代理在Google、Meta、LinkedIn、Reddit、TikTok等平台操作,提供140余个读写工具。

你可以用 Synter Ads MCP 做什么?

  • 跨平台列出广告系列 — 让助手通过 list_campaigns 从关联的广告账户中拉取所有广告系列。
  • 创建搜索广告系列 — 使用 create_search_campaign 启动一个包含关键词、广告和预算的 Google 搜索广告系列。
  • 暂停表现不佳的广告系列 — 当花费或 ROAS 异常时,通过 pause_campaign 立即停止任何广告系列。
  • 拉取效果指标 — 使用 get_performance 获取展示次数、点击量、花费、转化次数和 ROAS。
  • 生成广告创意 — 让 generate_image 或 generate_video 生成可直接上传的广告素材。
  • 运行 140 多种工具中的任意一种 — 通过 run_tool 直接访问完整的 Synter 目录,执行高级操作。

文档

Synter MCP 服务器

npm version License: MIT

最完整的广告 MCP 服务器。

覆盖 19 个广告平台的报告功能,并在其中 14 个平台上支持完整的广告系列创建(16 个平台支持写入操作),涵盖所有主要购买渠道,并为破坏性操作内置确认机制。

创建广告系列。调整预算。暂停表现不佳的广告。生成创意素材。拉取效果数据。全部通过自然对话完成,覆盖 Google、Meta、LinkedIn、Microsoft、Reddit、TikTok、X 等平台。

这是首个为 AI 智能体提供“信用卡”的 Model Context Protocol(MCP)服务器。

注意: Synter-Media-AI/plugin 是官方可安装的 Claude 插件仓库。本仓库中的 .claude-plugin/ 副本并非安装源。


Synter 对比

官方 Google Ads MCP 服务器在设计上为只读:根据 Google 的文档,它“严格只读”,且“无法修改出价、暂停广告系列或创建新资产”。大多数第三方广告 MCP 服务器仅覆盖单一平台。我们构建 Synter 是为了在一个服务器上完成这两项工作,覆盖所有主要购买渠道。

Synter MCP官方 Google Ads MCP典型第三方广告 MCP
访问权限19 个平台全部可读,14 个平台支持广告系列创建,16 个平台支持写入操作只读(当前版本)通常只读或部分写入
平台19 个平台支持报告,14 个平台支持完整广告系列创建(见下方列表)仅 Google Ads通常为单一平台
创建广告系列✅ Google 搜索、展示、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 密钥。

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 或任何支持 HTTP 传输的 MCP 客户端:

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

无需本地安装。适用于任何支持 Streamable HTTP 传输的 MCP 客户端。

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

它还附带一个无头 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为 B2B 创建 LinkedIn 广告系列
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)年长人群、B2B10 美元/天
TikTokZ 世代、娱乐、电商20 美元/天

广告系列类型说明

搜索广告系列: 当有人在 Google 上搜索特定关键词时,您的广告会显示。

  • 示例: 有人搜索“最佳 CRM 软件”→ 您的广告出现

展示广告系列: 在网站和应用中展示的图片广告。

  • 示例: 新闻网站上的横幅广告

Performance Max(PMax): Google 的 AI 会在各处展示您的广告(搜索、YouTube、展示、Gmail、地图)。

  • 示例: Google 为您找到最佳展示位置

视频广告系列: 在 YouTube 及合作网站上的视频广告。

  • 示例: YouTube 视频前的 15 秒广告

常用术语

术语含义
展示次数您的广告被展示的次数
点击量点击您广告的人数
CTR点击率(点击量 ÷ 展示次数 × 100)
CPC每次点击成本
转化次数期望的操作(注册、购买等)
ROAS广告支出回报率(收入 ÷ 花费)

首个广告系列清单

在创建第一个广告系列之前,您需要:

  1. ✅ 一个落地页 URL,用户点击后将跳转至此
  2. ✅ 明确您想触达的人群(地理位置、兴趣)
  3. ✅ 一个您能接受的每日预算(从 10-50 美元开始)
  4. ✅ 一些广告标题和描述

专业提示: 从 Google 上的搜索广告系列开始。它最容易理解,并且会向已经在寻找您所提供产品的人展示广告。


示例对话

创建您的第一个广告系列

您: 为我的 SaaS 产品创建一个 Google 搜索广告系列。定向搜索“团队协作软件”和“项目管理工具”的人群。预算为 25 美元/天。落地页是 https://myapp.com/signup

智能体: 我将使用这些关键词创建一个搜索广告系列。您想使用哪些标题?以下是一些建议:

  • “让团队协作变得简单”
  • “面向现代团队的项目管理”
  • “免费开始 - 无需信用卡”

查看效果

您: 我这周的广告系列表现如何?

智能体: 以下是您过去 7 天的效果数据:

广告系列花费点击量转化次数ROAS
品牌搜索142 美元89124.2 倍
竞争对手关键词98 美元4531.5 倍
展示再营销67 美元23482.8 倍

“竞争对手关键词”广告系列表现不佳。您希望我暂停它还是调整定向?

添加否定关键词

您: 我收到了“免费项目管理”的点击,但我们没有免费套餐。屏蔽这些词。

智能体: 已将“免费”添加为您的广告系列的否定关键词。这将阻止您的广告在包含“免费”的搜索中展示。

生成广告创意

您: 我需要一个营销自动化产品的展示广告图片。深色主题、专业、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是你的 Synter API 密钥
SYNTER_API_URL否API URL 覆盖(默认: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 密钥位于 MCP 配置的 env 部分。密钥应以 syn_ 开头。

“API 密钥无效或已过期”

  1. 检查你是否复制了完整的密钥(它们很长!)
  2. 在 syntermedia.ai/developer 验证密钥是否处于激活状态
  3. 确保密钥具有 tools:write 权限范围

“未连接任何广告账户”

你需要至少连接一个广告平台:

  1. 前往 syntermedia.ai/settings/credentials
  2. 点击 Google Ads(或其他平台)旁边的“连接”
  3. 完成 OAuth 授权

工具未在 Claude/Cursor 中显示

  1. 完全重启你的 AI 客户端(不仅仅是刷新)
  2. 检查 MCP 服务器日志中的错误
  3. 验证配置文件路径和 JSON 语法

常见问题

有适用于 Google Ads 的 MCP 服务器吗?

有,分为两种。Google 官方发布了一个 Google Ads MCP 服务器,其当前版本为只读:它可以查询报告、指标和元数据,但根据 Google 的文档,它“无法修改出价、暂停广告系列或创建新资产”。我们的 MCP 服务器对 Google Ads 同时支持读写:可以创建搜索、展示和效果最大化广告系列,添加关键词和否定关键词,调整预算,暂停广告系列,管理 Customer Match 受众,设置转化跟踪,并拉取效果数据。同一服务器还覆盖其他 18 个广告平台,并在其中 11 个平台上提供完整的广告系列执行功能。

Claude 或 ChatGPT 可以管理我的广告系列吗?

可以。连接 Synter MCP 服务器后,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 请求头。破坏性操作内置了确认机制。

官方 Google Ads MCP 与 Synter 有什么区别?

两点:写入权限和平台覆盖范围。官方 Google Ads MCP 当前版本为只读,且仅覆盖 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 扩展。
因为拥有广告预算的 AI 智能体将改变一切。