Ads MCP

🚀 廣告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

1. 打開設置 → 連接器 → 創建。
2. 名稱：廣告MCP。
3. URL：https://mcp.adspirer.com/。
4. 按照OAuth 2.1進行登錄；你會看到Adspirer作為應用程序。
5. 首次使用時鏈接你的廣告賬戶。
6. 自然地詢問來使用工具（例如，“為……創建一個效果最大化廣告活動”）。

連接到Claude

1. 打開設置 → 連接器 → 添加自定義。
2. 名稱：廣告MCP。
3. URL：https://mcp.adspirer.com/。
4. 完成OAuth 2.1登錄。
5. 根據需要調用工具。

💻 使用示例

驗證流式傳輸示例

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結果。

📚 詳細文檔

• 快速入門指南
• ChatGPT連接器設置
• Claude連接器設置
• 故障排除
• 更新日誌
• 隱私政策
• 使用條款

🔧 技術細節

• 協議：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。

📄 許可證

專有許可證 - 有關使用條款，請參閱使用條款。