跳到内容
广告 AI

在 Codex 和 Gemini CLI 中使用 Meta 广告:把编程智能体连接到广告

两条命令把 Codex 或 Gemini CLI 连接到你的 Meta 广告:设置步骤、浏览器登录、安全的工具设置,以及对照 Shopify 利润检查广告的提示词。

更新于 8 分钟阅读作者 Tera Ads editorial team事实核查于

其他语言 English · Español · Português · Deutsch · Français · Italiano · Bahasa Indonesia · Nederlands · Türkçe · Polski · 日本語 · 한국어 · 繁體中文 · हिन्दी · العربية · עברית · Русский · Українська · Svenska · Dansk · Norsk bokmål · Suomi · Čeština · Română · Magyar · Ελληνικά · ไทย · Tiếng Việt · Bahasa Melayu · Filipino · Български · Slovenčina · Hrvatski · Lietuvių · Slovenščina

本页内容
  1. 为什么要把编程智能体连接到广告
  2. 开始之前
  3. 连接 Codex,一步一步来
  4. 连接 Gemini CLI
  5. Codex 与 Gemini CLI 对比
  6. 适合终端智能体的提示词
  7. 管住智能体的改动
  8. 出问题时怎么办
  9. 常见问题

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,一步一步来

  1. 创建免费的 Tera Ads 账户。 注册,连接你的 Meta 广告账户,再连接 Shopify,这样回答里就会包含你店铺扣除退货后的利润。
  2. 把服务器添加到 Codex。 在终端中运行 codex mcp add tera-ads --url https://teraads.co/mcp。
  3. 登录 Tera Ads。 运行 codex mcp login tera-ads;它会在浏览器中打开 Tera Ads,你在那里登录、选择企业,并选择智能体可以做什么。
  4. 检查连接。 启动 codex 并输入 /mcp,它会列出已启用的 MCP 服务器;tera-ads 应该在列表中。
  5. 问一个能核实的问题。 试试“用 Tera Ads 列出我正在投放的 Meta 广告活动及其昨天的花费”,并把答案与 Ads Manager 对照。
编程智能体如何连接 Tera Ads:添加服务器、登录、选择企业和模式,然后提问
编程智能体如何连接 Tera Ads:添加服务器、登录、选择企业和模式,然后提问

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

  1. 安装扩展。 运行 gemini extensions install https://github.com/Teralabsx/meta-ads-mcp。
  2. 登录 Tera Ads。 启动 Gemini CLI,运行 /mcp auth tera-ads,然后登录、选择企业,并选择智能体可以做什么。
  3. 检查工具。 输入 /mcp 查看每个服务器的状态和工具,或在 shell 中运行 gemini extensions list。
  4. 问一个能核实的问题。 试试“本周哪些 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 中设置 Tera Ads,来自各智能体的文档和 Tera Ads 仓库,2026 年 10 月 31 日核对。
CodexGemini CLI
添加服务器codex mcp add tera-ads --url https://teraads.co/mcpgemini 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。

适合终端智能体的提示词

编程智能体能做到聊天窗口做不到的事:把答案放到你工作的地方。让它把结果保存到文件里,与上周的文件对比,或者打开某个广告活动引流到的商品页。

适用于 Codex 或 Gemini CLI 的提示词,以及每条提示词用到的 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 Connect 的限制一览:29 个工具、7 天撤销、3 倍预算上限和每周 30 次免费调用
Tera Ads Connect 的限制一览:29 个工具、7 天撤销、3 倍预算上限和每周 30 次免费调用

管住智能体的改动

编程智能体通常被设置为编辑文件时不用每次询问。别让这个习惯蔓延到广告工具上,因为一次错误的调用就会花掉真金白银。无论智能体被允许做什么,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 里做的一次查询,一个问题可能需要几次。

看看你的广告真正赚了多少。

连接你的店铺和广告账户。一个业务免费,无需绑卡。

创建免费账户