最后更新:2026-11-16(Google Ads API、Anthropic、OpenAI 官方文档均于当天查阅;当前 API 版本 v26.2)
结论先说:Google 已经在 GitHub 开源了官方的 Google Ads MCP 服务器(googleads/google-ads-mcp),并在 Google Ads API 文档里发布了集成指南(官方指南)。把 Claude 链接到 Google 广告,就是让 Claude 连上这个服务器。需要注意它是自托管的:你在本机运行(stdio),或部署到自己的 Cloud Run(远程),并不是 Google 托管的 URL。
4 种连接方式
| 连接方式 | 适合谁 | 部署 | 认证 |
|---|---|---|---|
| Claude Code(本地 stdio) | 投手 + 技术同事 | 本机 pipx 运行 | ADC(用户 OAuth 或服务帐号) |
| Claude 桌面版(本地配置) | 不写代码的投手 | 本机运行 | ADC |
| Claude.ai 自定义连接器(远程) | 团队共享 | 自建 Cloud Run | OAuth Web 客户端 |
| Claude API/Agent SDK | 产品化 | 本地或远程 | 同上 |

连接前的 6 项准备
| 准备项 | 在哪里做 | 说明 |
|---|---|---|
| Google Ads 帐户 | ads.google.com | 企业自有;多帐户用自己的 MCC |
| Google Cloud 项目 | Cloud Console | 启用 Google Ads API,自动获 Test 级别 |
| Explorer 访问级别 | Google Ads API 概览页 | 访问生产帐户必需 |
| OAuth 客户端 | APIs & Services › Credentials | 本地用桌面应用,远程用 Web 应用 |
| Python 3.10+、pipx、gcloud | 本机 | 本地 stdio 模式需要 |
| Claude 帐号 | claude.ai / Claude Code | 支持地区内的帐号 |

最大的变化:开发者令牌已于 2026-09-09 停用,你不再需要经理帐户和 API Center 申请。启用 Google Ads API 后项目自动获得 Test 级别(只能访问测试帐户),访问真实帐户要在 Google Ads API 概览页申请 Explorer,多数情况自动审核通过(官方说明、访问级别)。
方式一:Claude Code(推荐)

