最后更新:2026-11-16(Google Ads API、Anthropic、OpenAI 官方文档均于当天查阅;当前 API 版本 v26.2)
照着 如何将 Claude 链接到 Google 广告(Google Ads MCP 教程) 连接 Claude 和 Google 广告时,大部分报错都集中在三处:访问级别、凭据作用域、经理帐户。2026-09-09 开发者令牌停用后,旧教程里的很多排查方法已经过时,本文按新规则整理。
8 类常见报错速查
| 报错/现象 | 最常见原因 | 解决办法 |
|---|---|---|
| CLOUD_PROJECT_NOT_APPROVED_FOR_PRODUCTION | Cloud 项目只有 Test 级别却访问生产帐户 | 在 Google Ads API 概览页申请 Explorer |
| ACTION_NOT_PERMITTED(v24 及更早) | 同上,旧版本错误码 | 同上,并考虑升级 API 版本 |
| USER_PERMISSION_DENIED | 经 MCC 访问客户帐户但没设登录客户 ID | 设 GOOGLE_ADS_LOGIN_CUSTOMER_ID 或传 login_customer_id |
| 作用域不足/无权限 | ADC 生成时没带 adwords 作用域 | 重新执行 gcloud auth application-default login 并加 adwords |
| 客户 ID 格式错误 | 带了连字符 | 用 10 位纯数字 |
| 服务器启动超时 | pipx 首次下载依赖慢 | 先 pipx install google-ads-mcp |
| 找不到工具/权限规则失效 | v0.0.6 起工具名带前缀 | 更新为 search_search 等新名称 |
| 启动即报配置错误 | GOOGLE_ADS_MCP_TOOLS_CONFIG 指向的文件不存在或无效 | 修正路径;服务器不会回退默认配置 |

1. CLOUD_PROJECT_NOT_APPROVED_FOR_PRODUCTION
这是 2026 年最常见的报错。访问级别现在属于拥有你 OAuth 客户端或服务帐号的 Google Cloud 项目。启用 API 只给 Test 级别(只能访问测试帐户);访问生产帐户时,v25 及以后返回 AuthorizationError.CLOUD_PROJECT_NOT_APPROVED_FOR_PRODUCTION,v24 及更早返回 ACTION_NOT_PERMITTED。解决:在 Cloud Console 的 Google Ads API 概览页申请 Explorer(官方说明)。
容易踩的坑:你用 A 项目的 OAuth 客户端生成 ADC,却在 B 项目申请了 Explorer——级别看的是 OAuth 客户端所属项目。
2. 经理帐户(MCC)相关
通过经理帐户访问客户帐户时,必须告诉 API「以哪个经理帐户身份登录」:在 MCP 配置的 env 中设 GOOGLE_ADS_LOGIN_CUSTOMER_ID(10 位数字、不带连字符),或在单次工具调用里传 login_customer_id,后者优先(官方指南)。
3. 凭据作用域
本地 ADC 必须包含 adwords 作用域,重新生成即可:
# 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.json4. 工具名变了
自 v0.0.6 起工具按类别加前缀注册,例如 list_accessible_customers 变成 customers_list_accessible_customers、search 变成 search_search。旧的权限规则和提示词要同步更新,或在 tools_config.yaml 中把前缀设为空字符串。新名称下的权限写法:
// .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"
]
}
}5. 远程连接(Claude.ai 自定义连接器)
| 远程(Cloud Run)问题 | 检查点 |
|---|---|
| redirect_uri_mismatch | OAuth Web 客户端已加 https://claude.ai/api/mcp/auth_callback |
| 授权页提示应用未验证/被拒 | 同意屏幕为 Testing 时,连接帐号已加入测试用户 |
| 授权后仍无权调用 | 同意屏幕已加 adwords 作用域 |
| 回调跳到 localhost | GOOGLE_ADS_MCP_BASE_URL 已改为 Cloud Run 地址并重新部署 |
| 多实例下登录状态丢失 | 配置 JWT 签名密钥与持久化存储(如 Firestore) |

Google 指南提到,GOOGLE_ADS_MCP_BASE_URL 要填 Cloud Run 分配的公网地址;因为这个地址首次部署后才知道,可以先不带该变量部署,再更新。完整流程见 Connect Claude.ai to Google Ads with a remote MCP server on Cloud Run。
6. 不是报错,但常被当成报错
- 「Claude 说它不能暂停系列」:正常。官方 MCP 不能创建、修改、暂停或启用系列、广告组、广告、预算和出价。
- 关键词规划工具调用失败:Explorer 级别限制 KeywordPlanIdeaService 等规划类服务,需要 Basic 或 Standard(
- 访问级别
- )。
- RESOURCE_EXHAUSTED:超出访问级别的每日操作配额(
- 配额
- )。
- 测试帐户报表为空:测试帐户不投放广告,没有数据(
- 测试帐户
- )。
排查顺序建议
- 先在终端确认
claude mcp list能看到 google-ads 且状态正常。 - 问 Claude「列出我能访问的帐户」——失败多半是凭据或作用域。
- 能列帐户但查不了数据——看访问级别和 login_customer_id。
- 能查数据但不能写——看 tools_config.yaml 与 Claude Code 权限规则,这通常是你自己设的保护。
熊猫出海如何用 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 广告开户与投放(熊猫出海服务页)。
常见问题
我还在请求里传开发者令牌,会报错吗?
不会,它会被忽略。可以保留也可以删除。
ADC 文件放哪里?
gcloud 默认位置即可;使用默认位置时可以不设 GOOGLE_APPLICATION_CREDENTIALS。
Python 版本有要求吗?
MCP 服务器需要 Python 3.10 或更高。
哪里能提问?
Google 指南给出的社区支持渠道是 GitHub issues 与 Discord 的 #ads-api-ai-tools 频道。
合规说明:本文所有自动化都应只用于企业自有或已获正式授权的 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 广告(Google Ads MCP 教程)
- Claude 操作 Google 广告投放全流程自动化
- 用 Codex 写 Google Ads 日报与搜索词脚本
- Google 开发了 MCP:让 AI 直接操作你的广告投放
- Claude 连接 Facebook 广告常见报错排查(Facebook 篇)
- 大模型 API Key 申请与安全管理
- MCP 安全指南:AI Agent 工具调用权限最小化
联系熊猫出海: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
- Google: API limits and quotas
- Google: Test accounts
- Anthropic: Connect Claude Code to tools via MCP
- Anthropic: Claude Code permissions
以上官方页面均于 2026-11-16 查阅。API 版本、工具名称与权限要求会变化,请以官方页面为准。

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