连接器指南阅读约 4 分钟17 个 MCP 工具7 种语言

Google Ads MCP 服务器:将 Google Ads 连接到 Claude、ChatGPT 和任意 agent

向 Claude 或 ChatGPT 询问你的 Google Ads:广告系列、搜索字词、质量得分、预算、转化。只读,无需开发者令牌,15 分钟完成设置。

HC作者:HelpCode 团队更新于 4 分钟阅读 在 GitHub 开源

无需信用卡 · 7 天试用 · 提供自托管方案

any ai client · Google Ads
How did our Google Ads account do in the last 30 days? Spend, conversions, cost per conversion and the main campaigns. Read only.
AI
正在调用gads_list_accessible_customersgads_campaign_performancegads_account_daily_metricsgads_conversion_actions
One Performance Max campaign carried all spend and conversions; the Search campaign is paused. The cost per conversion looks too good for B2B: two short bursts of clicks at about one cent produced most of the month's conversions, and almost all of them are one sign-up action tracked as a page visit. Compare those days with real sign-ups before trusting the campaign's optimization.
gads_playbookgads_campaign_performancegads_search_termsgads_keyword_performancegads_budget_pacinggads_run_gaql+ 更多
  • 7 天免费试用
    无需信用卡
  • 符合 GDPR,SOC 2 就绪
    数据驻留欧盟,审计日志
  • 在 GitHub 开源
    开源 · AGPL-3.0
  • 支持 ChatGPT、Claude、Gemini
    任何兼容 MCP 的客户端

4 分钟配置后即可使用的真实提示词。

安装连接器后,把这些提示词粘贴到你的 AI 客户端。每条提示词下方列出的工具会由智能体自动调用。

“List the search terms from the last 30 days that cost money and never converted, grouped into negative keyword ideas.”
gads_search_termsgads_run_gaql
“Which keywords have a Quality Score of 5 or lower, and which component is below average?”
gads_keyword_performance
“Are my Search campaigns losing impression share to budget or to rank?”
gads_budget_pacing
“Who changed bids or budgets in the account last week?”
gads_change_history

跳过安装。2 分钟内即可运行。

在 cloud.anythingmcp.com 开始免费试用,一键添加 Google Ads,然后将你的 AI 客户端(Claude、ChatGPT、Copilot 或 Cursor)指向生成的 MCP 端点。无需 Docker,无需 git clone,无需任何工程经验。

开始免费试用

摘要

向 Claude 或 ChatGPT 询问你的 Google Ads:广告系列、搜索字词、质量得分、预算、转化。只读,无需开发者令牌,15 分钟完成设置。

试试这样问

Google Ads 的示例提示

点击任意提示即可复制,然后粘贴到 Claude、ChatGPT、Cursor、Gemini、Copilot 或 OpenClaw 中,在该连接器上运行。

Google Ads · 通过 MCP 实时
分享
Opus 4.7

Claude 是 AI,可能会出错。请核对回答。

把 Google Ads 用作 MCP 服务器

简短答案: 在一个拥有 Google Ads API 访问权限的 Google Cloud 项目中创建 OAuth 客户端,在 AnythingMCP 上安装 Google Ads 连接器,在浏览器中授权一次,然后把 AnythingMCP 作为远程 MCP 服务器添加到你的 AI 客户端。之后 Claude、ChatGPT、Cursor 或 Gemini 就能读取你的广告系列、搜索字词、质量得分、预算、转化和更改历史记录,并用你的真实数据回答相关问题。连接器只读取数据:它无法暂停广告系列,也无法修改出价。

自 2026 年 9 月 9 日 起,Google 不再使用开发者令牌。API 访问权限归属于你的 Google Cloud 项目,也不再需要经理(MCC)账号。仍然要求开发者令牌的指南和工具已经过时;请参阅 无需开发者令牌的 Google Ads API 访问。

你可以问什么

领域示例背后的工具
账号健康状况“过去 30 天账号表现如何?”gads_account_daily_metrics、gads_campaign_performance
浪费的支出“哪些搜索字词花了钱却从未带来转化?”gads_search_terms、gads_keyword_performance
否定关键字“根据上个月的搜索字词建议否定关键字。”gads_search_terms、gads_run_gaql
质量得分“哪些关键字的质量得分偏低,哪个组成部分低于平均水平?”gads_keyword_performance
预算“我们受限于预算还是排名?”gads_budget_pacing
广告“哪些广告被拒登或广告效力较差?”gads_ad_performance
跟踪“转化跟踪设置正确吗?”gads_conversion_actions、gads_run_gaql
更改记录“上周谁改了什么?”gads_change_history
经理账号“比较我所有客户账号的支出。”gads_list_client_accounts
其他任何问题API 能生成的任何报告gads_run_gaql、gads_query_field_catalog

