Ads MCP Connector

ads-mcp连接器

将Claude Code连接到元广告和谷歌广告。用简单的英语询问有关您的广告系列的问题。没有CSV导出，没有复制粘贴，没有手动数据拉取。

为营销团队打造 @本海瑟.

______________________________________________________________________

安装

在下面选择您的计算机类型。安装程序会问你几个问题，并自动处理其他所有问题。

______________________________________________________________________

在Mac上

步骤1--打开终端

按 Cmd + Space，类型 终端，然后按Enter键。

将出现一个带有文本提示的窗口。这就是你所需要的——这只是一种基于文本的方式来给你的电脑下达指令。

步骤2--运行安装程序

复制此行，将其粘贴到终端，然后按Enter键：

curl -fsSL https://raw.githubusercontent.com/benheis/ads-mcp-connector/main/install.py | python3

安装程序将引导您完成其余部分。大约需要5分钟。

______________________________________________________________________

在Windows上

步骤1：确保已安装Python

Python是此工具运行的免费程序。要检查您是否已经拥有它：

1. 按 Windows键，类型 命令，然后按Enter键打开命令提示符
2. 键入此内容并按Enter键：

   python --version

1. 如果你看到类似的东西 Python 3.11.0，你很好——跳到第二步
2. 如果你遇到错误或看到低于3.10的版本，你需要先安装Python

没有Python？ 在PowerShell中运行此命令以自动打开下载页面：

python --version 2>$null; if ($LASTEXITCODE -ne 0) { Start-Process "https://www.python.org/downloads/" }

下载并安装Python（大约需要3分钟）。安装时，勾选以下框 “将Python添加到PATH” --这很重要。那就回来。

步骤2--运行安装程序

在命令提示符中，复制此行，将其粘贴进去，然后按Enter键：

curl -fsSL https://raw.githubusercontent.com/benheis/ads-mcp-connector/main/install.py | python

安装程序将引导您完成其余部分。大约需要5分钟。

______________________________________________________________________

安装程序的作用：

• 将此连接器下载到您的计算机（到名为 ads-mcp-connector)
• 仅为此工具设置一个私有Python工作区
• 将其连接到您选择的任何AI工具（Claude Code、Claude Desktop或Cursor）
• 创建一个永不离开计算机的安全凭据文件

______________________________________________________________________

支持的工具

安装程序会检测您安装了哪些工具，并自动向所有工具注册。如果稍后安装新工具，只需运行 bash install.sh 再一次。

______________________________________________________________________

用法

克劳德代码 --打开任何项目并键入：

/ads-connect

该技能将逐步指导您连接广告帐户。

克劳德桌面/协作 --安装后重新启动，然后只需询问：

Connect my Meta Ads account

光标 --安装后重新启动，打开代理模式，然后询问：

Connect my ad accounts and show me last month's campaigns

连接后，使用以下任何工具用简单的英语提问：

Show me my campaigns from last month

What search terms are triggering my Google Ads?

Compare Meta and Google spend this week

Break down my top campaign by age and gender

What's my ROAS across both platforms?

______________________________________________________________________

它能做什么

提取您的数据（提问）

• 查看Meta和Google上的活动、广告集和广告表现——支出、CPA、ROAS、CTR、覆盖率、频率
• 按年龄、性别、职位或设备细分任何活动
• 查看触发您的Google广告的确切搜索词
• 拉动每月的受众覆盖趋势，进行受众饱和度分析

进行更改（采取行动）

不再切换标签。现在，你可以从克劳德那里完成所有这些：

元广告

• 暂停或启用活动、广告集和单个广告
• 更新活动或广告集的每日或终身预算
• 在CBO活动中设置每个广告集的最低和最高支出
• 端到端构建新活动：创建活动→ 广告组→ 上传您的图片或视频→ 培养创造力→ 发布广告

谷歌广告

• 暂停或启用活动和广告组
• 添加和删除负面关键字（活动或广告组级别）
• 更新关键字出价
• 更新活动预算
• 创建新的广告系列、广告组和响应式搜索广告

______________________________________________________________________

如何存储凭据

