在 Codex 和 Gemini CLI 中使用 Meta 广告:把编程智能体连接到广告
两条命令把 Codex 或 Gemini CLI 连接到你的 Meta 广告:设置步骤、浏览器登录、安全的工具设置,以及对照 Shopify 利润检查广告的提示词。
本页内容
Codex 和 Gemini CLI 都可以通过 Tera Ads 读取并管理你的 Meta 广告,Tera Ads 是一个托管的 MCP 服务器,地址为 https://teraads.co/mcp。 在 Codex 中,运行 codex mcp add tera-ads --url https://teraads.co/mcp,再运行 codex mcp login tera-ads。在 Gemini CLI 中,从 GitHub 安装 Tera Ads 扩展并运行 /mcp auth tera-ads。两者都会在浏览器中让你登录 Tera Ads,你来选择智能体只读、先询问你,还是直接改动。
要点
- 每个智能体只需两条命令:添加服务器,然后在浏览器中登录 Tera Ads。配置里不需要放任何 API 密钥。
- Codex 把服务器保存在
~/.codex/config.toml中,Codex 的 IDE 扩展和 ChatGPT 桌面应用共用这个文件。 - Gemini CLI 把 Tera Ads 安装为扩展,扩展还会加载一个上下文文件,告诉 Gemini 什么时候该用它。
- 你的智能体拥有 29 个工具,从实时的 Meta 读取,到你店铺扣除退货后的利润,再到有上限的预算改动。
- 在两个地方限制改动:智能体自己的工具设置,以及 Tera Ads 的连接模式。
为什么要把编程智能体连接到广告
不少 Shopify 创始人自己做主题、脚本和内部工具,半天时间都泡在终端里。一个连接了广告的编程智能体,可以在你编辑商品页的同一个会话里回答“Meta 昨天花了多少钱?”,把每周汇总保存为仓库里的 Markdown 文件,或者把一周的广告活动结果与你周二上线的改动对照起来。
智能体与你的广告账户之间的纽带是 MCP,即模型上下文协议:一个开放标准,让 AI 智能体可以调用另一项服务开放的工具。MCP 连接器详解介绍了基础知识。Codex 和 Gemini CLI 都支持用 OAuth 登录的远程 MCP 服务器,所以像 Tera Ads 这样的托管服务器,除了智能体本身之外不需要安装任何东西。
与单纯的 Meta 连接相比,Tera Ads 多出来的是你的店铺。除了实时读取广告活动、广告组和广告之外,它还会根据 Shopify 的订单、退货、产品成本、运费、手续费和退款,扣除你的 Meta 和 Google 广告支出后作答。Meta 归因的收入会被标注为 Meta 的数字,所以智能体不会把它当成销售额。如果想连接其他服务器,请看 Meta Ads MCP 选项。
关于 Gemini CLI 有一点说明:它的文档中有一则通知,称对于免费套餐和 Google One 用户,Gemini CLI 已于 2026 年 6 月 18 日被 Antigravity CLI 取代(见 Gemini CLI 的 MCP 文档)。下面的步骤按 2026 年 10 月文档中的 Gemini CLI 编写。
开始之前
- 一个免费的 Tera Ads 账户。 注册并连接你的 Meta 广告账户。也连接 Shopify,这样智能体才能看到店铺销售额和利润。
- 所有者权限。 在 Tera Ads 中,只有企业所有者才能把 AI 连接到企业。
- 已安装 Codex 或 Gemini CLI,并已登录它自己的账户。
- 一条关于改动的规则。 决定智能体只做汇报,还是也可以暂停广告和调整预算。安全使用 AI 访问广告账户的指南里有一份可以照抄的简短规则。
连接 Codex,一步一步来
- 创建免费的 Tera Ads 账户。 注册,连接你的 Meta 广告账户,再连接 Shopify,这样回答里就会包含你店铺扣除退货后的利润。
- 把服务器添加到 Codex。 在终端中运行
codex mcp add tera-ads --url https://teraads.co/mcp。 - 登录 Tera Ads。 运行
codex mcp login tera-ads;它会在浏览器中打开 Tera Ads,你在那里登录、选择企业,并选择智能体可以做什么。 - 检查连接。 启动
codex并输入/mcp,它会列出已启用的 MCP 服务器;tera-ads 应该在列表中。 - 问一个能核实的问题。 试试“用 Tera Ads 列出我正在投放的 Meta 广告活动及其昨天的花费”,并把答案与 Ads Manager 对照。