内置的 playbook(gads_playbook)把每类问题对应到合适的工具和经过测试的 Google Ads 查询语言(GAQL)查询:概览、时段对比、效果下滑、按设备、地理位置和小时细分、着陆页、Performance Max 素材资源组、素材资源、受众群体、结算。它不消耗 API 调用。

设置方法

步骤 1:拥有 Google Ads API 访问权限的 Google Cloud 项目

  1. 打开 console.cloud.google.com,选择或创建一个项目,然后进入 APIs & Services → Library,启用 Google Ads API。
  2. 打开项目的 Google Ads API 页面,查看 access level(访问级别)。新项目从 Test 访问级别开始,只能访问测试账号。要读取真实账号,请申请 Explorer 访问级别(每天 2,880 次操作,通常自动批准),或 Basic 访问级别(每天 15,000 次,需要对项目进行品牌验证)。
  3. 在 APIs & Services → OAuth consent screen 下,如果你使用 Google Workspace,选择 Internal,否则选择 External 并将其设为 In production。在 Testing 模式下,Google 会在 7 天后撤销 refresh token。

步骤 2:创建 OAuth 客户端

Credentials → Create credentials → OAuth client ID → Web application,添加重定向 URI https://cloud.anythingmcp.com/api/mcp-oauth/callback(自建部署:<your AnythingMCP URL>/api/mcp-oauth/callback)。复制客户端 ID 和密钥。

步骤 3:安装并授权连接器

  1. 在 AnythingMCP Cloud 创建一个工作区(7 天免费),或使用你自建的 AnythingMCP。
  2. 打开 Marketplace,找到 Google Ads,点击 Install,粘贴客户端 ID 和密钥。如果你通过经理账号访问客户账号,还需在 GOOGLE_ADS_LOGIN_CUSTOMER_ID 中填写经理账号的 10 位 ID。
  3. 在连接器页面点击 Authorize with Provider,用一个能看到你 Google Ads 账号的 Google 用户登录。在 Google Ads 中拥有 Read only 角色的用户就足够了。

步骤 4:连接你的 AI 客户端

所有客户端都连接到你的 AnythingMCP 服务器地址。claude.ai 和 ChatGPT 用 OAuth 登录,其他客户端则在 X-API-Key header 里发送 MCP API key。

工具

工具作用
gads_playbook从常见问题路由到对应工具和经过测试的 GAQL 查询。免费,不调用 API。
gads_list_accessible_customers已登录用户可以打开的账号
gads_get_customer币种、时区、是否为经理账号、自动标记、优化得分
gads_list_client_accounts经理(MCC)账号下的账号
gads_account_daily_metrics每天的展示次数、点击次数、费用、转化次数和转化价值
gads_list_campaigns广告系列及其状态,以及广告系列受限或未投放的原因
gads_campaign_performance某个日期范围内每个广告系列的汇总数据,按费用排序
gads_ad_group_performance每个广告组的汇总数据
gads_ad_performance广告及其标题、描述、广告效力和审批状态
gads_keyword_performance关键字及其质量得分和三个组成部分
gads_search_terms搜索字词报告
gads_budget_pacing每日预算、支出,以及因预算和因排名而损失的展示次数份额
gads_conversion_actions转化操作:是否为主要操作、统计方式、回溯期、价值
gads_change_history谁在何时、通过哪个工具改了什么(最近 30 天)
gads_recommendationsGoogle 的建议及其预估影响
gads_run_gaql任意 GAQL 查询,支持分页
gads_query_field_catalog字段名称、类型、枚举值和兼容性

每个工具都标记为只读,因此 Claude 和 ChatGPT 运行它们时不会把它们当作操作来处理。

你发起请求时发生了什么

我们在 claude.ai 中问 Claude,我们自己的 Google Ads 账号在过去 30 天表现如何:支出、转化、每次转化费用以及主要广告系列。Claude 自行调用了六个工具:它列出了可访问的账号,注意到有两个同名账号,其中一个全年都处于闲置状态;读取了币种和时区;拉取了广告系列汇总、广告系列列表、每日趋势和转化操作。

回答并没有停留在汇总数据上。对于一个 B2B 账号来说,每次转化费用好得有些反常,于是 Claude 逐日核查,发现两次短时间的点击爆发,每次点击约一美分,却带来了当月大部分转化。它还注意到,几乎所有转化都来自同一个注册操作,而这个操作是按页面访问来统计的,并建议在信任广告系列的优化之前,先把 Google 的数据和真实注册数做比对。这类检查通常要等到下一次人工审核才会做。完整做法见:用 Claude 审核 Google Ads。

可尝试的提示语

  • “我的 Google Ads 账号上个月和前一个月相比表现如何?显示支出、转化、CPA 和 ROAS。”
  • “列出过去 30 天花了钱却从未转化的搜索字词,并把它们归类成否定关键字建议。”
  • “哪些关键字的质量得分在 5 分或以下,哪个组成部分低于平均水平?”
  • “我的搜索广告系列是因为预算还是因为排名而损失展示次数份额?”
  • “检查我的转化跟踪:哪些操作是主要操作,每个操作在过去 30 天是否记录到了转化?”
  • “上周谁修改了账号里的出价或预算?”

