Bohea

用一句自然语言,管理 Google Ads 广告

一个把 Claude Desktop 直连 Google Ads API 的 MCP 服务器——暂停广告系列、调预算、改关键词出价,开口说一句就行。

PythonMCPGoogle Ads APIOAuth 2.0Claude Desktop

问题

日常的 Google Ads 管理,就是在同样几个后台页面里循环点击:看效果、停掉亏的、给赚的加预算、微调出价。每一步都不难,循环起来就是时间黑洞——而 Ads 的界面偏偏把简单操作埋在层层导航之下。

约束

Google Ads API 很强大,但对轻度使用者极不友好:OAuth 流程、开发者令牌、客户 ID、YAML 配置。目标是把这一切藏到自然语言背后,同时不牺牲真实 API 调用的正确性——并且要在任何凭据存在之前就能演示。

方案

向 Claude Desktop 暴露 7 个工具的 MCP 服务器:

于是"暂停 1002 号广告系列""把 1001 的日预算提到 65 美元",都变成说出来的事,而不是一层层点出来的流程。

真正打动客户的设计:Mock 模式

服务器内置模拟模式:在完全没有凭据的情况下,也能返回逼真的广告数据——几分钟内就能在 Claude Desktop 里体验完整功能,而不用碰任何真实广告账户。上线只是拨一下配置开关:交互式 OAuth 助手脚本会自动生成令牌并写好配置。

这是我刻意坚持的模式:客户先看到能跑的产品,最后才接入真实凭据。信任来自演示,而不是承诺。

证明

Google Ads MCP architecture overview diagram
架构:Claude Desktop ⇄ MCP 服务器 ⇄ Google Ads API,Mock 模式隔离。

随附完整文档交付:技术规格书、带截图的安装验证指南、开发者笔记、Windows 一键安装脚本——中英双语。还包括没人愿意写下来的疑难排查(Google 的"未验证应用"拦截页、测试模式的 OAuth 受众配置)。公开版在 GitHub 上——自带无需任何凭据即可试跑的 Mock 模式。  代码 →

还能用在哪

任何你的团队每天都要通过笨重后台去碰的 API,都可以做成 MCP 服务器:广告平台、CRM、电商后台、内部管理面板。如果团队已经在用 Claude,以后这些系统开口问一句就能操作。

如果你造的机器需要一套界面、一个设备连接,或者数据必须落到别处去——告诉我它现在正让你付出什么代价。你会得到一个诚实的判断:能不能解;通常还会收到一个能跑的东西。从这里开始 →

← 全部案例