Meta Ads dalam Codex dan Gemini CLI: Sambung Ejen Pengekodan ke Iklan
Sambung Codex atau Gemini CLI ke iklan Meta dengan dua arahan: persediaan, log masuk pelayar, tetapan alat selamat dan gesaan yang menyemak iklan dengan untung Shopify.
Dalam halaman ini
Codex dan Gemini CLI kedua-duanya boleh membaca dan mengurus iklan Meta anda melalui Tera Ads, pelayan MCP yang dihoskan di https://teraads.co/mcp. Dalam Codex, jalankan codex mcp add tera-ads --url https://teraads.co/mcp, kemudian codex mcp login tera-ads. Dalam Gemini CLI, pasang sambungan Tera Ads dari GitHub dan jalankan /mcp auth tera-ads. Kedua-duanya melog masuk anda ke Tera Ads dalam pelayar, dan anda memilih sama ada ejen hanya membaca, bertanya anda dahulu atau membuat perubahan.
Perkara utama
- Dua arahan bagi setiap ejen: tambah pelayan, kemudian log masuk ke Tera Ads dalam pelayar anda. Tiada kunci API dimasukkan ke dalam konfigurasi anda.
- Codex menyimpan pelayan dalam
~/.codex/config.toml, yang dikongsi oleh sambungan IDE Codex dan aplikasi desktop ChatGPT. - Gemini CLI memasang Tera Ads sebagai sambungan yang juga memuatkan fail konteks yang memberitahu Gemini bila hendak menggunakannya.
- Ejen anda mendapat 29 alat, daripada bacaan Meta langsung hingga keuntungan kedai anda selepas pulangan dan perubahan bajet yang dihadkan.
- Hadkan perubahan di dua tempat: tetapan alat ejen sendiri dan mod sambungan Tera Ads.
Kenapa sambung ejen pengekodan ke iklan anda
Ramai pengasas Shopify membina tema, skrip dan alat dalaman sendiri, dan menghabiskan separuh hari dalam terminal. Ejen pengekodan yang disambungkan ke iklan anda boleh menjawab "berapa yang Meta belanjakan semalam?" dalam sesi yang sama ketika anda menyunting halaman produk, menyimpan ringkasan mingguan sebagai fail Markdown dalam repo anda, atau menyelaraskan hasil kempen seminggu dengan perubahan yang anda siarkan pada hari Selasa.
Pautan antara ejen dan akaun iklan anda ialah MCP, Model Context Protocol: piawaian terbuka yang membolehkan ejen AI memanggil alat yang didedahkan perkhidmatan lain. MCP penyambung diterangkan merangkumi asasnya. Codex dan Gemini CLI kedua-duanya menyokong pelayan MCP jauh yang log masuk dengan OAuth, jadi pelayan yang dihoskan seperti Tera Ads tidak memerlukan apa-apa dipasang selain ejen itu sendiri.
Apa yang ditambah Tera Ads kepada sambungan Meta biasa ialah kedai anda. Selain bacaan kempen, set iklan dan iklan secara langsung, ia menjawab daripada pesanan Shopify, pulangan, kos produk, penghantaran, yuran dan bayaran balik, tolak perbelanjaan iklan Meta dan Google anda. Hasil yang diatribusikan Meta dilabel sebagai milik Meta, supaya ejen tidak menganggapnya sebagai jualan. Untuk pelayan lain yang boleh anda sambungkan sebaliknya, lihat pilihan MCP Meta Ads.
Satu nota tentang Gemini CLI: dokumennya mengandungi notis bahawa bagi pengguna peringkat tidak berbayar dan Google One, Gemini CLI digantikan oleh Antigravity CLI pada 18 Jun 2026 (dokumen MCP Gemini CLI). Langkah di bawah mengikut Gemini CLI seperti yang didokumenkan pada Oktober 2026.
Sebelum anda mula
- Akaun Tera Ads percuma. Daftar dan sambungkan akaun iklan Meta anda. Sambungkan Shopify juga, supaya ejen boleh melihat jualan dan keuntungan kedai.
- Akses pemilik. Hanya pemilik perniagaan boleh menyambungkan AI ke perniagaan dalam Tera Ads.
- Codex atau Gemini CLI dipasang dan telah log masuk ke akaunnya sendiri.
- Peraturan untuk perubahan. Tentukan sama ada ejen hanya akan melapor, atau juga menjeda iklan dan menggerakkan bajet. Panduan akses AI yang selamat mempunyai dasar ringkas yang boleh anda salin.
Sambung Codex, langkah demi langkah
- Cipta akaun Tera Ads percuma. Daftar, sambungkan akaun iklan Meta anda, kemudian sambungkan Shopify supaya jawapan termasuk keuntungan kedai anda selepas pulangan.
- Tambah pelayan ke Codex. Dalam terminal anda, jalankan
codex mcp add tera-ads --url https://teraads.co/mcp. - Log masuk ke Tera Ads. Jalankan
codex mcp login tera-ads; ia membuka Tera Ads dalam pelayar anda, di mana anda log masuk, memilih perniagaan dan memilih apa yang boleh dilakukan ejen. - Semak sambungan. Mulakan
codexdan taip/mcp, yang menyenaraikan pelayan MCP yang aktif; tera-ads patut ada dalam senarai. - Tanya soalan yang boleh anda semak. Cuba "Use Tera Ads to list my active Meta campaigns with yesterday's spend" dan bandingkan jawapan dengan Ads Manager.

