SuperAPI AI 工具集

mcp-server

Synter MCP Server 是一个开源的 Model Context Protocol(MCP)服务器,让 AI 智能体能够读取和操作广告账户。它支持在 16 个广告平台上投放广告,包括 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、The Trade Desk、OpenAI Ads(ChatGPT)、Display & Video 360 和 StackAdapt。用户可以通过自然对话创建广告系列、调整预算、暂停表现不佳的广告、生成创意素材以及拉取效果数据。该工具可与 Claude、Cursor、ChatGPT、Amp、VS Code 等 MCP 客户端配合使用。写入类工具带有破坏性标注,MCP 客户端会在执行前进行询问。提供托管服务器和本地 npx 两种使用方式,并支持无凭据的演示沙箱模式。

访问官网

工具介绍

用途

Synter MCP Server 是一个开源的 Model Context Protocol(MCP)服务器,目标是让 AI 智能体能够读取和运行广告账户。用户可以通过自然对话完成创建广告系列、调整预算、暂停表现不佳的广告、生成创意素材以及拉取效果数据等操作。

主要能力

  • 覆盖 16 个广告平台: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(Sponsored Products、Brands 和 Display)、Amazon DSP、The Trade Desk、OpenAI Ads(ChatGPT)、Display & Video 360、StackAdapt。
  • 在大多数平台上支持完整的广告系列创建。Display & Video 360 和 StackAdapt 支持写入操作(暂停、预算和广告项更新、受众上传),但不支持广告系列创建。少数零售媒体网络仅接入用于报告。
  • 能力范围包括:广告系列管理、效果与分析、关键词与定向、转化跟踪、创意生成。
  • 兼容 Claude、Cursor、ChatGPT、Amp、VS Code 等 MCP 客户端。
  • 托管服务器暴露完整托管工具集,npx 包提供常见操作的带类型工具,并可通过 run_tool 访问 140+ Synter 工具的完整目录。

使用方式

托管安装(浏览器登录)

托管服务器位于 https://mcp.synterai.com 。将其添加到客户端,首次使用时通过浏览器登录(OAuth,支持动态客户端注册和 PKCE,符合 MCP 授权规范)。无需复制 API key,无需本地安装。注册为自助服务:在 synterai.com/sign-up 注册,连接广告账户后即可使用。

快速试用(无需凭据):运行 npx @synterai/mcp-server --demo(或设置 SYNTER_DEMO=true)可探索广告系列、查看性能指标,并使用高保真沙箱数据模拟变更,无需账户或 API key。

客户端配置示例:

  • Cursor:使用 cursor://anysphere.cursor-deeplink/mcp/install?name=synter-ads&config=eyJ1cmwiOiJodHRwczovL21jcC5zeW50ZXJhaS5jb20ifQ==
  • VS Code:使用 vscode:mcp/install?%7B%22name%22%3A%22synter-ads%22%2C%22type%22%3A%22http%22%2C%22url%22%3A%22https%3A%2F%2Fmcp.synterai.com%22%7D
  • Claude.ai / ChatGPT:添加自定义连接器,URL 为 https://mcp.synterai.com ,按提示登录。

本地 stdio(npx)/ API-key 回退

适用于客户端仅支持 stdio,或无头运行无法完成浏览器登录的场景。

  1. 获取 API Key:在 synterai.com/sign-up 注册,API key 自动创建,可在 Developer Settings 中查看或创建更多。
  2. 配置 AI 客户端,例如 Claude Desktop 添加到 ~/Library/Application Support/Claude/claude_desktop_config.json;Cursor 添加到项目中的 .cursor/mcp.json;VS Code / Cline 添加到 cline_mcp_settings.json;Windsurf 添加到 ~/.codeium/windsurf/mcp_config.json;Amp 添加到 .amp/settings.json。
  3. 重启客户端并开始对话。

需要 header 而非 OAuth 的 HTTP 客户端(n8n、Zapier、脚本等)可使用 header,header 为可选项,浏览器 OAuth 是默认方式,支持 Streamable HTTP 传输的 MCP 客户端均可使用。

插件方式(Claude Code / Claude Desktop)

此包为原始 MCP 服务器。若使用 Claude Code 或 Claude Desktop,Synter 插件在同一个服务器基础上提供现成技能(/synter:launch、/synter:audience、/synter:optimize 等)、专用智能体和消费前审批安全钩子,并附带用于自动化的无头 Claude Agent SDK 运行器。

适用场景

适用于希望通过 AI 智能体以自然语言管理多平台广告投放的广告主、营销团队和开发者,包括创建广告系列、查看效果、调整预算、添加否定关键词、生成展示广告创意、连接广告账户等操作。

连接广告账户:在 synterai.com/settings/credentials 点击各平台旁的 Connect,完成 OAuth 流程后,智能体即可管理该平台。

限制与安全

  • 官方包仅为 @synterai/mcp-server、@synterai/sdk-js、PyPI synter、crates.io synter、Maven ai.syntermedia:synter-sdk。@iflow-mcp/* 副本为非官方且过时。
  • 破坏性工具会被标注,MCP 客户端会在运行前询问。
  • 客户端侧只读标志(--read-only / SYNTER_READ_ONLY=true)会从工具清单中完全取消注册变更类工具并在本地阻止。
  • 服务器端写入闸门:即使智能体尝试未授权变更,Synter 中央网关会以 402 PAYMENT_METHOD_REQUIRED 拒绝未验证/无卡调用者的变更调用。
  • 隐私:客户广告凭据、性能指标、转化负载和搜索词不会被 Synter 或其子处理者用于训练或微调模型;广告平台 OAuth token 使用 AES-256 与 KMS 静态加密,token 不会传入 LLM 提示上下文;100% 工具执行记录调用者身份、IP、工具名称、延迟和成本;结构化 schema 在派发前严格校验所有参数。
  • Synter Ångström 会对每个变更和观察通过探测实时提供商 API 验证有效状态、可服务性(RUNNABLE)、投放状态和约束是否匹配请求意图。
  • 定价:免费诊断读取层($0.00 / 0 credits)可连接广告账户、查看广告系列、拉取指标和审计跟踪,无需信用卡。付费广告系列执行通过订阅层计费:SOLO $20/月($200/年),包含 $20.00 可领取月度积分;SCALE $500/月($5,000/年),包含 $500.00 可领取月度积分;CUSTOM 为销售主导的企业合同,含专用容量。
  • 托管服务器使用浏览器 OAuth,无需环境变量;环境变量仅适用于本地 npx 服务器。