JinDaGe - ads-mcp MCP Details

article

README

🚀 广告MCP

广告MCP（Ads MCP）是一个远程模型上下文协议（MCP）服务器，用于广告活动规划、研究以及跨平台广告创建。在推出时，它支持谷歌广告搜索和效果最大化（Google Ads Search & Performance Max）以及TikTok广告，后续还计划支持更多广告网络。

🚀 快速开始

快速链接

MCP远程URL（SSE）：https://mcp.adspirer.com/
备用URL：https://adspirer-mcp-596892545013.us-central1.run.app/
注册表ID：com.adspirer/ads
身份验证：通过Adspirer进行OAuth 2.1身份验证（服务器端实施付费层级和速率限制）
网站：https://www.adspirer.com/
支持：abhi@adspirer.com

✨ 主要特性

结构化规划：使用结构化提示来规划和验证广告活动。
创意生成：生成创意变体并组装符合要求的素材包。
跨平台创建：在支持MCP的客户端内端到端地创建谷歌广告搜索和效果最大化广告活动，以及TikTok广告活动。
实时进度更新：针对长时间运行的操作（5 - 30秒）提供实时进度更新。

🛠️ 工具

素材管理

help_user_upload：返回清晰的说明，指导用户提供适合摄取的直接媒体链接。
validate_and_prepare_assets：从提供的URL下载并验证媒体；返回一个asset_bundle_id。当客户端支持时，会流式传输进度（通常处理5 - 10张图片需要5 - 15秒）。

广告活动创建

create_pmax_campaign：原子化的效果最大化广告活动创建（采用先验证后提交的模式）。当支持时，会流式传输进度（通常需要15 - 30秒）。
create_search_campaign：以文本为先的搜索广告活动创建，可选择添加素材。

📦 安装指南

连接到ChatGPT

打开设置 → 连接器 → 创建。
名称：广告MCP。
URL：https://mcp.adspirer.com/。
按照OAuth 2.1进行登录；你会看到Adspirer作为应用程序。
首次使用时链接你的广告账户。
自然地询问来使用工具（例如，“为……创建一个效果最大化广告活动”）。

连接到Claude

打开设置 → 连接器 → 添加自定义。
名称：广告MCP。
URL：https://mcp.adspirer.com/。
完成OAuth 2.1登录。
根据需要调用工具。

💻 使用示例

验证流式传输示例

curl -i -N https://mcp.adspirer.com/mcp/tools/call \
  -H 'Content-Type: application/json' \
  -d '{
    "jsonrpc":"2.0",
    "id":2,
    "method":"tools/call",
    "params":{
      "name":"validate_and_prepare_assets",
      "_meta":{"progressToken":"tok-123"},
      "arguments":{
        "marketing_images_square":["https://example.com/image.jpg"]
      }
    }
  }'

你应该会看到几个event: message进度帧，然后在同一流上看到最终的JSON-RPC结果。

📚 详细文档

🔧 技术细节

协议：MCP 2025 - 03 - 26（可回退到2024 - 11 - 05）。
传输：支持进度流式传输的HTTP + SSE。
OAuth：采用RFC 8252（授权码 + PKCE）和RFC 9728（受保护资源元数据）。
进度：即使没有进度令牌，也会提供稀疏的状态消息。
监控：全面的日志记录，包含令牌使用情况和持续时间指标。

📞 支持

电子邮件：abhi@adspirer.com
网站：https://www.adspirer.com/
问题反馈：https://github.com/adspirer/ads-mcp/issues

🔒 安全

有关漏洞报告和安全策略，请参阅SECURITY.md。

📄 许可证

专有许可证 - 有关使用条款，请参阅使用条款。

ads-mcp