如何安装配置 Google Ads MCP Server把 AI 助手接入 Google Ads 账户【免费下载链接】skillsAgent Skills for Google products and technologies项目地址: https://gitcode.com/GitHub_Trending/skills29/skills想让 Cursor、Claude Desktop、Antigravity 这类 AI 助手直接用自然语言查询 Google Ads 账户例如拉取所有广告系列的状态和预算可以安装 Google 官方开源的 Google Ads MCP Server。它通过 Model Context ProtocolMCP的 standard input/outputstdiotransport 与 AI 助手通信AI 客户端把google-ads-mcp作为后台子进程启动配置好精确的启动命令和承载凭据的环境变量后即可调用不监听任何网络端口。接入成功后助手会自动发现服务器暴露的工具、代你执行 Google Ads Query LanguageGAQL查询并把广告系列数据以 Markdown 表格返回。前提条件来自仓库中的 MCP 安装技能文档Python3.12、pipx已安装且全局可用、机器能出站访问googleads.googleapis.com与 PyPI以及一套完整的 Google Ads API 凭据。准备条件确认 Python、pipx 与 5 项凭据检查运行环境python3 --version # 必须是 3.12 或更高 pipx --version # 必须已安装两项都已满足跳过本节安装内容直接进入 MCP Server 安装。Python 缺失或低于 3.12文档要求先停止把宿主机上的 Python 升级到3.12文档未给出具体升级命令。pipx 缺失按操作系统安装。以下命令都会安装软件包并写入 PATHmacOS 用 Homebrew 或 pipWindows 用 Scoop 或 pipLinux 用apt并需要 sudo 权限。macOSbrew install pipx pipx ensurepath # 若未安装 Homebrew pip install pipx pipx ensurepathWindowsPowerShellscoop install pipx # 或文档给出的替代命令: pip install pipx pipx ensurepathLinuxUbuntu/Debiansudo apt install pipx pipx ensurepath文档明确提示安装 pipx 并执行pipx ensurepath后当前终端会话的 PATH 不会立即更新不要在同一会话里直接运行pipx命令先重启终端或重新加载 shell 配置再继续下一步。核对 5 项 Google Ads 凭据MCP Server 需要与标准客户端库相同的 5 项认证参数凭据文档给出的格式要求Developer Token字母数字来自 Google Ads Manager 账户的 API CenterOAuth2 Client IDDesktop Application 类型形如*.apps.googleusercontent.comOAuth2 Client Secret字母数字OAuth2 Refresh Token经 OAuth 授权流程生成的长期令牌Client Customer ID10 位数字不含连字符如1234567890不能写成123-456-7890Login Customer ID仅 MCC 层级需要10 位 Manager 账户 ID不含连字符如果还缺其中任何一项需要先按仓库中的 google-ads-api-quickstart 技能文档 补齐要点如下Developer Token用 Manager 账户不能用普通投放账户登录 Google Ads在 API Center 复制。注意若 Token 状态为 Pending未批准只能针对 Google Ads 测试账户使用用 Pending Token 查询正式账户会报DEVELOPER_TOKEN_NOT_APPROVED。OAuth Client ID / Secret在 Google Cloud Console 中启用 Google Ads API把 OAuth Consent Screen 设为 External 用户类型、Testing 发布状态并把登录 Google Ads 的那个 Google 账户邮箱加为 Test User否则会阻塞后续授权再到 APIs Services → Credentials 中创建 Desktop App 类型的 OAuth client下载 JSON 文件并保存为client_secrets.json。Refresh Token用 gcloud CLI 执行授权登录client_secrets.json为上一步下载的文件gcloud auth application-default login \ --scopeshttps://www.googleapis.com/auth/adwords,https://www.googleapis.com/auth/cloud-platform \ --client-id-fileclient_secrets.json命令会打开浏览器登录窗口用 Test User 邮箱登录应用未验证时点 Advanced 继续并授予权限。成功后gcloud会提示凭据保存位置通常是~/.config/gcloud/application_default_credentials.json打开该文件复制其中的refresh_token。Client Customer ID登录 Google Ads 界面右上角用户图标旁显示的 10 位 ID。Login Customer ID仅当 OAuth 凭据属于 Manager 账户、而你要查询其下的客户账户时必须提供。MCC 层级中漏配它是USER_PERMISSION_DENIED的首要原因。安装 Google Ads MCP Server 并验证默认从 PyPI 安装稳定版文档要求使用官方google-ads-mcp包不建议第三方未经审核的服务器# 使用必装包管理器 pipx 安装 PyPI 稳定版 pipx install google-ads-mcp可选分支仅当你明确需要 GitHub 上的开发版时才执行# 安装 GitHub 开发版仅在明确需要时 pipx install githttps://github.com/googleads/google-ads-mcp.git安装后验证google-ads-mcp --help如果报 command not found不要判定安装失败或反复重装pipx把可执行文件装在自己的本地目录通常是~/.local/bin此时先用绝对路径确认安装是否成功~/.local/bin/google-ads-mcp --help绝对路径能运行说明安装成功只是PATH未更新重新加载 shell 配置如source ~/.bashrc或source ~/.zshrc或重启终端后google-ads-mcp即可被直接调用。stdio transport 的通信方式宿主机客户端如 Cursor、Claude Desktop把 MCP Server 作为后台子进程启动客户端配置中要写精确的启动命令google-ads-mcp以及承载凭据的环境变量不使用 HTTP/WebSockets 等网络端口全部交互经 stdin/stdout 管道完成stdout专用于 MCP 协议消息因此服务器不会把日志或调试信息打到stdout日志与调试一律走stderr。配置凭据环境变量Method A 或 Method BMCP Server 通过系统环境变量读取凭据。文档给出两种配置方式Method A推荐把环境变量直接写进 MCP 客户端的 JSON 配置文件Cursor 或 Claude Desktop 的设置凭据隔离在单个工具内Method B全局写入 shell profile~/.bashrc、~/.zshrc或 Windows 环境变量。本地 stdio 接入核心用到这 5 个变量环境变量含义格式文档GOOGLE_ADS_DEVELOPER_TOKENGoogle Ads Developer Token字母数字GOOGLE_ADS_CLIENT_IDGoogle Cloud OAuth Client ID*.apps.googleusercontent.comGOOGLE_ADS_CLIENT_SECRETOAuth Client Secret字母数字GOOGLE_ADS_REFRESH_TOKENOAuth Refresh Token字母数字GOOGLE_ADS_LOGIN_CUSTOMER_IDManager 账户MCCID仅经理层级需要10 位数字无连字符文档的变量表中还有GOOGLE_PROJECT_IDApplication Default Credentials / Cloud Run 场景使用以及GOOGLE_ADS_MCP_OAUTH_CLIENT_ID、GOOGLE_ADS_MCP_OAUTH_CLIENT_SECRET、GOOGLE_ADS_MCP_BASE_URL、FASTMCP_HOST四个变量后四者服务于 Cloud Run 部署场景本地 stdio 接入不需要。选择 Method B 时把以下内容追加到 shell profile。your_...是占位符逐一替换为准备阶段拿到的真实值带注释的两组变量分别在 MCC 层级和 ADC/Cloud Run 场景才需要# Google Ads MCP Server Credentials export GOOGLE_ADS_DEVELOPER_TOKENyour_developer_token_here export GOOGLE_ADS_CLIENT_IDyour_oauth_client_id_here export GOOGLE_ADS_CLIENT_SECRETyour_oauth_client_secret_here export GOOGLE_ADS_REFRESH_TOKENyour_oauth_refresh_token_here # Required only for Manager Account hierarchies: export GOOGLE_ADS_LOGIN_CUSTOMER_IDyour_manager_account_id_here # Required for Application Default Credentials (ADC) or Cloud Run deployments: export GOOGLE_PROJECT_IDyour_project_id_here文档同时提醒不要为了省事把凭据硬编码进 MCP Server 的源码 Python 脚本里。把 Server 接入 AI 助手文档给出三条集成路径按你使用的客户端选其一即可。保存配置后必须完整重启 AI 工具Cursor 或 Claude Desktop——MCP 服务器只在应用启动时加载配置改动不会动态生效。路径 1Claude Desktop / Claude Code主路径配置文件位置文档按操作系统列出macOS~/Library/Application Support/Claude/claude_desktop_config.jsonWindows%APPDATA%\Claude\claude_desktop_config.jsonLinux~/.config/Claude/claude_desktop_config.json配置块env中 4 个凭据值替换为准备阶段拿到的真实凭据GOOGLE_ADS_LOGIN_CUSTOMER_ID仅在经理层级需要{ mcpServers: { google-ads: { command: pipx, args: [ run, google-ads-mcp ], env: { GOOGLE_ADS_DEVELOPER_TOKEN: YOUR_DEVELOPER_TOKEN, GOOGLE_ADS_CLIENT_ID: YOUR_OAUTH_CLIENT_ID, GOOGLE_ADS_CLIENT_SECRET: YOUR_OAUTH_CLIENT_SECRET, GOOGLE_ADS_REFRESH_TOKEN: YOUR_OAUTH_REFRESH_TOKEN, GOOGLE_ADS_LOGIN_CUSTOMER_ID: YOUR_MANAGER_ACCOUNT_ID_IF_APPLICABLE } } } }文档建议command用pipx并配args: [run, google-ads-mcp]因为pipx run会自动管理执行路径。如果装的是 GitHub 开发版或使用 Application Default Credentials文档给出的替代配置是把args换成[run, --spec, githttps://github.com/googleads/google-ads-mcp.git, google-ads-mcp]并在env中加GOOGLE_PROJECT_ID: YOUR_PROJECT_ID。路径 2Cursor打开 Cursor进入Settings → Features → MCP点击 New MCP Server填写字段Namegoogle-adsTypestdioCommandpipx run google-ads-mcp在 Environment Variables 中加入GOOGLE_ADS_DEVELOPER_TOKEN、GOOGLE_ADS_CLIENT_ID、GOOGLE_ADS_CLIENT_SECRET、GOOGLE_ADS_REFRESH_TOKEN以及如适用的GOOGLE_ADS_LOGIN_CUSTOMER_ID点击 Save。路径 3AntigravityIDE 或 CLI先在终端会话或 IDE 环境中导出前节的标准环境变量GOOGLE_ADS_DEVELOPER_TOKEN、GOOGLE_ADS_CLIENT_ID、GOOGLE_ADS_CLIENT_SECRET、GOOGLE_ADS_REFRESH_TOKEN在 Antigravity 的设置里按标准stdio集成注册服务器命令为pipx run google-ads-mcpAntigravity 原生支持 MCP连接后会自动发现服务器工具不需要单独编译插件或加载扩展。验证接入先做基线检查再跑测试查询文档要求无论配置的是哪个 AI 客户端都先用 Antigravity CLI 做基线验证——这是最快隔离凭据、网络或服务器启动问题的方式一旦确认 CLI 里服务器健康Cursor/Claude 里剩余的问题就可以归因到 IDE 自身配置。agy进入 CLI 提示符后执行/mcp在返回的 active tools 列表中确认存在google-ads-mcp。如果列表里没有它退出 CLI检查环境变量是否已正确设置并导出然后重启agy。文档直接给出agy启动命令未包含 Antigravity CLI 本身的安装步骤。基线通过后在你的 AI 助手聊天界面执行测试查询把1234567890替换为你真实的 10 位 Customer ID无连字符“Retrieve all campaigns from my Google Ads account1234567890.”“What is the status of the campaigns in Google Ads account1234567890?”文档给出的成功判定接入成功后会发生的流程Tool Discovery助手自动检测到google-ads-mcp的服务器工具Execution助手构造参数经stdiotransport 调用服务器执行查询Response助手把检索到的广告系列数据渲染为清晰的 Markdown 表格通常显示 Campaign Name、ID、Status 和 Budget。客户端侧的连接状态也可以直接检查Cursor 的 MCP 设置里google-ads旁应出现绿色圆点Claude 中工具不出现时检查本地 MCP 日志文件macOS~/Library/Logs/Claude/mcp.logWindows%APPDATA%\Claude\Logs\mcp【免费下载链接】skillsAgent Skills for Google products and technologies项目地址: https://gitcode.com/GitHub_Trending/skills29/skills创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 如何安装配置 Google Ads MCP Server，把 AI 助手接入 Google Ads 账户
如何安装配置 Google Ads MCP Server把 AI 助手接入 Google Ads 账户【免费下载链接】skillsAgent Skills for Google products and technologies项目地址: https://gitcode.com/GitHub_Trending/skills29/skills想让 Cursor、Claude Desktop、Antigravity 这类 AI 助手直接用自然语言查询 Google Ads 账户例如拉取所有广告系列的状态和预算可以安装 Google 官方开源的 Google Ads MCP Server。它通过 Model Context ProtocolMCP的 standard input/outputstdiotransport 与 AI 助手通信AI 客户端把google-ads-mcp作为后台子进程启动配置好精确的启动命令和承载凭据的环境变量后即可调用不监听任何网络端口。接入成功后助手会自动发现服务器暴露的工具、代你执行 Google Ads Query LanguageGAQL查询并把广告系列数据以 Markdown 表格返回。前提条件来自仓库中的 MCP 安装技能文档Python3.12、pipx已安装且全局可用、机器能出站访问googleads.googleapis.com与 PyPI以及一套完整的 Google Ads API 凭据。准备条件确认 Python、pipx 与 5 项凭据检查运行环境python3 --version # 必须是 3.12 或更高 pipx --version # 必须已安装两项都已满足跳过本节安装内容直接进入 MCP Server 安装。Python 缺失或低于 3.12文档要求先停止把宿主机上的 Python 升级到3.12文档未给出具体升级命令。pipx 缺失按操作系统安装。以下命令都会安装软件包并写入 PATHmacOS 用 Homebrew 或 pipWindows 用 Scoop 或 pipLinux 用apt并需要 sudo 权限。macOSbrew install pipx pipx ensurepath # 若未安装 Homebrew pip install pipx pipx ensurepathWindowsPowerShellscoop install pipx # 或文档给出的替代命令: pip install pipx pipx ensurepathLinuxUbuntu/Debiansudo apt install pipx pipx ensurepath文档明确提示安装 pipx 并执行pipx ensurepath后当前终端会话的 PATH 不会立即更新不要在同一会话里直接运行pipx命令先重启终端或重新加载 shell 配置再继续下一步。核对 5 项 Google Ads 凭据MCP Server 需要与标准客户端库相同的 5 项认证参数凭据文档给出的格式要求Developer Token字母数字来自 Google Ads Manager 账户的 API CenterOAuth2 Client IDDesktop Application 类型形如*.apps.googleusercontent.comOAuth2 Client Secret字母数字OAuth2 Refresh Token经 OAuth 授权流程生成的长期令牌Client Customer ID10 位数字不含连字符如1234567890不能写成123-456-7890Login Customer ID仅 MCC 层级需要10 位 Manager 账户 ID不含连字符如果还缺其中任何一项需要先按仓库中的 google-ads-api-quickstart 技能文档 补齐要点如下Developer Token用 Manager 账户不能用普通投放账户登录 Google Ads在 API Center 复制。注意若 Token 状态为 Pending未批准只能针对 Google Ads 测试账户使用用 Pending Token 查询正式账户会报DEVELOPER_TOKEN_NOT_APPROVED。OAuth Client ID / Secret在 Google Cloud Console 中启用 Google Ads API把 OAuth Consent Screen 设为 External 用户类型、Testing 发布状态并把登录 Google Ads 的那个 Google 账户邮箱加为 Test User否则会阻塞后续授权再到 APIs Services → Credentials 中创建 Desktop App 类型的 OAuth client下载 JSON 文件并保存为client_secrets.json。Refresh Token用 gcloud CLI 执行授权登录client_secrets.json为上一步下载的文件gcloud auth application-default login \ --scopeshttps://www.googleapis.com/auth/adwords,https://www.googleapis.com/auth/cloud-platform \ --client-id-fileclient_secrets.json命令会打开浏览器登录窗口用 Test User 邮箱登录应用未验证时点 Advanced 继续并授予权限。成功后gcloud会提示凭据保存位置通常是~/.config/gcloud/application_default_credentials.json打开该文件复制其中的refresh_token。Client Customer ID登录 Google Ads 界面右上角用户图标旁显示的 10 位 ID。Login Customer ID仅当 OAuth 凭据属于 Manager 账户、而你要查询其下的客户账户时必须提供。MCC 层级中漏配它是USER_PERMISSION_DENIED的首要原因。安装 Google Ads MCP Server 并验证默认从 PyPI 安装稳定版文档要求使用官方google-ads-mcp包不建议第三方未经审核的服务器# 使用必装包管理器 pipx 安装 PyPI 稳定版 pipx install google-ads-mcp可选分支仅当你明确需要 GitHub 上的开发版时才执行# 安装 GitHub 开发版仅在明确需要时 pipx install githttps://github.com/googleads/google-ads-mcp.git安装后验证google-ads-mcp --help如果报 command not found不要判定安装失败或反复重装pipx把可执行文件装在自己的本地目录通常是~/.local/bin此时先用绝对路径确认安装是否成功~/.local/bin/google-ads-mcp --help绝对路径能运行说明安装成功只是PATH未更新重新加载 shell 配置如source ~/.bashrc或source ~/.zshrc或重启终端后google-ads-mcp即可被直接调用。stdio transport 的通信方式宿主机客户端如 Cursor、Claude Desktop把 MCP Server 作为后台子进程启动客户端配置中要写精确的启动命令google-ads-mcp以及承载凭据的环境变量不使用 HTTP/WebSockets 等网络端口全部交互经 stdin/stdout 管道完成stdout专用于 MCP 协议消息因此服务器不会把日志或调试信息打到stdout日志与调试一律走stderr。配置凭据环境变量Method A 或 Method BMCP Server 通过系统环境变量读取凭据。文档给出两种配置方式Method A推荐把环境变量直接写进 MCP 客户端的 JSON 配置文件Cursor 或 Claude Desktop 的设置凭据隔离在单个工具内Method B全局写入 shell profile~/.bashrc、~/.zshrc或 Windows 环境变量。本地 stdio 接入核心用到这 5 个变量环境变量含义格式文档GOOGLE_ADS_DEVELOPER_TOKENGoogle Ads Developer Token字母数字GOOGLE_ADS_CLIENT_IDGoogle Cloud OAuth Client ID*.apps.googleusercontent.comGOOGLE_ADS_CLIENT_SECRETOAuth Client Secret字母数字GOOGLE_ADS_REFRESH_TOKENOAuth Refresh Token字母数字GOOGLE_ADS_LOGIN_CUSTOMER_IDManager 账户MCCID仅经理层级需要10 位数字无连字符文档的变量表中还有GOOGLE_PROJECT_IDApplication Default Credentials / Cloud Run 场景使用以及GOOGLE_ADS_MCP_OAUTH_CLIENT_ID、GOOGLE_ADS_MCP_OAUTH_CLIENT_SECRET、GOOGLE_ADS_MCP_BASE_URL、FASTMCP_HOST四个变量后四者服务于 Cloud Run 部署场景本地 stdio 接入不需要。选择 Method B 时把以下内容追加到 shell profile。your_...是占位符逐一替换为准备阶段拿到的真实值带注释的两组变量分别在 MCC 层级和 ADC/Cloud Run 场景才需要# Google Ads MCP Server Credentials export GOOGLE_ADS_DEVELOPER_TOKENyour_developer_token_here export GOOGLE_ADS_CLIENT_IDyour_oauth_client_id_here export GOOGLE_ADS_CLIENT_SECRETyour_oauth_client_secret_here export GOOGLE_ADS_REFRESH_TOKENyour_oauth_refresh_token_here # Required only for Manager Account hierarchies: export GOOGLE_ADS_LOGIN_CUSTOMER_IDyour_manager_account_id_here # Required for Application Default Credentials (ADC) or Cloud Run deployments: export GOOGLE_PROJECT_IDyour_project_id_here文档同时提醒不要为了省事把凭据硬编码进 MCP Server 的源码 Python 脚本里。把 Server 接入 AI 助手文档给出三条集成路径按你使用的客户端选其一即可。保存配置后必须完整重启 AI 工具Cursor 或 Claude Desktop——MCP 服务器只在应用启动时加载配置改动不会动态生效。路径 1Claude Desktop / Claude Code主路径配置文件位置文档按操作系统列出macOS~/Library/Application Support/Claude/claude_desktop_config.jsonWindows%APPDATA%\Claude\claude_desktop_config.jsonLinux~/.config/Claude/claude_desktop_config.json配置块env中 4 个凭据值替换为准备阶段拿到的真实凭据GOOGLE_ADS_LOGIN_CUSTOMER_ID仅在经理层级需要{ mcpServers: { google-ads: { command: pipx, args: [ run, google-ads-mcp ], env: { GOOGLE_ADS_DEVELOPER_TOKEN: YOUR_DEVELOPER_TOKEN, GOOGLE_ADS_CLIENT_ID: YOUR_OAUTH_CLIENT_ID, GOOGLE_ADS_CLIENT_SECRET: YOUR_OAUTH_CLIENT_SECRET, GOOGLE_ADS_REFRESH_TOKEN: YOUR_OAUTH_REFRESH_TOKEN, GOOGLE_ADS_LOGIN_CUSTOMER_ID: YOUR_MANAGER_ACCOUNT_ID_IF_APPLICABLE } } } }文档建议command用pipx并配args: [run, google-ads-mcp]因为pipx run会自动管理执行路径。如果装的是 GitHub 开发版或使用 Application Default Credentials文档给出的替代配置是把args换成[run, --spec, githttps://github.com/googleads/google-ads-mcp.git, google-ads-mcp]并在env中加GOOGLE_PROJECT_ID: YOUR_PROJECT_ID。路径 2Cursor打开 Cursor进入Settings → Features → MCP点击 New MCP Server填写字段Namegoogle-adsTypestdioCommandpipx run google-ads-mcp在 Environment Variables 中加入GOOGLE_ADS_DEVELOPER_TOKEN、GOOGLE_ADS_CLIENT_ID、GOOGLE_ADS_CLIENT_SECRET、GOOGLE_ADS_REFRESH_TOKEN以及如适用的GOOGLE_ADS_LOGIN_CUSTOMER_ID点击 Save。路径 3AntigravityIDE 或 CLI先在终端会话或 IDE 环境中导出前节的标准环境变量GOOGLE_ADS_DEVELOPER_TOKEN、GOOGLE_ADS_CLIENT_ID、GOOGLE_ADS_CLIENT_SECRET、GOOGLE_ADS_REFRESH_TOKEN在 Antigravity 的设置里按标准stdio集成注册服务器命令为pipx run google-ads-mcpAntigravity 原生支持 MCP连接后会自动发现服务器工具不需要单独编译插件或加载扩展。验证接入先做基线检查再跑测试查询文档要求无论配置的是哪个 AI 客户端都先用 Antigravity CLI 做基线验证——这是最快隔离凭据、网络或服务器启动问题的方式一旦确认 CLI 里服务器健康Cursor/Claude 里剩余的问题就可以归因到 IDE 自身配置。agy进入 CLI 提示符后执行/mcp在返回的 active tools 列表中确认存在google-ads-mcp。如果列表里没有它退出 CLI检查环境变量是否已正确设置并导出然后重启agy。文档直接给出agy启动命令未包含 Antigravity CLI 本身的安装步骤。基线通过后在你的 AI 助手聊天界面执行测试查询把1234567890替换为你真实的 10 位 Customer ID无连字符“Retrieve all campaigns from my Google Ads account1234567890.”“What is the status of the campaigns in Google Ads account1234567890?”文档给出的成功判定接入成功后会发生的流程Tool Discovery助手自动检测到google-ads-mcp的服务器工具Execution助手构造参数经stdiotransport 调用服务器执行查询Response助手把检索到的广告系列数据渲染为清晰的 Markdown 表格通常显示 Campaign Name、ID、Status 和 Budget。客户端侧的连接状态也可以直接检查Cursor 的 MCP 设置里google-ads旁应出现绿色圆点Claude 中工具不出现时检查本地 MCP 日志文件macOS~/Library/Logs/Claude/mcp.logWindows%APPDATA%\Claude\Logs\mcp【免费下载链接】skillsAgent Skills for Google products and technologies项目地址: https://gitcode.com/GitHub_Trending/skills29/skills创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考