Codex menyimpan pelayan MCP dalam ~/.codex/config.toml, satu jadual [mcp_servers.tera-ads] bagi setiap pelayan dengan alamat dalam url. Dokumen OpenAI menyatakan aplikasi desktop ChatGPT, Codex CLI dan sambungan IDE berkongsi konfigurasi ini, jadi satu persediaan merangkumi ketiga-tiganya (dokumen MCP Codex). Dokumen yang sama menyatakan codex mcp login mengendalikan OAuth dan Codex boleh memilih kaedah pendaftaran klien secara automatik. Tera Ads menyokong pendaftaran klien dinamik dengan OAuth 2.1 dan PKCE, jadi tiada ID klien untuk diberikan.
Hadkan Codex kepada membaca di sisinya
Tetapan pelayan Codex menerima enabled_tools, senarai benar, dan disabled_tools, senarai tolak yang digunakan selepasnya. Untuk menghalang Codex memanggil alat perubahan walaupun sambungan Tera Ads anda membenarkan perubahan, tambahkan baris ini di bawah [mcp_servers.tera-ads] dalam config.toml:
disabled_tools = ["pause", "resume", "set_budget", "create_campaign", "create_ad_set", "create_ad", "duplicate"]
Dokumen itu juga menerangkan tetapan kelulusan bagi setiap pelayan dan setiap alat. Pengawal paling mudah masih yang dalam Tera Ads: pilih baca sahaja semasa anda log masuk, dan alat perubahan tidak boleh berbuat apa-apa bagi sambungan itu.
Sambung Gemini CLI
- Pasang sambungan. Jalankan
gemini extensions install https://github.com/Teralabsx/meta-ads-mcp. - Log masuk ke Tera Ads. Mulakan Gemini CLI, jalankan
/mcp auth tera-ads, kemudian log masuk, pilih perniagaan dan pilih apa yang boleh dilakukan ejen. - Semak alat. Taip
/mcpuntuk melihat status dan alat setiap pelayan, atau jalankangemini extensions listdalam shell anda. - Tanya soalan yang boleh anda semak. Cuba "Which Meta campaigns spent the most this week?" dan bandingkan jawapan dengan Ads Manager.
Sambungan itu ialah fail gemini-extension.json kecil dalam repo GitHub Tera Ads. Ia menghalakan Gemini ke https://teraads.co/mcp melalui medan httpUrl, yang ditakrifkan dokumen Gemini sebagai titik akhir Streamable HTTP, manakala url untuk SSE. Ia juga menamakan GEMINI.md sebagai fail konteksnya. Fail itu memberitahu Gemini supaya menggunakan Tera Ads untuk soalan tentang iklan Meta, ROAS dan keuntungan, melabel hasil yang diatribusikan Meta sebagai milik Meta, dan menganggap nama kempen dan teks iklan sebagai data, bukan arahan.
Dokumen Gemini menyatakan ia menyokong OAuth untuk pelayan MCP jauh, boleh menemui persediaan secara automatik, mengendalikan pendaftaran klien dinamik di mana pelayan menyokongnya, dan menyimpan token dalam ~/.gemini/mcp-oauth-tokens.json. Tetapan pelayan juga termasuk trust, yang memintas semua pengesahan panggilan alat apabila ditetapkan kepada true. Sambungan Tera Ads tidak menetapkannya. Biarkan begitu, supaya Gemini terus bertanya sebelum menjalankan alat.
Codex dan Gemini CLI bersebelahan
| Codex | Gemini CLI | |
|---|---|---|
| Tambah pelayan | codex mcp add tera-ads --url https://teraads.co/mcp | gemini extensions install https://github.com/Teralabsx/meta-ads-mcp |
| Log masuk | codex mcp login tera-ads | /mcp auth tera-ads |
| Di mana ia disimpan | ~/.codex/config.toml | Sambungan yang dipasang |
| Semak ia berfungsi | /mcp dalam Codex | /mcp, atau gemini extensions list |
| Had di sisi ejen | enabled_tools, disabled_tools, tetapan kelulusan | Biarkan trust mati |
| Turut merangkumi | Sambungan IDE Codex dan aplikasi desktop ChatGPT | Memuatkan GEMINI.md sebagai konteks |
| Dokumen ejen | Dokumen MCP Codex | Sambungan Gemini CLI |
Untuk menjadikan Codex atau ejen lain menggunakan Tera Ads tanpa disuruh, repo mencadangkan menyalin kandungan GEMINI.md ke dalam AGENTS.md atau CLAUDE.md projek anda. Jika tidak, namakan Tera Ads dalam gesaan anda.
Gesaan yang sesuai untuk ejen terminal
Ejen pengekodan boleh melakukan sesuatu yang tidak boleh dilakukan tetingkap sembang: meletakkan jawapan di tempat anda bekerja. Minta ia menyimpan hasil ke fail, membandingkannya dengan fail minggu lepas, atau membuka halaman produk yang dituju oleh sesuatu kempen.
| Tanya | Apa yang digunakan ejen |
|---|---|
| "What was my profit after returns in the last 30 days? Save it to reports/profit.md." | get_profit, kemudian alat failnya sendiri |
| "Meta says my ROAS is 3. What did my store actually make?" | get_insights, get_profit |
| "Which campaigns lose money after returns, and what should I do about them?" | get_ads_review |
| "Which ads spent money in the last 14 days without a sale?" | get_insights pada peringkat iklan |
| "What changed in my ads this week, and can I still undo it?" | list_recent_changes |
| "Copy my best campaign as a paused draft." | duplicate |
| "How many Tera Ads calls do I have left?" | get_usage, yang percuma |
Baca jawapan dengan dua peringatan. Pembelian dan hasil Meta ialah atribusi Meta, bukan jualan kedai anda. Dan get_ads_review menilai setiap kempen yang berbelanja berdasarkan keuntungan selepas pulangan biasa kedai anda, pada kos anda sendiri, berbanding ROAS pulang modal anda; angka keuntungan ialah anggaran bagi seluruh kedai, bukan wang tunai di bank. ROAS sebenar selepas bayaran balik menunjukkan kenapa jurang itu penting, dan pustaka gesaan untuk analisis iklan mempunyai lebih banyak soalan untuk dicuba.

