Agency AI MCP

---

📋 目录

• 概览
• 你可以做什么
• 工具参考
• 广告管理与自动驾驶
• 平台
• 要求
• 快速入门
• 示例提示词
• 常见问题
• 链接

---

🎯 概览

Agency AI MCP 可将 Claude 和 ChatGPT 转变为 Meta（Facebook、Instagram）和 Google 广告账户的首席营销官。告诉它一个目标，而不是一份待办清单——例如“让综合 ROAS 保持在 3 以上，并扩大效果良好的广告活动”——它就能在聊天中分析、投放、优化并报告：

✨ 效果分析——广告活动数据、细分数据、NCROAS 和高级 KPI 🎯 策略——预算建议、创意建议、扩量计划 ⚡ 广告创建与编辑——创建转化优化型广告、更新预算、暂停或投放广告活动 🤖 自动驾驶——使用 Claude 和 ChatGPT 的定时任务安排重复广告管理 ⏱️ 快速高效——与直接对接广告平台的 MCP 相比，响应更快、Token 消耗更少

---

🎨 你可以做什么

📊 分析师

获取 Meta 和 Google 广告活动数据、效果细分数据、NCROAS 和高级 KPI。了解哪些有效，哪些无效。

💡 Example: "Compare my top 5 campaigns by ROAS last month"

🎯 策略师

获取预算建议、创意建议、扩量计划以及跨渠道广告活动规划策略。

💡 Example: "Which campaigns should I scale and why?"

⚡ 广告管理者

只需几秒钟，就能在 Meta 和 Google 上创建新广告、暂停效果不佳的广告、调整预算并投放广告活动，无需离开聊天。为其设置计划，即可让账户自动管理。

💡 Example: "Pause all campaigns with ROAS below 2:1"

---

🧰 工具参考

共有 15 个工具：10 个用于分析的读取工具，以及 5 个用于广告管理的写入工具。

📖 读取工具

工具	返回内容
get_brand_info	品牌概况和经济指标——商店销售什么、受众是谁，以及盈亏平衡 ROAS
get_campaigns	Meta + Google 广告系列，包含支出、收入、ROAS、展示次数、点击次数、转化次数和目标
get_adsets	Meta 广告组（含每日预算和表现）或 Google 资产组
get_ads	日期范围内的 Meta 广告表现，按支出排名；也是 create_ad 的源广告选择器
get_ad_creative	一则 Meta 广告的创意素材：类型、主要文案、标题、描述、CTA、落地页和媒体 URL
get_performance_timeseries	每个已连接平台的每日支出、收入和 ROAS——每个平台每天一行，每行包含 data_status（complete、partial、not_synced、error）以及每个平台的 last_synced_at；时间范围最长为 366 天
get_pacing	各平台本月至今的支出与您设置的月度预算对比；无法获取支出的平台会标记为 available: false，且不提供支出数值；spendComplete: false 表示总额未计入该平台
get_anomalies	过去 30 天中统计上异常的支出 / ROAS 日期
get_recommendations	AI 优化建议，附带推理过程和置信度
get_operation_status	已排队广告创建操作的进度、结果或错误

✍️ 广告管理工具（写入）

工具	更改内容
create_ad	创建新的 Meta 广告系列、广告组或广告——使用全新且针对转化优化的创意素材，或现有广告的创意素材
update_campaign	Meta 和 Google 广告系列的名称、每日预算和 / 或状态
update_adset	Meta 广告组的名称、每日预算和 / 或状态；Google 资产组的名称和 / 或状态
update_ad	Meta 广告的名称和 / 或状态
set_campaign_status	一次调用即可启动或暂停最多 25 个广告系列，支持两个平台

---

⚡ 广告管理与自动驾驶（写入工具）

五个写入工具可让 Claude 或 ChatGPT 创建广告、编辑广告系列，并直接操作您的广告账户。未经您的确认，任何操作都不会执行：助手会在执行每项写入操作前先向您确认——详见下文的防护措施。

🛠️ 各写入工具的功能

create_ad——创建新的 Meta 广告系列、广告组或广告。创意素材有两种来源：Agency AI 生成的全新且针对转化优化的创意素材和文案，或您指定的现有广告（复用其创意素材）。placement 决定创建的结构：

placement	创建内容
new-campaign	广告系列 + 广告组 + 广告（需要每日预算）
new-adset	在现有广告系列中创建广告组 + 广告
existing-adset	仅在现有广告组中创建广告

创建操作会在后台运行，并返回一个 operation_id；请让助手查询进度，助手会调用 get_operation_status。新广告组不会继承源广告组的投放时间安排：除非您指定未来日期，否则新广告组不会设置结束日期。

update_campaign——在 Meta 或 Google 上重命名广告系列、更改其每日预算和 / 或启动 / 暂停广告系列。每个字段都会单独报告结果，因此部分成功（“已重命名，但预算遭到拒绝”）会如实返回，而不会被统统归为失败。

update_adset——为 Meta 广告组更改相同的三个字段。Google 资产组仅支持名称和状态；其预算由广告系列控制。

update_ad——重命名或启动 / 暂停 Meta 广告。仅限 Meta——Google Performance Max 没有独立的广告层级。

set_campaign_status——一次调用即可批量启动 / 暂停最多 25 个广告系列，支持混合使用 Meta 和 Google。每个广告系列都会独立成功或失败，结果会列出每项操作的结果，因此一个无效 ID 不会阻碍其他操作。

🤖 自动驾驶

将写入工具与 Claude 和 ChatGPT 内置的计划任务搭配使用，即可自动执行日常广告管理。只需用通俗英语设置一次规则，助手就会按计划运行：

