Synter Ads
官方跨平台广告活动管理,支持AI代理在Google、Meta、LinkedIn、Reddit、TikTok等平台操作,提供140余个读写工具。
你可以用 Synter Ads MCP 做什么?
- 跨平台列出广告系列 — 让您的助手使用
list_campaigns展示所有已连接广告账户中的广告系列。 - 创建搜索广告系列 — 让您的助手通过
create_search_campaign构建包含关键词、预算和落地页的 Google 搜索广告系列。 - 暂停表现不佳的广告 — 指示您的助手使用
pause_campaign暂停任何超支或表现不佳的广告系列。 - 调整每日预算 — 使用
update_campaign_budget随时请求更改预算,以扩大或缩减支出。 - 获取效果指标 — 使用
get_performance获取跨平台的展示次数、点击量、支出、转化次数和 ROAS。 - 生成广告创意 — 使用
generate_image和generate_video请求为您的广告系列生成 AI 图像或视频。
文档
Synter MCP Server
最完整的广告 MCP 服务器。
覆盖 19 个广告平台的报告,并在其中 14 个平台上支持完整的广告系列创建(16 个平台支持写入操作),涵盖所有主要购买渠道,并为破坏性操作内置确认机制。
创建广告系列。调整预算。暂停表现不佳的广告。生成创意素材。拉取性能数据。全部通过自然对话完成,支持 Google、Meta、LinkedIn、Microsoft、Reddit、TikTok、X 等平台。
这是第一个为 AI 代理提供信用卡的 Model Context Protocol(MCP)服务器。
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(赞助商品、品牌和展示)、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.2x 竞争对手关键词 98 美元 45 3 1.5x 展示再营销 67 美元 234 8 2.8x "竞争对手关键词"广告系列表现不佳。要我暂停它还是调整定向?
添加否定关键词
你: 我收到了"免费项目管理"的点击,但我们没有免费层级。屏蔽这些。
代理: 已将"免费"作为否定关键词添加到你的广告系列。这将阻止你的广告在包含"免费"的搜索中展示。
生成广告创意
你: 我需要一个营销自动化产品的展示广告图片。深色主题、专业、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 not set"
确保您的 API 密钥位于 MCP 配置的 env 部分中。密钥应以 syn_ 开头。
"Invalid or expired API key"
- 检查您是否复制了完整的密钥(它们很长!)
- 在 syntermedia.ai/developer 验证密钥是否仍然有效
- 确保密钥具有
tools:write权限范围
"No ad accounts connected"
您需要至少连接一个广告平台:
- 前往 syntermedia.ai/settings/credentials
- 点击 Google Ads(或其他平台)旁边的 "Connect"
- 完成 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。