在 Codex 與 Gemini CLI 中使用 Meta 廣告:把程式碼代理程式連接到廣告
用兩個指令把 Codex 或 Gemini CLI 連接到你的 Meta 廣告:設定方式、瀏覽器登入、安全的工具設定,以及對照 Shopify 利潤檢查廣告的提示詞。
本頁內容
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 的步驟
- 建立免費的 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 廣告活動與昨天的花費」,並把答案和廣告管理員比對。

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
- 安裝擴充功能。 執行
gemini extensions install https://github.com/Teralabsx/meta-ads-mcp。 - 登入 Tera Ads。 啟動 Gemini CLI,執行
/mcp auth tera-ads,然後登入、選擇事業,並選擇代理程式可以做什麼。 - 檢查工具。 輸入
/mcp查看每個伺服器的狀態與工具,或在你的 shell 中執行gemini extensions list。 - 問一個你能核對的問題。 試試「本週哪些 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 並排比較
| 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 桌面版 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 都有自己的限制:
- 唯讀、先詢問或直接變更。 在先詢問模式下,變更會在 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 中進行的一次查詢,而一個問題可能需要幾次。