Synter Ads MCP Server

官方

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

GitHub
12

文档

Synter MCP 服务器

npm version License: MIT

Claude 不想让你用的 MCP 扩展。

因为一旦安装，你的 AI 代理就能花真金白银。

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

这是首个赋予 AI 代理信用卡权限的 模型上下文协议 (MCP) 服务器。

为什么选择 Synter？

大多数广告 MCP 服务器都是只读且单平台的。Synter 是唯一具备完整读写能力的跨平台广告管理 MCP 服务器：

功能SynterGoogle Ads MCPAmazon Ads MCP其他
平台9+ (Google, Meta, LinkedIn, Microsoft, Reddit, TikTok, X, StackAdapt, TTD)仅 Google仅 Amazon1-2 个
创建广告系列✅❌ 只读✅ 仅 Amazon❌
调整预算✅❌✅❌
暂停广告系列✅❌✅❌
AI 创意生成✅ (Imagen 4, Veo, Flux)❌❌❌
出价优化✅❌❌❌
AI 策略师✅❌❌❌
开源✅✅❌不一

一个 MCP 服务器。所有广告平台。读和写。

⚠️ 郑重警告

你的 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"
      }
    }
  }
}

远程 (可流式传输的 HTTP) — 适用于 ChatGPT、n8n、Zapier 或任何支持 HTTP 传输的 MCP 客户端：

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

无需本地安装。适用于任何支持 可流式传输的 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创建效果最大化广告系列
create_meta_campaign创建 Facebook/Instagram 广告系列
create_linkedin_campaign创建面向 B2B 的 LinkedIn 广告系列
create_reddit_campaign创建 Reddit 广告系列
pause_campaign暂停任何广告系列
update_campaign_budget更改每日预算

📈 效果与分析

工具描述
get_performance获取展示次数、点击次数、花费、转化次数、广告支出回报率
get_daily_spend按平台划分的每日支出明细

🎯 关键词与定位

工具描述
add_keywords向广告系列或广告组添加关键词
add_negative_keywords屏蔽不需要的搜索词

🔄 转化跟踪

工具描述
create_conversion设置转化操作
list_conversions列出现有的转化操作
diagnose_tracking检查跟踪代码是否正确安装

🎨 创意生成

工具描述
generate_imageAI 生成广告图片 (Imagen 4, Flux, SDXL)
generate_videoAI 生成视频广告 (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/天
LinkedInB2B、企业、求职者$25/天
Reddit小众社区、精通技术的用户$5/天
Microsoft (Bing)年长人群、B2B$10/天
TikTokZ 世代、娱乐、电子商务$20/天

广告系列类型说明

搜索广告系列 — 当有人在 Google 上搜索特定关键词时，你的广告会显示。

  • 示例： 有人搜索"最佳 CRM 软件" → 你的广告出现

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

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

效果最大化广告系列 (PMax) — Google 的 AI 会在所有地方展示你的广告（搜索、YouTube、展示、Gmail、地图）。

  • 示例： Google 为你找出最佳展示位置

视频广告系列 — YouTube 和合作伙伴网站上的视频广告。

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

常用术语

术语含义
展示次数你的广告被展示的次数
点击次数有多少人点击了你的广告
点击率点击率 (点击次数 ÷ 展示次数 × 100)
每次点击费用每次点击的成本
转化次数期望的操作（注册、购买等）
广告支出回报率广告支出回报率 (收入 ÷ 支出)

首个广告系列清单

在创建你的第一个广告系列之前，你需要：

  1. ✅ 一个着陆页 URL，人们点击后会跳转到那里
  2. ✅ 了解你想触达的人群（位置、兴趣）
  3. ✅ 一个你能接受的每日预算（开始时 $10-50）
  4. ✅ 一些广告的标题和描述

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

对话示例

创建你的第一个广告系列

你： 为我的 SaaS 产品创建一个 Google 搜索广告系列。定位搜索"团队协作软件"和"项目管理工具"的人。预算是 $25/天。着陆页是 https://myapp.com/signup

代理： 我将使用这些关键词创建一个搜索广告系列。我应该使用哪些标题？以下是一些建议：

  • "团队协作，化繁为简"
  • "现代团队的项目管理"
  • "免费开始 - 无需信用卡"

检查效果

你： 这周我的广告系列表现如何？

代理： 以下是过去 7 天的效果数据：

广告系列花费点击次数转化次数广告支出回报率
品牌搜索$14289124.2x
竞品关键词$984531.5x
展示再营销$6723482.8x

"竞品关键词"广告系列表现不佳。需要我暂停它还是调整定位？

添加否定关键词

你： 我收到了"免费项目管理"的点击，但我们没有免费版本。屏蔽这些词。

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

生成广告创意

你： 我需要一个营销自动化产品的展示广告图片。深色主题，专业风格，1200x628。

代理： 正在使用 Imagen 4 生成你的图片...

已创建："深色背景上带有数据可视化的营销自动化仪表板" 素材已保存，可在你的下一个展示广告系列中使用。

连接你的广告账户

要在每个平台上管理广告，你需要在 Synter 中连接你的账户：

  1. 前往 syntermedia.ai/settings/credentials
  2. 点击每个平台旁边的"连接"
  3. 完成 OAuth 流程
  4. 你的代理现在可以管理该平台了

支持的平台：

  • 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是你的 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 语法

资源

许可证

MIT 许可证 - 详情请参阅 LICENSE。

Synter
他们不想让你用的 MCP 扩展。
因为拥有广告预算的 AI 代理会改变一切。