您的API密钥存储在 .env 文件在 ~/ads-mcp-connector/.env。此文件是：

• Gitigned --从未加入GitHub
• 仅限本地 --留在你的机器上
• 由技能撰写 --您永远不需要手动编辑它

这 /ads-connect 技能将您的凭据直接从Claude聊天写入 .env 文件。你在聊天中粘贴一个令牌，该技能会安全地保存它——全部价值永远不会被回显。

凭证有效期

______________________________________________________________________

从谷歌表格上传广告（代理工作流程）

如果您的团队在Google表格中跟踪广告系列，您可以直接从表格中启动广告，而无需触摸广告管理器。

运作原理

1. 您的工作表中每个要发布的广告都有一行——活动、广告集、广告名称、标题、副本、资产URL、CTA
2. 集 Status = READY 在要启动的行上
3. 问克劳德： *“在我的贩运表中启动READY行”*
4. Claude向您展示了它将创建的内容的预览（模拟运行）
5. 你确认了——克劳德上传了每一项资产，构建了创意，并在暂停时创建了广告
6. 工作表将更新： Status = LAUNCHED 使用新的广告ID，或 Status = ERROR 原因

图纸格式

谷歌表格设置（一次性，约10分钟）

1. 首选 console.cloud.google.com → API和服务 → 启用API → 启用 谷歌网页API
2. 首选 凭证 → 创建凭据 → 服务账户 → 下载JSON密钥
3. 添加到您的 .env:

   GOOGLE_SHEETS_CREDENTIALS_PATH=/path/to/your-service-account-key.json

1. 使用服务帐户电子邮件（位于JSON密钥内）共享您的Google表格 编辑 访问权限，以便克劳德可以写回状态

资产URL

资产可以来自任何地方：

• Google 云端硬盘：共享文件→ 复制链接→ 粘贴 drive.google.com/file/d/... 直接将URL导入工作表
• 直接URL：任何 https:// 链接到a .jpg, .png, .mp4，或 .mov 文件

______________________________________________________________________

安全

此仓库的每个提交都会自动扫描以查找暴露的凭据。

如果您不小心将API密钥粘贴到源文件中并尝试提交它，那么提交将被阻止，并提供一个简单的英语解释。

要运行手动扫描，请执行以下操作：

python secrets_check.py

______________________________________________________________________

工具参考

克劳德能用你的广告账户做的一切。人工智能会自动选择正确的工具——你只需用简单的英语提问。

元广告--阅读

元广告——进行更改

谷歌广告——阅读

谷歌广告——进行更改

______________________________________________________________________

故障排除

Claude Code无法识别 /ads-connect 跑 bash ~/ads-mcp-connector/install.sh 再次启动Claude Code。

元令牌已过期 跑 /ads-connect --该技能会自动检测到期时间，并引导您完成续订（2分钟）。通过使用系统用户设置路径（令牌永不过期）完全避免这种情况。

Google返回身份验证错误 您的刷新令牌可能已被吊销。首选 myaccount.google.com/permissions，删除应用程序的访问权限，然后运行 python get_google_token.py 生成一个新的。

预提交挂钩未运行 跑 bash install.sh 从repo目录中重新安装它。

______________________________________________________________________

相关

元帐户诊断 --同伴技能(/meta-diagnostics)它运行完整的7分析Meta Ads帐户审核，并生成Streamlit仪表板。将其插入任何支持MCP的AI工具。

______________________________________________________________________

高级：谷歌官方MCP服务器

谷歌为谷歌广告维护了自己的开源MCP服务器： developers.google.com/google-ads/api/docs/developer-toolkit/mcp-server

它也在本地运行，值得了解，但它是为开发人员而不是营销人员设计的。需要注意的几个差异：

当你选择谷歌的服务器时： 你的团队有一个开发人员想要完全的GAQL查询灵活性，并且已经对谷歌云凭据感到满意。

当您选择此连接器时： 你是一个营销人员，想要一个有指导的设置和简单的英语工具，而不需要编写查询语法。

______________________________________________________________________

许可证

麻省理工学院——使用它，分叉它，建立在它之上。