Google Ads 与你的其他数据结合使用

该连接器与你的其他连接器运行在同一个 AnythingMCP 服务器上,因此一个对话可以组合多个数据源:用 Google Search Console 结合付费和自然搜索关键字,用 Google Analytics 4 结合会话和收入,或结合 CRM 中的线索和交易。访问权限在服务器上按人控制,每次调用都有记录。

限制

  • 只读。 连接器无法修改广告系列、出价、预算或关键字。Google Ads 的 OAuth scope 并非只读,因此起保护作用的是连接器本身,以及你授权的 Google 用户。
  • 配额。 Explorer 访问级别下,每个 Cloud 项目每天允许 2,880 次操作,由所有使用该项目 OAuth 客户端的连接器共享。一个问题通常需要 2 到 8 次调用。
  • 最新数据。 当天的数据并不完整,而且点击后的几天里仍会陆续有转化进来。
  • Performance Max 本身提供的搜索字词和展示位置细节就很少;连接器会显示 API 公开的内容(素材资源组、搜索类别)。
  • 金额 以账号币种的 micros 为单位返回;连接器会提示模型进行换算,所以请核对回答中的币种。

FAQ

我需要 Google Ads 开发者令牌吗? 不需要。Google 已于 2026 年 9 月 9 日停用开发者令牌。现在的访问权限取决于你的 Google Cloud 项目的访问级别(访问真实账号需要 Explorer 或更高级别)。

Claude 能修改我的广告系列吗? 不能。每个工具都只读取数据。没有任何工具可以暂停、创建或编辑内容。

支持经理(MCC)账号吗? 支持。把 GOOGLE_ADS_LOGIN_CUSTOMER_ID 设为经理账号的 ID,并让 agent 先列出客户账号。你被直接邀请加入的账号无需此设置即可使用。

能在 claude.ai 和 ChatGPT 中使用吗,还是只能在编程 agent 里用? 能。AnythingMCP 是带 OAuth 的远程 MCP 服务器,因此可以在 claude.ai 中作为自定义连接器使用,也可以在 ChatGPT 中作为开发者模式应用使用。

费用是多少? 在项目配额内,Google Ads API 免费使用。AnythingMCP Cloud 提供 7 天免费试用,之后每月 €19 起;自建的 AnythingMCP 免费且开源(AGPL-3.0)。

这和 Google 官方的 Google Ads MCP 服务器有什么区别? Google 的开源服务器在你的客户端旁边本地运行,每个人都要用自己的凭据进行设置。AnythingMCP 连接器运行在服务器上,可以在 claude.ai 和 ChatGPT 等网页客户端中使用,整个团队只需授权一次即可共用,附带经过测试的查询 playbook,并且与你的其他业务连接器放在一起。

相关指南

这份指南对你有帮助吗?

你的 Google Ads 智能体只差一次点击。

安装连接器,粘贴密钥,向你的 AI 客户端提问。免费试用 7 天,无需信用卡。

相关指南

连接器

如何将 Google Ads 连接到 ChatGPT:通过 MCP 读取广告系列数据

把 Google Ads 作为开发者模式应用添加到 ChatGPT:ChatGPT 从你的账号读取广告系列、搜索字词、质量得分和预算。只读,无需开发者令牌。

连接器

如何将 Google Ads 连接到 Claude:15 分钟配置自定义连接器

把 Google Ads 作为自定义连接器添加到 claude.ai 和 Claude 桌面端:Claude 读取广告系列、搜索字词、质量得分和预算。只读,无需开发者令牌。

连接器

如何将 Google Ads 连接到 Cursor — 通过 MCP

面向 AI agent 的 Google Ads:广告系列、广告组、广告和关键字效果,搜索字词,质量得分,预算消耗进度和展示次数份额,转化操作,更改历史记录,建议,经理(MCC)账号,以及任意 GAQL 查询。17 个只读工具,OAuth2。

连接器

如何将 Google Ads 连接到 Gemini — 通过 MCP

面向 AI agent 的 Google Ads:广告系列、广告组、广告和关键字效果,搜索字词,质量得分,预算消耗进度和展示次数份额,转化操作,更改历史记录,建议,经理(MCC)账号,以及任意 GAQL 查询。17 个只读工具,OAuth2。

连接器

无需开发者令牌的 Google Ads API:2026 年 9 月有哪些变化

Google 已于 2026 年 9 月 9 日停用 Google Ads API 开发者令牌。访问权限现在归属于你的 Google Cloud 项目:Test、Explorer、Basic 和 Standard 级别及其获取方式。

连接器

用 Claude 审核 Google Ads:在你自己的账号上经过测试的方法

几分钟内用 Claude 审核 Google Ads 账号:支出、转化质量、浪费的搜索字词、质量得分、预算和跟踪,数据直接来自 API。