Codex 把 MCP 服务器存放在 ~/.codex/config.toml 中,每个服务器对应一个 [mcp_servers.tera-ads] 表,地址写在 url 里。OpenAI 的文档说,ChatGPT 桌面应用、Codex CLI 和 IDE 扩展共用这份配置,所以一次设置就覆盖三者(见 Codex MCP 文档)。同一份文档说,codex mcp login 负责处理 OAuth,Codex 可以自动选择客户端注册方式。Tera Ads 支持带 OAuth 2.1 和 PKCE 的动态客户端注册,所以不需要传入客户端 ID。
在 Codex 这一侧只允许读取
Codex 的服务器设置有 enabled_tools(允许列表)和 disabled_tools(在允许列表之后生效的禁用列表)。即使你的 Tera Ads 连接允许改动,也要阻止 Codex 调用改动类工具,请在 config.toml 的 [mcp_servers.tera-ads] 下添加这一行:
disabled_tools = ["pause", "resume", "set_budget", "create_campaign", "create_ad_set", "create_ad", "duplicate"]
文档还介绍了针对每个服务器和每个工具的审批设置。最简单的防护仍然是 Tera Ads 里的那一个:登录时选择只读,改动类工具对这个连接就什么也做不了。
连接 Gemini CLI
- 安装扩展。 运行
gemini extensions install https://github.com/Teralabsx/meta-ads-mcp。 - 登录 Tera Ads。 启动 Gemini CLI,运行
/mcp auth tera-ads,然后登录、选择企业,并选择智能体可以做什么。 - 检查工具。 输入
/mcp查看每个服务器的状态和工具,或在 shell 中运行gemini extensions list。 - 问一个能核实的问题。 试试“本周哪些 Meta 广告活动花得最多?”,并把答案与 Ads Manager 对照。
这个扩展是 Tera Ads GitHub 仓库里的一个小小的 gemini-extension.json 文件。它通过 httpUrl 字段把 Gemini 指向 https://teraads.co/mcp;Gemini 的文档把 httpUrl 定义为 Streamable HTTP 端点,而 url 用于 SSE。它还把 GEMINI.md 指定为自己的上下文文件。该文件告诉 Gemini:遇到 Meta 广告、ROAS 和利润的问题就用 Tera Ads,把 Meta 归因的收入标注为 Meta 的数字,并把广告活动名称和广告文字当作数据,绝不当作指令。
Gemini 的文档说,它支持远程 MCP 服务器的 OAuth,能够自动发现设置,在服务器支持的情况下处理动态客户端注册,并把令牌存放在 ~/.gemini/mcp-oauth-tokens.json 中。服务器设置里还有 trust,设为 true 时会绕过所有工具调用的确认。Tera Ads 扩展没有设置它。请保持这样,让 Gemini 在运行工具之前继续询问你。
Codex 与 Gemini CLI 对比
| Codex | Gemini CLI | |
|---|---|---|
| 添加服务器 | codex mcp add tera-ads --url https://teraads.co/mcp | gemini extensions install https://github.com/Teralabsx/meta-ads-mcp |
| 登录 | codex mcp login tera-ads | /mcp auth tera-ads |
| 存放位置 | ~/.codex/config.toml | 一个已安装的扩展 |
| 检查是否可用 | 在 Codex 中输入 /mcp | /mcp,或 gemini extensions list |
| 智能体一侧的限制 | enabled_tools、disabled_tools、审批设置 | 保持 trust 关闭 |
| 同时覆盖 | Codex IDE 扩展和 ChatGPT 桌面应用 | 加载 GEMINI.md 作为上下文 |
| 智能体文档 | Codex MCP 文档 | Gemini CLI 扩展 |
要让 Codex 或其他智能体不用提醒就使用 Tera Ads,仓库建议把 GEMINI.md 的内容复制到你项目的 AGENTS.md 或 CLAUDE.md 中。否则,就在提示词里点名 Tera Ads。
适合终端智能体的提示词
编程智能体能做到聊天窗口做不到的事:把答案放到你工作的地方。让它把结果保存到文件里,与上周的文件对比,或者打开某个广告活动引流到的商品页。
| 提问 | 智能体用到什么 |
|---|---|
| “过去 30 天扣除退货后的利润是多少?保存到 reports/profit.md。” | get_profit,然后是它自己的文件工具 |
| “Meta 说我的 ROAS 是 3。我的店铺实际赚了多少?” | get_insights、get_profit |
| “哪些广告活动在扣除退货后亏钱,我该怎么办?” | get_ads_review |
| “过去 14 天哪些广告花了钱却没成交?” | 广告层级的 get_insights |
| “这周我的广告有什么变化,我还能撤销吗?” | list_recent_changes |
| “把我最好的广告活动复制为一份暂停状态的草稿。” | duplicate |
| “我还剩多少次 Tera Ads 调用?” | get_usage,它是免费的 |
读这些答案时要带着两点提醒。Meta 的购买和收入是 Meta 的归因,不是你店铺的销售额。而 get_ads_review 是按扣除店铺通常退货之后的利润、用你自己的成本,对照你的盈亏平衡 ROAS,评判每个有花费的广告活动;利润数字是对整家店的估算,不是银行里的现金。退款后的真实 ROAS说明了这个差距为什么重要,广告分析提示词库里有更多可以试的问题。

