用途：帮助用户在自己的 AI 客户端中完成 Google Ads MCP 的只读查询链路，从安装到验证逐步确认。适合新配置、排查某一具体报错，以及核对时效性政策或冲突指引三种场景。新配置走安装教程，覆盖 gcloud CLI、官方技能、OAuth、MCP 安装与 Codex 注册，macOS 为已测试路径，其他平台参考官方安装器。
主要能力：区分多个独立状态——技能文件已装、服务器已装、MCP 握手成功、ADC 通过认证、账户查询成功、广告系列查询返回有效列表、目标 AI 主机可调用该服务器；一个状态成立不能证明下一个。安装前检查可执行文件与包元数据，用 gcloud help auth application-default login 验证登录语法。范围仅限本地 stdio 与官方 google-ads-mcp 包，不开启网络监听、不配置 OAuth 代理、不部署服务器。
使用方式：优先使用主机已有的 Google Ads MCP 工具；否则运行随附探测脚本： python3 scripts/mcp_smoke_test.py python3 scripts/mcp_smoke_test.py --live 路径相对技能目录，需先解析实际安装目录。默认模式只做 MCP 初始化与工具发现；--live 执行有界只读调用并使用现有凭据，只报告计数与通用错误类别，不输出账户 ID、广告系列名、令牌或原始日志。--customer-id 仅用于用户选定的账户，否则最多尝试五个可直接访问账户，并跳过经理账户。始终检查 tools/list，已测试默认工具为 customers_list_accessible_customers、metadata_get_resource_metadata(resource_name) 和 search_search(customer_id, fields, resource, ...)，命名空间可自定义，构造查询前先读取资源元数据。
限制：截至 2026-09-20 的检查，Google 于 2026-09-09 将 Google Ads API 访问级别移到 Cloud 项目，此流程不要求新建 Developer Token；启用 API 获得 Test 访问权限，查询生产账户还需合适的项目访问级别。本地方案用 ADC；.env 中的 GOOGLE_ADS_CLIENT_ID、GOOGLE_ADS_CLIENT_SECRET、GOOGLE_ADS_REFRESH_TOKEN 不能证明 ADC 存在，服务器不会自动加载任意 .env。登录需账户所有者在浏览器完成同意流程，不应把令牌、授权码或凭据 JSON 粘贴到聊天。OAuth 授权范围可能大于服务器的只读工具。GOOGLE_ADS_LOGIN_CUSTOMER_ID 是经理访问的路由设置，非密码也非必填。将 isError、协议错误、异常输出结构与超时视为失败；有效空列表为 PASS_EMPTY，不证明存在广告系列。子进程测试不能证明当前聊天已具备该工具，需单独检查主机注册。对仅需解释的请求只解释，不要因此安装或注册工具。凭据、账户身份、广告系列数据与本地记录不得进入公开产物。资料未提供具体版本号与收费信息。