Google Ads MCP

这是一个远程托管服务。 无需克隆、安装或运行任何内容。将 MCP 客户端指向下方的端点并登录即可。此代码库仅包含连接设置和文档；服务由 AdPlug 运营。

端点

https://api.adplug.app/mcp/google-ads

功能

通过 AI 助手使用日常语言管理和分析 Google Ads：获取整个 MCC 的支出和转化报告、研究关键词、编写原始 GAQL，并在提交任何更改前通过预览步骤安全地进行修改。费用会附带货币符号，账户名称始终与 ID 一起显示，并且会自动检测 MCC 父账户，因此你很少需要使用 login_customer_id。

由 PPC 资深从业者打造

你好，我是 Daniel Popa，AdPlug 的创始人。我在效果营销领域已有 10 多年的经验，管理过超过 1 亿美元的广告预算，为 Coca-Cola、Rolex、Boots、British Gas、Europcar、O2 和 SeedLegals 等品牌开展付费获客和转化优化。

我至今仍每天投放 Google Ads 和 LinkedIn Ads。打造这个服务，是因为我厌倦了在日常思考所用的 AI 和工作中使用的广告平台之间来回切换。这不是一个通用的 API 包装器。每个工具都是因为我在实际账户中需要它才创建的：一次调用即可查看跨账户支出概况、自动处理 GAQL 细分的转化报告，以及在更改影响真实账户前进行预览。如果某个工作流在我的日常工作中显得缓慢，它就会变成一个工具。

有问题、功能请求或 PPC 经验想分享？请通过 LinkedIn 或 [email protected] 联系我。

快速开始

你需要一个免费的 AdPlug 账户来授权连接。该服务使用 OAuth 2.1：添加服务时，客户端会打开浏览器窗口，让你登录 AdPlug 并连接 Google Ads。无需在任何地方粘贴 API 密钥或令牌。

1. 在 adplug.app 创建账户并连接 Google Ads。
2. 将端点添加到你的客户端（从下方选择）。
3. 批准 OAuth 提示。连接完成。

将其添加到客户端

Claude.ai 和 Claude Desktop

设置 → 连接器 → 添加自定义连接器 → 粘贴名称和 URL：

字段	值
名称	Google Ads MCP
URL	https://api.adplug.app/mcp/google-ads

浏览器窗口会打开，让你登录并授权。完成。

Claude Code（CLI）

claude mcp add --transport http adplug-google-ads https://api.adplug.app/mcp/google-ads

然后在 Claude Code 中运行 /mcp 并完成 OAuth 登录。

ChatGPT

设置 → 连接器 → 创建（开发者模式 / 自定义连接器）→ 粘贴 URL https://api.adplug.app/mcp/google-ads 并授权。需要使用支持自定义 MCP 连接器的 ChatGPT 方案。

Cursor

也可以手动将其添加到 ~/.cursor/mcp.json：

{
  "mcpServers": {
    "adplug-google-ads": {
      "url": "https://api.adplug.app/mcp/google-ads"
    }
  }
}

VS Code

code --add-mcp '{"name":"adplug-google-ads","url":"https://api.adplug.app/mcp/google-ads"}'

任何需要 stdio 桥接的客户端（Windsurf、较旧的桌面应用）

使用 mcp-remote 通过 stdio 桥接远程服务。它会为你处理 OAuth 握手：

{
  "mcpServers": {
    "adplug-google-ads": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://api.adplug.app/mcp/google-ads"]
    }
  }
}

工具

共 16 个工具，旨在提供少量灵活的工具，而不是大量功能狭窄的工具。

工具	功能
adplug_get_status	检查 Google Ads 是否已连接且运行正常。
google_ads_list_accounts	列出所有可访问的账户及其名称、类型、币种和 MCC 层级结构。
google_ads_account_performance	一次调用即可查看跨账户支出概览（跳过 MCC 管理员账户）。
google_ads_campaign_performance	查看广告系列级指标，无需 GAQL。
google_ads_conversion_performance	查看转化操作细分，分段处理由工具代劳。
google_ads_daily_trends	查看逐日指标趋势。
google_ads_search_terms	查看按费用排序的搜索词报告。
google_ads_shared_set_criteria	查看共享否定关键字列表的内容。
google_ads_keyword_ideas	进行关键字研究并获取创意。
google_ads_gaql_doc	GAQL 语法参考。
google_ads_reporting_view_doc	查看报告视图中字段的确切名称、类型和可过滤性。
google_ads_query	运行原始 GAQL，以执行自定义或高级查询。
google_ads_preview_mutation	在提交前预览状态变更（暂停 / 启用 / 移除）。
google_ads_execute_mutation	执行已预览的变更。
google_ads_preview_add_negatives	预览添加否定关键字（广告系列级或共享列表）。
google_ads_execute_add_negatives	执行否定关键字添加操作。

身份验证

采用 OAuth 2.1 和动态客户端注册。客户端会从端点发现授权服务器，注册自身，并打开浏览器供你登录 AdPlug 并授予访问权限。AdPlug 与 Google 之间的连接由服务器端保存并加密；MCP 客户端不会接触到 Google 令牌。

服务配置（用于目录提交）

{
  "mcpServers": {
    "adplug-google-ads": {
      "url": "https://api.adplug.app/mcp/google-ads"
    }
  }
}

链接

• 网站：https://adplug.app
• 控制面板和连接：https://adplug.app/dashboard/connections
• 设置指南：https://adplug.app/guides/google-ads
• 支持：[email protected]

更多 AdPlug 服务

AdPlug 是一个营销控制平台，可通过 Model Context Protocol 将你的广告账户接入 AI 助手。这只是 AdPlug 提供的多个服务之一：

• Google Ads MCP（本服务）：https://api.adplug.app/mcp/google-ads
• LinkedIn Ads MCP：https://api.adplug.app/mcp/linkedin-ads
• 统一服务（在一个连接器中整合 Google Ads 和 LinkedIn Ads）：https://api.adplug.app/mcp

一个 AdPlug 账户即可用于所有这些服务。

许可证

本仓库的内容（设置和文档）采用 MIT 许可证。托管服务有自己的条款。

Google Ads 是 Google LLC 的商标。AdPlug 是独立集成服务，未经 Google 背书，也与 Google 无关联。