1. 生成本地凭据
# 1) Google Cloud project: enable the Google Ads API (grants Test access),
# then apply for Explorer access on the "Google Ads API Overview" page.
# 2) Local ADC with the adwords scope (OAuth client JSON from the same project)
gcloud auth application-default login \
--scopes https://www.googleapis.com/auth/adwords,https://www.googleapis.com/auth/cloud-platform \
--client-id-file=client_secret.json也可以用服务帐号:把 GOOGLE_APPLICATION_CREDENTIALS 指向密钥文件,或给 gcloud 加 --impersonate-service-account。
2. 添加服务器
# Claude Code: add Google's open-source Google Ads MCP server (local stdio)
claude mcp add --transport stdio --scope project \
--env GOOGLE_CLOUD_PROJECT=my-gcp-project \
--env GOOGLE_ADS_LOGIN_CUSTOMER_ID=1234567890 \
google-ads -- pipx run --spec google-ads-mcp==0.0.6 google-ads-mcp
claude mcp list-- 之后是启动服务器的命令;--scope project 会写入项目根目录的 .mcp.json 方便团队共享(Claude Code MCP 文档)。想更快启动,可先 pipx install google-ads-mcp,再把命令换成 google-ads-mcp。
3. 设置权限
// .claude/settings.json - reads allowed, asset/label writes always asked
{
"permissions": {
"allow": [
"mcp__google-ads__customers_list_accessible_customers",
"mcp__google-ads__search_search",
"mcp__google-ads__metadata_get_resource_metadata"
],
"ask": [
"mcp__google-ads__assets_create_asset",
"mcp__google-ads__labels_manage_labels",
"mcp__google-ads__labels_manage_label_associations"
],
"deny": [
"mcp__google-ads__assets_upload_video_asset"
]
}
}4. 测试
在 Claude Code 里问:「我能访问哪些 Google Ads 帐户?」「客户 1234567890 本周有多少个启用中的系列?」——这正是 Google 文档里的示例问题。
方式二:Claude 桌面版
在桌面版的本地 MCP 配置文件中加入下面这段(Google 指南给出的通用格式):
{
"mcpServers": {
"google-ads-mcp": {
"command": "pipx",
"args": ["run", "--spec", "google-ads-mcp==0.0.6", "google-ads-mcp"],
"env": {
"GOOGLE_CLOUD_PROJECT": "PROJECT_ID",
"GOOGLE_APPLICATION_CREDENTIALS": "PATH_TO_CREDENTIALS_JSON"
}
}
}
}通过经理帐户访问客户帐户时,在 env 里再加 GOOGLE_ADS_LOGIN_CUSTOMER_ID(10 位、不带连字符)。
方式三:Claude.ai 自定义连接器(远程)
团队共享时,把服务器部署到自己的 Cloud Run,以 Streamable HTTP 方式提供服务,并使用 OAuth Web 应用客户端。Google 指南要求:在 OAuth 客户端中加入 Claude 的回调地址 https://claude.ai/api/mcp/auth_callback,在同意屏幕中加入 adwords 作用域;同意屏幕处于 Testing 状态时,要把连接用的 Google 帐号加为测试用户。然后在 Claude 中添加自定义连接器(Claude 帮助中心)。完整部署步骤见英文篇 Connect Claude.ai to Google Ads with a remote MCP server on Cloud Run。
# Remote (Streamable HTTP) deployment on Cloud Run - OAuth Web client required
gcloud builds submit --tag us-central1-docker.pkg.dev/YOUR_PROJECT_ID/mcp-servers/google-ads-mcp:latest .
# set at deploy time (values from Secret Manager, never in the repo):
# GOOGLE_PROJECT_ID, GOOGLE_ADS_MCP_OAUTH_CLIENT_ID,
# GOOGLE_ADS_MCP_OAUTH_CLIENT_SECRET, GOOGLE_ADS_MCP_BASE_URL
# Authorized redirect URIs on the OAuth Web client include, e.g.:
# https://claude.ai/api/mcp/auth_callback
# https://chatgpt.com/connector_platform_oauth_redirect只想让 Claude 看数据?
# tools_config.yaml - strictly read-only deployment
# (point GOOGLE_ADS_MCP_TOOLS_CONFIG at this file)
namespaces:
customers: true
search: true
metadata: true
labels: false
assets: false把 GOOGLE_ADS_MCP_TOOLS_CONFIG 指向这个文件,写入工具就不会注册。连接后的报表玩法见 Claude 用 GAQL 自动生成 Google Ads 报表与异常诊断;遇到报错看 Claude 连接 Google Ads 常见报错排查。
连上之后,Claude 能做什么、不能做什么
- 能:列出可访问帐户、用 GAQL 查任意报表、查字段元数据;以「先提议后确认」创建素材(文字、图片、附加信息等)和管理标签。
- 不能:创建、修改、暂停或启用系列/广告组/广告,调整预算与出价,把素材关联到系列。这些要用 Google Ads API 脚本(见
- Claude × Google Ads API 自動建立廣告活動(Python)
- )或在后台操作。
熊猫出海如何用 Claude、Codex 和 Google 广告帐户帮客户提升投放效率
这篇讲的是 Claude,但在实际服务中,熊猫出海会把 Claude、Codex 和 Google Ads 帐户组合起来,帮出海企业更快跑完「开户与转化追踪 → 搭系列 → 写素材 → 看报表与搜索词 → 调预算与否定词」这一整套重复工作,让投手把时间花在策略、出价判断和素材上。
- 广告帐户:使用企业自己的 Google Ads 帐户,或通过熊猫出海开户服务合规开通的帐户;帐户归企业所有,不出租、不共享。需要多帐户管理时,用企业自己的经理帐户(MCC)授权。
- Claude:通过 Google 开源的 Google Ads MCP 服务器用自然语言查数(GAQL)、诊断展示份额和搜索词、写 RSA 标题描述与附加信息初稿,在「先提议、后确认」模式下创建素材和标签。
- Codex:写和维护 google-ads Python 脚本(日报、搜索词清洗、批量建暂停系列、validate_only 预检),在沙盒里运行并接入定时任务或 CI。
- 人工把关:启用系列、提预算、改出价目标都由投手审核后执行;Google Ads 政策与落地页合规由人工最终确认。
这是一项服务能力说明,不涉及任何价格或返点承诺;我们也不是 Google、Anthropic 或 OpenAI 的官方合作伙伴。开户与代投放流程请看 Google 广告开户与投放(熊猫出海服务页)。
常见问题
Google Ads 有没有官方 MCP?
有,Google 开源的 google-ads-mcp,文档在 developers.google.com 的 Google Ads API 开发者工具包中;它需要自己运行,社区支持渠道是 GitHub issues 与 Discord 的 #ads-api-ai-tools。
免费版 Claude 能用自定义连接器吗?
Claude 帮助中心说明各套餐对自定义连接器的支持不同,免费版有数量限制,以官方页面为准。
一定要 Explorer 吗?
只连测试帐户不需要;要查真实帐户数据就需要 Explorer 或更高级别,否则会报 CLOUD_PROJECT_NOT_APPROVED_FOR_PRODUCTION。
Claude 支持中国大陆使用吗?
不支持。Anthropic 支持地区不含中国大陆和香港,请先看 Claude API 企业如何开通?资格自查。
合规说明:本文所有自动化都应只用于企业自有或已获正式授权的 Google Ads 帐户(含经理帐户 MCC 下的客户帐户),通过 Google 官方 Google Ads API、Google 开源的 Google Ads MCP 服务器或 Google Ads 编辑器等官方工具接入,遵守《Google Ads API 条款》、API 配额与《Google Ads 政策》,并在任何会产生花费的动作前保留人工审核。熊猫出海不出售、出租、共享或转让广告帐户、MCC 或 API 凭据,不协助规避广告审核、地区限制、身份验证或付款管控,也不是 Google、Anthropic 或 OpenAI 的官方合作伙伴。Claude 与 OpenAI 服务仅向其支持国家/地区的客户提供,中国大陆与香港不在列表中,请由在支持地区合法设立并真实经营的主体开通并负责。
相关阅读
- Google 广告开户与投放(熊猫出海服务页)
- 海外 AI Token 服务:帐号开通 + API 接入(熊猫出海)
- Claude 连接 Google Ads 常见报错排查
- Claude 操作 Google 广告投放全流程自动化
- Claude 用 GAQL 自动生成 Google Ads 报表与异常诊断
- Codex 操作 Google 广告投放全流程自动化
- Google 开发了 MCP:让 AI 直接操作你的广告投放
- 如何将 Claude 链接到 Facebook 广告(Facebook 篇)
- MCP 安全指南:AI Agent 工具调用权限最小化
- 谷歌广告投放入门教程(AI 出海公司版)
联系熊猫出海:Google 广告开户 + AI 自动化投放
告诉我们公司主体所在地、行业、目标国家、落地页链接和预计月预算,以及你想先自动化哪一段(报表、搜索词、素材还是建系列)。我们先做资质与落地页预审,再协助企业合规开通自有 Google Ads 帐户,并把 Claude / Codex 接入到你的投放流程。
WhatsApp:+852 5904 8602Telegram:@PANDA0134微信:szcwh99

官方来源
- Google: Google Ads MCP server – developer integration guide
- GitHub: googleads/google-ads-mcp
- Google: Developer token sunset (2026-09-09) and FAQ
- Google: Google Ads API access levels
- Anthropic: Connect Claude Code to tools via MCP
- Anthropic: Claude Code permissions
- Claude Help Center: custom connectors using remote MCP
- Anthropic: Supported regions
以上官方页面均于 2026-11-16 查阅。API 版本、工具名称与权限要求会变化,请以官方页面为准。

微信扫一扫打赏
支付宝扫一扫打赏