• 每天上午 9 点检查一次，暂停 ROAS 低于盈亏平衡点的所有项目
• 每周一将预算重新分配给上周表现最好的项目
• 每天扫描异常情况，在异常支出不断累积前发出提示

🛡️ 防护措施

• 🔐 仅限你的账户 – 账户根据你已验证的连接确定，不会采用助手传入的账户信息。不属于你已连接的 Meta 或 Google 账户的 ID 会在执行任何写入操作前被拒绝。
• ✅ 先确认 – 写入工具向 Claude 和 ChatGPT 声明为破坏性操作（readOnlyHint: false、destructiveHint: true），因此助手会在执行前征求确认，客户端也可以显示自己的审批提示。服务端还会指示模型在执行任何写入操作前先向你确认。
• 💰 预算上限 – Meta 的每日预算限制在 $1–$5,000/天，无论在聊天中还是在控制面板中都一样。
• 📋 与控制面板使用相同的流程 – 写入操作通过 Agency AI 控制面板使用的相同服务和所有权检查执行，每项更改都会记录在活动日志中。
• 📊 调用计量 – 每次工具调用都会记录到你的账户中（工具、时长、响应大小、错误），因此可以审计助手执行的操作。
• ↩️ 可撤销 – 可用相同方式重新启用任何已暂停的项目。可以使用 get_operation_status 检查排队中的广告创建操作；如果改变主意，可暂停其结果。

---

🛒 平台

Agency AI MCP 适用于任何电商平台或网站——连接你的 Meta 和 Google 广告账户后，上述功能即可使用。

使用 Shopify？ Agency AI Shopify 应用会增加更深入的数据层——将商店收入与广告支出相匹配，并提供 NCROAS 和高级 KPI，从而实现最准确的分析和自动化。我们推荐 Shopify 商店使用此应用。

不使用 Shopify？ 在 agencyai.app/mcp 创建独立的 Agency AI 账户，并直接连接你的 Meta 和 Google 广告账户。

---

✅ 要求

• ✔️ 一个 Agency AI 账户——安装 Shopify 应用，或在任何平台上创建账户
• ✔️ 任意 Claude 套餐（包括免费套餐），或支持自定义连接器的 ChatGPT 套餐
• ✔️ 在 Agency AI 中至少连接一个广告账户（Meta 和/或 Google）

---

🚀 快速开始

端点 URL

https://s.agencyai.app/mcp

ChatGPT 需要使用此 URL；Claude 会在其连接器目录中找到 Agency AI。

📱 Claude 设置

1. 打开 Claude（claude.ai）
2. 点击你的个人资料 → Settings → Connectors
3. 点击 Browse connectors，然后搜索 Agency AI
4. 点击 Connect
5. 根据提示使用你的 Agency AI 账户登录
6. ✅ 完成！开始向 Claude 咨询你的广告

找不到？点击 Add custom connector，然后粘贴 https://s.agencyai.app/mcp。

💬 ChatGPT 设置

1. 打开 ChatGPT（chatgpt.com）
2. 点击你的个人资料 → Settings → Connectors
3. 点击 Add connector
4. 粘贴：https://s.agencyai.app/mcp
5. 根据提示使用你的 Agency AI 账户登录
6. ✅ 完成！开始向 ChatGPT 咨询你的广告

📖 需要详细步骤？ 请参阅 llms-install.md，了解完整的操作指南。

---

💬 示例提示词

尝试向已连接的 Claude 或 ChatGPT 提出以下问题：

📊 Analysis
"How did my Meta campaigns perform last 30 days vs prior 30?"
"Show me my top 10 best-performing ads by ROAS"
"Which campaigns are underperforming and why?"

🎯 Strategy
"Which ads should I iterate on and which should I cut?"
"Where should I shift budget this week?"
"Give me creative recommendations for my top 5 performers"

⚡ Ad Management
"Pause all campaigns with ROAS below 2:1"
"Create a new ad for our bestseller and launch it in a new campaign at $50/day"
"Raise Spring Drop's daily budget to $150"
"Every weekday at 9am, check my account and pause anything below breakeven"

---

❓ 常见问题

Agency AI MCP 是什么？ 这是一个 MCP 服务，可将您的 Meta 和 Google 广告账户连接到 Claude 和 ChatGPT。它可处理效果分析、预算优化、创意建议和扩量策略，还能通过聊天创建广告、编辑广告系列并自动管理您的账户。

我需要使用 Shopify 吗？ 不需要。Agency AI MCP 适用于任何电商平台或网站。Shopify 商店通过 Agency AI Shopify 应用可获得最深入的数据层和最准确的自动化功能，因此如果您使用 Shopify，我们建议安装该应用。

Claude 或 ChatGPT 真的能创建和编辑我的广告吗？ 可以。您的助手可以创建新的转化优化广告、修改预算和名称，还可以在 Meta 和 Google 上暂停或启动广告系列、广告组和广告。

未经我批准，它会进行任何更改吗？ 不会。写入工具会声明为具有破坏性，因此您的助手会在执行操作前与您确认。更改设有预算上限，并会检查所有权，而且每项更改都会记录在您的活动日志中。

这与直接连接 Meta 或 Google MCP 有什么不同？ 一个连接器即可覆盖两个平台，并内置预计算的 KPI、策略层和广告创建功能。与直接连接广告平台的 MCP 相比，它的响应速度更快，Token 消耗也更少。

费用是多少？ Agency AI 套餐已包含 MCP 访问权限。请前往 agencyai.app/mcp 创建账户以开始使用。

---

🔗 链接

链接	用途
🌐 网站	详细了解 Agency AI
🚀 开始使用	创建账户并连接
🛍️ Shopify 应用	从 Shopify 应用商店安装
📧 支持	获取帮助或发送反馈

📄 许可证

本项目采用 Apache License 2.0 许可，详情请参阅 LICENSE 文件。