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_imagegenerate_video 请求为您的广告系列生成 AI 图像或视频。

文档

Synter MCP Server

npm version License: MIT

最完整的广告 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.jsonmanifest.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 CodeClaude DesktopSynter 插件 用现成的技能(/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.2x
竞争对手关键词98 美元4531.5x
展示再营销67 美元23482.8x

"竞争对手关键词"广告系列表现不佳。要我暂停它还是调整定向?

添加否定关键词

你: 我收到了"免费项目管理"的点击,但我们没有免费层级。屏蔽这些。

代理: 已将"免费"作为否定关键词添加到你的广告系列。这将阻止你的广告在包含"免费"的搜索中展示。

生成广告创意

你: 我需要一个营销自动化产品的展示广告图片。深色主题、专业、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_URLAPI 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"

  1. 检查您是否复制了完整的密钥(它们很长!)
  2. syntermedia.ai/developer 验证密钥是否仍然有效
  3. 确保密钥具有 tools:write 权限范围

"No ad accounts connected"

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

  1. 前往 syntermedia.ai/settings/credentials
  2. 点击 Google Ads(或其他平台)旁边的 "Connect"
  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 智能体将改变一切。