AdLoop Cloud MCP Server已验证已精选

什么是 AdLoop Cloud MCP Server？

AdLoop Cloud MCP Server 是开源 AdLoop MCP 服务器的托管版本。它把 Google Ads、Reddit Ads、GA4、Tag Manager、Search Console、Merchant Center 和 PageSpeed 连接到 claude.ai、ChatGPT、Claude Code、Cursor 等 MCP 客户端，并在每次更改生效前先给出预览。

AdLoop Cloud 替你处理 Google API 访问和 OAuth，因此你不需要自己的 Google Cloud 项目。端点为 https://mcp.getadloop.com/mcp。自托管版本以 MIT 许可证发布在 GitHub（kLOsk/adloop），运行相同的工具和相同的安全模型。

如何使用 AdLoop Cloud MCP Server？

1. 在 getadloop.com 注册。免费套餐包含一个 Ads 账户和一个 GA4 媒体资源，无需信用卡。
2. 在引导向导中连接 Google、Reddit 或两者，并选择允许 AI 访问的账户。AdLoop Cloud 已通过 Google 验证，因此你看到的是 Google 的标准授权对话框。
3. 向导会创建你的第一个 API 密钥（alc_...），只显示一次。之后可以在 Settings → API keys 中查看、限制或撤销密钥。
4. 连接你的 AI 客户端。你可以在浏览器中通过 OAuth 登录，也可以把 API 密钥作为 bearer 请求头发送。

Claude Code

使用 API 密钥：

claude mcp add --transport http adloop https://mcp.getadloop.com/mcp \
  --header "Authorization: Bearer YOUR_ADLOOP_API_KEY"

也可以不加请求头添加服务器，然后运行 /mcp，选择 AdLoop 并点击 Authenticate。浏览器会打开 AdLoop 的授权页面。

Claude Desktop / claude.ai

Free、Pro 和 Max 套餐：进入 Customize → Connectors → Add custom connector。Team 和 Enterprise 套餐：由 Owner 在 Organization settings → Connectors → Add → Custom → Web 中添加。输入 https://mcp.getadloop.com/mcp，然后用你的 AdLoop Cloud 账户登录并批准连接。该连接器也可在 Claude Desktop 和移动应用中使用。

Cursor

将以下内容添加到 .cursor/mcp.json 或 ~/.cursor/mcp.json：

{
  "mcpServers": {
    "adloop": {
      "url": "https://mcp.getadloop.com/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_ADLOOP_API_KEY"
      }
    }
  }
}

如需使用 OAuth，去掉 headers，并在 Cursor 的 MCP 设置中登录。

VS Code

使用 Copilot 的 agent 模式，并把服务器添加到 .vscode/mcp.json。使用 OAuth 时，VS Code 会在首次使用时打开 AdLoop 的授权页面：

{
  "servers": {
    "adloop": {
      "type": "http",
      "url": "https://mcp.getadloop.com/mcp"
    }
  }
}

要检查任意连接，可以问：“Run the AdLoop health check.”

AdLoop Cloud MCP Server 的主要功能

• Google Ads：广告系列、关键字、搜索字词、广告和效果最大化（Performance Max）报告，以及 Keyword Planner 研究和对搜索广告系列的预览式修改。
• Reddit Ads：第二个广告平台，使用相同的工具和相同的安全模型。
• GA4、Tag Manager 和跟踪审计：对比网站代码发送的数据与 GTM 和 GA4 实际记录的数据。
• 服务端安全机制：每次写入都返回带 plan_id 的预览。默认开启试运行（dry run），新广告系列和广告以暂停状态创建，并有预算和出价上限。
• 审批卡片：在支持 MCP Apps 的客户端中，只有你点击卡片才能应用更改。AI 无法通过输入“yes”来应用。
• 受限密钥：只读密钥、限定工具集的密钥，以及 Agency 套餐中限定单个客户的密钥。

AdLoop Cloud MCP Server 工具

docs.getadloop.com 上的工具参考把工具分为以下工具集：ads、ga4、tracking、gtm、gsc、web、merchant 和 reddit。

• 读取与报告：get_campaign_performance、get_keyword_performance、get_search_terms、get_pmax_performance、get_reddit_performance、get_merchant_feed_health、analyze_page_speed。
• 跨渠道分析：analyze_campaign_conversions、landing_page_analysis 和 attribution_check 把 Ads 和 GA4 数据结合起来。audit_event_coverage 用于检查跟踪。
• 规划：discover_keywords 和 estimate_budget。
• 草稿：draft_campaign、draft_responsive_search_ad、draft_keywords、draft_sitelinks、add_negative_keywords、draft_reddit_campaign 等。每个都只返回预览。
• 应用与控制：confirm_and_apply（默认 dry_run=true）、pause_entity、enable_entity，以及 health_check 和 list_accounts。

AdLoop Cloud MCP Server 的使用场景

• 浪费的预算：“哪些搜索字词在浪费预算？把它们添加为否定关键字。”
• 转化下降：“我的注册量下降了。检查 Ads、GA4 和 Tag Manager，找出原因。”
• 着陆页：“哪些着陆页有付费流量但没有转化？”
• 跨平台：“上周我的 Reddit 广告系列和 Google Ads 相比表现如何？”

AdLoop Cloud MCP Server 常见问题排查

• claude.ai 中看不到新工具。claude.ai 会缓存连接器的工具列表。在 Settings → Connectors → AdLoop 中刷新。
• “This API key is limited to the toolsets…”该密钥创建时限制了工具集。请使用包含该工具集的密钥，或新建一个。
• 达到每日操作上限。Google Ads 和 Reddit Ads 调用共享一个每日上限，在 UTC 午夜重置。Analytics、Tag Manager、Search Console 和 Merchant Center 仍可继续使用。
• 写入被拒绝或出现 DRY_RUN_FAILED。安全上限或广告平台拒绝了该更改，消息中会说明原因。解决问题后重新起草更改。