跳到內容
廣告 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 是位於 https://teraads.co/mcp 的代管 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 桌面版 App 共用這個檔案。
  • Gemini CLI 把 Tera Ads 安裝為擴充功能,同時載入一份告訴 Gemini 何時該使用它的情境檔案。
  • 你的代理程式會取得 29 個工具,從即時的 Meta 讀取,到你商店退貨後的利潤,以及有上限的預算變更。
  • 在兩個地方限制變更:代理程式本身的工具設定,以及 Tera Ads 的連線模式。

為什麼要把程式碼代理程式連接到廣告

許多 Shopify 創辦人自己做佈景主題、腳本與內部工具,一天有一半時間待在終端機裡。一個連接了廣告的程式碼代理程式,可以在你編輯商品頁面的同一個工作階段中,回答「Meta 昨天花了多少?」,把每週摘要存成你儲存庫裡的 Markdown 檔案,或是把一週的廣告成效,對照你週二上線的一項改動。

代理程式與廣告帳戶之間的橋梁是 MCP(Model Context Protocol):一項開放標準,讓 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 廣告活動與昨天的花費」,並把答案和廣告管理員比對。
程式碼代理程式如何連接到 Tera Ads:新增伺服器、登入、選擇事業與模式,然後提問
程式碼代理程式如何連接到 Tera Ads:新增伺服器、登入、選擇事業與模式,然後提問

Codex 把 MCP 伺服器存放在 ~/.codex/config.toml,每個伺服器一個 [mcp_servers.tera-ads] 表格,位址放在 url。OpenAI 的文件說,ChatGPT 桌面版 App、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 廣告活動花費最多?」,並把答案和廣告管理員比對。

這個擴充功能是 Tera Ads GitHub 儲存庫裡一個小小的 gemini-extension.json 檔案。它透過 httpUrl 欄位把 Gemini 指向 https://teraads.co/mcp,Gemini 的文件把這個欄位定義為 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 並排比較

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 桌面版 App載入 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 Connect 的限制一覽:29 個工具、7 天復原、三倍預算上限與每週 30 次免費呼叫
Tera Ads Connect 的限制一覽:29 個工具、7 天復原、三倍預算上限與每週 30 次免費呼叫

讓代理程式的變更維持在掌控之中

程式碼代理程式通常被設定為編輯檔案時不用每次詢問。別讓這個習慣蔓延到廣告工具上,在那裡一次錯誤的呼叫就會花掉真金白銀。無論代理程式被允許做什麼,Tera Ads 都有自己的限制:

  • 唯讀、先詢問或直接變更。 在先詢問模式下,變更會在 Tera Ads 中等待,直到你在那裡核准,代理程式無法替你核准。
  • 新項目以暫停狀態開始。 廣告活動、廣告組合、廣告與複本,在有東西把它們開啟之前都不會花任何錢。
  • 預算幅度有上限。 一次變更最多只能調高到三倍,或調低到十分之一。
  • 每日上限。 助理對同一個事業每天最多只能進行 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 銷售與退貨後的利潤,以及有限制且有記錄的廣告變更。免費方案包含一個 Meta 廣告帳戶每週 30 次呼叫,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 桌面版 App、Codex CLI 與 IDE 擴充功能共用同一份 MCP 設定,所以在 CLI 中新增的伺服器,在另外兩者中也會出現。

Gemini CLI 還能用嗎?

Gemini CLI 的文件說,對於免費方案與 Google One 使用者,它已於 2026 年 6 月 18 日被 Antigravity CLI 取代。設定之前,請先查看 Google 針對你帳戶類型的文件。

費用是多少?

免費方案包含一個 Meta 廣告帳戶每週 30 次呼叫。Connect Pro 每月 $15,每月 3,000 次呼叫。一次呼叫是代理程式在 Tera Ads 中進行的一次查詢,而一個問題可能需要幾次。

看看你的廣告真正賺多少。

連接你的商店與廣告帳號。單一商家免費,不需信用卡。

建立免費帳號