适合谁
- 营销人员
- 数据分析师
- 使用 AI 助手管理 Google Ads 账户的开发者
- 需要自动化广告报告和分析的团队
G
56FMRS · C
这是 Google 官方维护的 MCP 服务器，用于与 Google Ads API 交互。它提供查询工具和元数据资源，支持多种认证方式，并可以部署在本地或云端。适合需要将 AI 助手集成到广告账户管理中的用户，但需要注意数据暴露权限和令牌管理。
Google Ads MCP Server 是一个官方服务器，提供工具和资源，让 AI 代理和 LLM 能够查询和操作 Google Ads 数据。它支持搜索广告账户信息、获取资源元数据、列出可访问的客户，并提供发现文档、指标、细分和发布说明等资源。该服务器支持多种认证方式，包括 FastMCP OAuth 代理、应用默认凭据或 Google Ads API Python 客户端库，并可通过本地 stdio 或远程流式 HTTP 传输运行。
工具能力
search
检索 Google Ads 账户的相关信息。
get_resource_metadata
获取有关 Google Ads API 资源类型（例如 "campaign"）的元数据，以了解数据结构及可查询的字段。
list_accessible_customers
返回调用认证用户可直接访问的客户 ID 列表。
安装接入
- 安装 pipx。
- 按照官方指南获取开发者令牌，并确保至少具有 Explorer 访问权限。
- 在 Google Cloud 项目中启用 Google Ads API。
- 配置凭据：可选择 FastMCP OAuth 代理、应用默认凭据或 Google Ads Python 客户端库。
- 在 MCP 客户端配置中添加服务器，设置环境变量如 GOOGLE_ADS_DEVELOPER_TOKEN 和凭据路径。
- 如果使用 OAuth 代理，设置相关环境变量并启动服务器作为独立进程。
claude_desktop_config.json
{
"mcpServers": {
"google-ads-mcp": {
"command": "pipx",
"args": [
"run",
"--spec",
"git+https://github.com/googleads/google-ads-mcp.git",
"google-ads-mcp"
],
"env": {
"GOOGLE_APPLICATION_CREDENTIALS": "PATH_TO_CREDENTIALS_JSON",
"GOOGLE_PROJECT_ID": "YOUR_PROJECT_ID",
"GOOGLE_ADS_DEVELOPER_TOKEN": "YOUR_DEVELOPER_TOKEN"
}
}
}
}
选型与风险
不适合谁
- 没有 Google Ads 账户或没有有效开发者令牌的用户
- 无法访问生产账户的测试令牌用户
- 需要直接修改广告预算或出价的用户（服务器只提供查询和元数据功能）
- 完全离线的环境（需要访问 Google Ads API）
所需权限
- 需要 Google Ads API 的访问令牌，通常通过 OAuth 2.0 提供
- 需要开发者令牌，至少具有 Explorer 访问权限
- 需要 Google Cloud 项目中的 Google Ads API 已启用
- 凭据必须包含 adwords 作用域
风险与副作用
- 服务器会将您的广告数据暴露给连接的 AI 代理或 LLM
- API 调用可能包含敏感的业务数据
- 如果密钥泄露，可能导致未经授权的访问
- 存在配额和速率限制，过度使用可能导致服务中断
常见排障
- 检查开发者令牌是否具有生产账户访问权限，否则会报错
- 确认 Google Cloud 项目中已启用 Google Ads API
- 验证凭据文件路径正确且具有 adwords 作用域
- 对于 OAuth 代理，确保所有相关环境变量设置正确，并检查服务器日志
- 确认 MCP 客户端配置中的环境变量名称和值正确
使用场景
查询广告账户中的活动广告系列数量
获取广告系列效果数据
列出用户有权访问的所有客户账户
查看 Google Ads API 的资源结构和可用字段
支持客户端
Antigravity CLI完整支持
Antigravity Code Assist完整支持
Claude Code完整支持
Cursor完整支持
VS Code with Copilot完整支持