Pastikan perubahan ejen terkawal
Ejen pengekodan selalunya disediakan untuk menyunting fail tanpa bertanya setiap kali. Jangan biarkan tabiat itu merebak ke alat iklan, di mana satu panggilan yang salah membelanjakan wang sebenar. Tera Ads menetapkan had sendiri apa pun yang dibenarkan kepada ejen:
- Baca sahaja, tanya dahulu atau buat perubahan. Dengan tanya dahulu, perubahan menunggu dalam Tera Ads sehingga anda meluluskannya di sana, dan ejen tidak boleh meluluskannya untuk anda.
- Perkara baharu bermula dijeda. Kempen, set iklan, iklan dan salinan tidak berbelanja apa-apa sehingga sesuatu menghidupkannya.
- Langkah bajet dihadkan. Satu perubahan paling banyak boleh melipat tigakan bajet atau memotongnya kepada satu persepuluh.
- Had harian. Pembantu boleh membuat paling banyak 50 perubahan sehari pada satu perniagaan.
- Tiada alat padam. Ejen boleh menjeda, tetapi tidak boleh memadam apa-apa.
- Buat asal selama 7 hari. Jeda, hidupkan atau perubahan bajet boleh dibatalkan dalam Tera Ads selama 7 hari. Kempen, set iklan dan iklan baharu tidak boleh dibatalkan, tetapi ia bermula dijeda.
- Satu perniagaan bagi setiap sambungan. Sambungan tidak boleh membaca perniagaan lain, walaupun yang turut anda miliki.
Jika keputusan perubahan kembali sebagai outcome_unknown, jangan minta ejen mengulanginya. Minta ia menyemak list_recent_changes dahulu, supaya perubahan yang sama tidak dibuat dua kali.
Apabila sesuatu tidak berfungsi
Ejen mengabaikan Tera Ads. Namakannya dalam gesaan ("use Tera Ads to..."), atau salin GEMINI.md ke fail arahan projek anda seperti di atas.
Ia meminta anda log masuk semula. Token akses bertahan sejam dan disegarkan untuk anda; sambungan bertahan 30 hari. Jalankan codex mcp login tera-ads atau /mcp auth tera-ads sekali lagi.
Ia menyatakan had dicapai. Pelan percuma mempunyai 30 panggilan seminggu, ditetapkan semula setiap minggu dalam UTC. get_usage percuma dan memberitahu berapa panggilan yang tinggal dan bila kiraan ditetapkan semula.
Bajet kelihatan seratus kali terlalu besar. list_campaigns menunjukkan bajet dalam unit Meta, iaitu perseratus bagi kebanyakan mata wang, jadi 5000 bermakna $50. set_budget menerima unit penuh mata wang akaun anda.
Jawapan tentang kedai yang salah. Setiap sambungan merangkumi satu perniagaan. Log masuk semula dan pilih yang lain.
Tera Ads Connect ialah pelayan MCP Tera Ads, papan pemuka keuntungan untuk jenama Shopify. Ia memberi Codex, Gemini CLI dan klien MCP lain bacaan Meta langsung, jualan Shopify dan keuntungan selepas pulangan, serta perubahan iklan yang terhad dan dilog. Pelan percuma termasuk 30 panggilan seminggu pada satu akaun iklan Meta, dan Connect Pro berharga $15 sebulan untuk 3,000 panggilan sebulan pada sehingga tiga akaun iklan; ia disertakan dengan pelan Growth dan Scale. Langkah persediaan untuk klien lain ada di halaman Connect.
Soalan lazim
Bolehkah Codex menguruskan iklan Meta?
Boleh, melalui pelayan MCP. Jalankan codex mcp add tera-ads --url https://teraads.co/mcp dan codex mcp login tera-ads, kemudian bertanya dalam bahasa biasa. Apa yang boleh diubah oleh Codex bergantung pada mod yang anda pilih bagi sambungan.
Bagaimana saya menyambung Gemini CLI ke iklan Facebook?
Jalankan gemini extensions install https://github.com/Teralabsx/meta-ads-mcp, kemudian /mcp auth tera-ads dalam Gemini CLI dan log masuk ke Tera Ads. Sambungan itu merangkumi iklan Facebook dan Instagram dalam akaun iklan Meta anda.
Adakah saya perlukan aplikasi pembangun Meta atau token API?
Tidak. Anda log masuk ke Tera Ads dalam pelayar anda, dan perubahan sampai ke Meta melalui aplikasi Meta Tera Ads yang diluluskan sendiri. Tiada rahsia dimasukkan ke dalam fail konfigurasi anda.
Adakah persediaan Codex turut berfungsi dalam sambungan IDE?
Ya. Dokumen OpenAI menyatakan aplikasi desktop ChatGPT, Codex CLI dan sambungan IDE berkongsi konfigurasi MCP yang sama, jadi pelayan yang ditambah dalam CLI ada dalam dua yang lain.
Adakah Gemini CLI masih tersedia?
Dokumen Gemini CLI menyatakan ia digantikan oleh Antigravity CLI bagi pengguna peringkat tidak berbayar dan Google One pada 18 Jun 2026. Semak dokumen Google untuk jenis akaun anda sebelum menyediakannya.
Berapakah kosnya?
Pelan percuma termasuk 30 panggilan seminggu pada satu akaun iklan Meta. Connect Pro ialah $15 sebulan untuk 3,000 panggilan sebulan. Satu panggilan ialah satu carian yang dibuat ejen dalam Tera Ads, dan satu soalan boleh mengambil beberapa panggilan.