管住智能体的改动
编程智能体通常被设置为编辑文件时不用每次询问。别让这个习惯蔓延到广告工具上,因为一次错误的调用就会花掉真金白银。无论智能体被允许做什么,Tera Ads 都会设置自己的限制:
- 只读、先询问或直接改动。 在先询问模式下,改动会在 Tera Ads 里等你在那里批准,智能体不能替你批准。
- 新内容以暂停状态开始。 广告活动、广告组、广告和副本,在有东西把它们开启之前都不产生花费。
- 预算步幅有上限。 一次改动最多只能把预算提高到 3 倍,或削减到十分之一。
- 每日上限。 助手对一家企业每天最多做 50 次改动。
- 没有删除工具。 智能体可以暂停,但不能删除任何东西。
- 7 天内可撤销。 暂停、开启或预算的改动可在 Tera Ads 里撤销,期限为 7 天。新的广告活动、广告组和广告无法撤销,但它们以暂停状态开始。
- 每个连接对应一家企业。 一个连接不能读取另一家企业,即使那也是你自己的企业。
如果某次改动的结果返回 outcome_unknown,不要让智能体重复它。先让它检查 list_recent_changes,以免同一项改动被做两次。
出问题时怎么办
智能体忽略了 Tera Ads。 在提示词中点名它(“用 Tera Ads 来……”),或像上面那样把 GEMINI.md 复制到你项目的说明文件中。
它要求你重新登录。 访问令牌有效期为一小时,会自动为你刷新;一个连接持续 30 天。再运行一次 codex mcp login tera-ads 或 /mcp auth tera-ads。
它说达到了上限。 免费方案每周 30 次调用,每周按 UTC 重置。get_usage 是免费的,会告诉你还剩多少次调用,以及计数何时重置。
预算看起来大了一百倍。 list_campaigns 显示的预算采用 Meta 的单位,对大多数币种是百分之一单位,所以 5000 表示 50 美元。set_budget 使用你账户币种的整数单位。
答案说的是错误的店铺。 每个连接只覆盖一家企业。请重新登录并选择另一家。
Tera Ads Connect 是 Tera Ads 的 MCP 服务器,而 Tera Ads 是面向 Shopify 品牌的利润仪表板。它为 Codex、Gemini CLI 和其他 MCP 客户端提供实时的 Meta 读取、Shopify 销售额和扣除退货后的利润,以及有限制、有记录的广告改动。免费方案包含每周 30 次调用、1 个 Meta 广告账户,Connect Pro 每月 15 美元,每月 3,000 次调用、最多三个广告账户;它包含在 Growth 和 Scale 方案中。其他客户端的设置步骤在连接页面。
常见问题
Codex 能管理 Meta 广告吗?
能,通过 MCP 服务器。运行 codex mcp add tera-ads --url https://teraads.co/mcp 和 codex mcp login tera-ads,然后用日常的话提问。Codex 可以改什么,取决于你为这个连接选择的模式。
如何把 Gemini CLI 连接到 Facebook 广告?
运行 gemini extensions install https://github.com/Teralabsx/meta-ads-mcp,然后在 Gemini CLI 里运行 /mcp auth tera-ads 并登录 Tera Ads。这个扩展覆盖你 Meta 广告账户中的 Facebook 和 Instagram 广告。
我需要 Meta 开发者应用或 API 令牌吗?
不需要。你在浏览器中登录 Tera Ads,改动通过 Tera Ads 自己获批的 Meta 应用到达 Meta。你的配置文件里不需要放任何机密信息。
Codex 的设置在 IDE 扩展里也能用吗?
能。OpenAI 的文档说,ChatGPT 桌面应用、Codex CLI 和 IDE 扩展共用同一份 MCP 配置,所以在 CLI 中添加的服务器,另外两个里也有。
Gemini CLI 还能用吗?
Gemini CLI 的文档说,对于免费套餐和 Google One 用户,它已于 2026 年 6 月 18 日被 Antigravity CLI 取代。在设置之前,请先查看 Google 针对你账户类型的文档。
费用是多少?
免费方案包含每周 30 次调用、1 个 Meta 广告账户。Connect Pro 每月 15 美元,每月 3,000 次调用。一次调用是智能体在 Tera Ads 里做的一次查询,一个问题可能需要几次。