Google Ads MCP 安装助手
指导开发者安装并接入只读的 Google Ads MCP 服务。
文档要求使用环境变量而非硬编码凭据，并说明stdio无网络端口、服务器只读，体现了部分最小暴露和数据流透明性；但同时建议Cloud Run使用--allow-unauthenticated，未提供访问控制、凭据轮换、审计或回滚方案，且缺少明确的用户确认步骤，因此大幅扣分。
步骤、前置检查、PATH故障排查和重启提示较完整，且默认安装PyPI稳定版；但存在pipx install与配置中pipx run的流程差异、平台命令未经验证、Cloud Run构建上下文和配置假设不充分，静态审查且无提交测试，故不超过10分并保守扣分。
目标用户、主要场景、凭据输入和多种客户端集成均有描述，且说明了不支持写操作的范围；但触发边界、非适用场景、中文支持和中国大陆网络可达性未说明，且强制Antigravity验证可能不适合所有用户，故仅给中等分。
Front matter包含名称、兼容性、作者、版本和分类；仓库README提供安装入口、Apache-2.0许可证、维护说明和问题反馈路径。文档层次较清晰，但缺少技能级变更日志、明确维护责任、依赖版本锁定、FAQ和已知限制，且内容较长并含未完成的工具示例。
对本地安装、环境变量配置、stdio集成和基础排错提供了可直接复用的命令与配置样例，核心任务大体可完成；但部分配置可能依赖未证实的客户端行为，Cloud Run示例存在明显安全与部署假设，且没有静态可验证的代表性成功输出，因此按静态上限保守评分。
文档给出了命令、配置片段、环境变量名和若干成功条件，具备有限可审计性；但没有提交测试、CI覆盖、锁定依赖或第三方执行证据，关键关于客户端、Antigravity和服务端行为的断言主要是作者陈述，因此不超过5分。
- 不要直接照用Cloud Run的--allow-unauthenticated部署示例；应先补充认证、授权、最小权限、凭据轮换和审计方案。
- 在真实环境执行前，应核对google-ads-mcp当前版本、pipx install与pipx run的预期流程，以及各客户端实际支持的配置格式。
- 该评估仅基于静态源文件，未执行安装、认证、MCP连接或Google Ads查询；中国大陆网络可达性和中文交互能力未被证明。
这个 Skill 能做什么，适合哪些场景？
该技能指导开发者下载、配置和安装官方开源 Google Ads MCP Server。它覆盖 Python 与 pipx 前置检查、Google Ads 凭据配置，以及 Claude、Cursor 和 Antigravity 等客户端的 stdio 集成。它还说明了 Cloud Run 部署、连接验证和常见故障排查。连接后的服务器提供账户发现、资源元数据查询和 GAQL 搜索，当前严格只读。
检查 Python 3.12+ 与 pipx；验证 Google Ads Developer Token、OAuth 客户端凭据、Refresh Token 和客户 ID；提供 pipx install google-ads-mcp 安装命令并用 google-ads-mcp --help 验证；生成 Claude Desktop 的 MCP JSON 配置并说明 Cursor、Antigravity 和 Cloud Run 配置；指导使用 /mcp 检查服务，并调用 list_accessible_customers、get_resource_metadata 和 search 查询 Google Ads 数据。
- 需要通过自然语言查询 Google Ads 广告系列和报告指标的开发者。
- 已拥有五项 Google Ads 凭据、需要安装官方 MCP 服务的用户。
- 需要将 Google Ads 接入 Claude Desktop、Cursor 或 Antigravity 的团队。
- 需要把只读 Google Ads MCP 服务部署到 Google Cloud Run 的开发者。
这个 Skill 有哪些优点和局限？
- 提供从环境检查、安装到客户端接入的完整流程。
- 明确要求使用官方 `google-ads-mcp` PyPI 包。
- 覆盖 stdio、Claude、Cursor、Antigravity 和 Cloud Run 场景。
- 明确列出三个只读 MCP 工具及其参数。
- 依赖 Python 3.12+、pipx、网络连接和完整 Google Ads 凭据。
- 缺少凭据时必须先完成另一个 quickstart 技能。
- 来源未提供自动化测试套件或实际平台验证结果。
- 服务器当前不能修改出价、暂停广告系列或创建广告资产。
如何安装这个 Skill？
先通过 npx skills add google/skills 安装该仓库中的技能，并在选择界面选择 Google Ads API MCP Server Installation。使用本技能前，准备 Developer Token、OAuth Client ID、Client Secret、Refresh Token 和 Customer ID；缺少这些凭据时，来源要求先使用 google-ads-api-quickstart。检查 python3 --version 是否为 3.12+，再运行 pipx --version。前置条件满足后执行 pipx install google-ads-mcp，并运行 google-ads-mcp --help 验证。
如何使用这个 Skill？
可向支持该技能的助手提出：“指导我安装并配置 Google Ads MCP Server，并接入 Cursor。”安装后，在客户端配置 pipx run google-ads-mcp 和所需环境变量，重启客户端，再运行 agy 后输入 /mcp 检查服务。随后可测试：“Retrieve all campaigns from my Google Ads account 1234567890.” 查询时客户 ID 必须为不含连字符的 10 位数字。
这个 Skill 与同类方案有什么区别？
与标准 Google Ads 客户端库相比，本技能主要解决 MCP Server 的安装与 AI 客户端集成，而不是直接编写客户端库代码。来源还描述了本地 stdio 运行方式与 Cloud Run 部署方式。