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 服务器
最完整的广告 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_image | AI 生成广告图片 |
generate_video | AI 生成视频广告 |
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 软件”→ 您的广告出现
展示广告系列: 在网站和应用中展示的图片广告。
- 示例: 新闻网站上的横幅广告
Performance Max(PMax): Google 的 AI 会在各处展示您的广告(搜索、YouTube、展示、Gmail、地图)。
- 示例: Google 为您找到最佳展示位置
视频广告系列: 在 YouTube 及合作网站上的视频广告。
- 示例: YouTube 视频前的 15 秒广告
常用术语
| 术语 | 含义 |
|---|---|
| 展示次数 | 您的广告被展示的次数 |
| 点击量 | 点击您广告的人数 |
| CTR | 点击率(点击量 ÷ 展示次数 × 100) |
| CPC | 每次点击成本 |
| 转化次数 | 期望的操作(注册、购买等) |
| ROAS | 广告支出回报率(收入 ÷ 花费) |
首个广告系列清单
在创建第一个广告系列之前,您需要:
- ✅ 一个落地页 URL,用户点击后将跳转至此
- ✅ 明确您想触达的人群(地理位置、兴趣)
- ✅ 一个您能接受的每日预算(从 10-50 美元开始)
- ✅ 一些广告标题和描述
专业提示: 从 Google 上的搜索广告系列开始。它最容易理解,并且会向已经在寻找您所提供产品的人展示广告。
示例对话
创建您的第一个广告系列
您: 为我的 SaaS 产品创建一个 Google 搜索广告系列。定向搜索“团队协作软件”和“项目管理工具”的人群。预算为 25 美元/天。落地页是 https://myapp.com/signup
智能体: 我将使用这些关键词创建一个搜索广告系列。您想使用哪些标题?以下是一些建议:
- “让团队协作变得简单”
- “面向现代团队的项目管理”
- “免费开始 - 无需信用卡”
查看效果
您: 我这周的广告系列表现如何?
智能体: 以下是您过去 7 天的效果数据:
广告系列 花费 点击量 转化次数 ROAS 品牌搜索 142 美元 89 12 4.2 倍 竞争对手关键词 98 美元 45 3 1.5 倍 展示再营销 67 美元 234 8 2.8 倍 “竞争对手关键词”广告系列表现不佳。您希望我暂停它还是调整定向?
添加否定关键词
您: 我收到了“免费项目管理”的点击,但我们没有免费套餐。屏蔽这些词。
智能体: 已将“免费”添加为您的广告系列的否定关键词。这将阻止您的广告在包含“免费”的搜索中展示。
生成广告创意
您: 我需要一个营销自动化产品的展示广告图片。深色主题、专业、1200x628。
智能体: 正在生成您的图片...
已创建:“深色背景上的营销自动化仪表盘与数据可视化” 素材已保存,可在您的下一个展示广告系列中使用。
连接您的广告账户
要在每个平台上管理广告,您需要在 Synter 中连接您的账户:
- 前往 syntermedia.ai/settings/credentials
- 点击每个平台旁边的“连接”
- 完成 OAuth 流程
- 您的智能体现在可以管理该平台
支持的平台(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 密钥无效或已过期”
- 检查你是否复制了完整的密钥(它们很长!)
- 在 syntermedia.ai/developer 验证密钥是否处于激活状态
- 确保密钥具有
tools:write权限范围
“未连接任何广告账户”
你需要至少连接一个广告平台:
- 前往 syntermedia.ai/settings/credentials
- 点击 Google Ads(或其他平台)旁边的“连接”
- 完成 OAuth 授权
工具未在 Claude/Cursor 中显示
- 完全重启你的 AI 客户端(不仅仅是刷新)
- 检查 MCP 服务器日志中的错误
- 验证配置文件路径和 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 的目的。
资源
- Synter 手册: syntermedia.ai/manual
- API 文档: docs.syntermedia.ai
- Claude 插件: github.com/Synter-Media-AI/plugin(适用于 Claude Code / Desktop 的技能、智能体及此 MCP)
- 工具参考: docs.syntermedia.ai/tools
- MCP 服务器对比: syntermedia.ai/blog/best-ad-platform-mcp-servers
- 免费智能体技能(47 个开源): github.com/Synter-Media-AI/free-skills(也可在 skills.sh 上获取)
- 支持: hello@syntermedia.ai
许可证
MIT 许可证——详情请参阅 LICENSE。