Meta Ads di Codex dan Gemini CLI: Hubungkan Agen Coding ke Iklan

Codex dan Gemini CLI sama-sama bisa membaca dan mengelola iklan Meta kamu lewat Tera Ads, server MCP yang di-host di https://teraads.co/mcp. Di Codex, jalankan codex mcp add tera-ads --url https://teraads.co/mcp, lalu codex mcp login tera-ads. Di Gemini CLI, instal ekstensi Tera Ads dari GitHub dan jalankan /mcp auth tera-ads. Keduanya membuat kamu login ke Tera Ads di browser, dan kamu yang memilih apakah agen hanya membaca, bertanya dulu, atau membuat perubahan.

Kenapa menghubungkan agen coding ke iklan kamu

Banyak founder Shopify membangun sendiri tema, script, dan tool internal mereka, dan menghabiskan setengah hari di terminal. Agen coding yang terhubung ke iklan kamu bisa menjawab "berapa biaya Meta kemarin?" di sesi yang sama saat kamu mengedit halaman produk, menyimpan ringkasan mingguan sebagai file Markdown di repo kamu, atau menjajarkan hasil kampanye selama seminggu dengan perubahan yang kamu rilis hari Selasa.

Penghubung antara agen dan akun iklan kamu adalah MCP, singkatan dari Model Context Protocol: standar terbuka yang memungkinkan agen AI memanggil tool yang disediakan layanan lain. Penjelasan konektor MCP (bahasa Inggris) membahas dasarnya. Codex dan Gemini CLI sama-sama mendukung server MCP jarak jauh yang login dengan OAuth, jadi server yang di-host seperti Tera Ads tidak butuh instalasi apa pun selain agennya sendiri.

Yang ditambahkan Tera Ads ke koneksi Meta biasa adalah toko kamu. Selain membaca kampanye, ad set, dan iklan secara live, server ini menjawab dari pesanan Shopify, retur, biaya produk, ongkos kirim, fee, dan refund, dikurangi biaya iklan Meta dan Google kamu. Pendapatan yang diatribusikan Meta diberi label sebagai milik Meta, supaya agen tidak menganggapnya penjualan. Untuk server lain yang bisa kamu hubungkan sebagai gantinya, lihat pilihan MCP Meta Ads.

Satu catatan soal Gemini CLI: dokumentasinya memuat pemberitahuan bahwa untuk pengguna tingkat gratis (unpaid tier) dan Google One, Gemini CLI digantikan oleh Antigravity CLI pada 18 Juni 2026 (dokumentasi MCP Gemini CLI). Langkah-langkah di bawah mengikuti Gemini CLI seperti yang didokumentasikan pada Oktober 2026.

Sebelum mulai

• Akun Tera Ads gratis. Daftar dan hubungkan akun iklan Meta kamu. Hubungkan Shopify juga, supaya agen bisa melihat penjualan dan profit toko.
• Akses pemilik. Hanya pemilik bisnis yang bisa menghubungkan AI ke sebuah bisnis di Tera Ads.
• Codex atau Gemini CLI sudah terinstal dan sudah login ke akunnya sendiri.
• Aturan soal perubahan. Tentukan apakah agen hanya akan melapor, atau juga menjeda iklan dan memindahkan anggaran. Panduan akses AI yang aman (bahasa Inggris) berisi kebijakan singkat yang bisa kamu salin.

Hubungkan Codex, langkah demi langkah

1. Buat akun Tera Ads gratis. Daftar, hubungkan akun iklan Meta kamu, lalu hubungkan Shopify supaya jawabannya mencakup profit toko kamu setelah retur.
2. Tambahkan server ke Codex. Di terminal, jalankan codex mcp add tera-ads --url https://teraads.co/mcp.
3. Login ke Tera Ads. Jalankan codex mcp login tera-ads; perintah ini membuka Tera Ads di browser, tempat kamu login, memilih bisnis, dan menentukan apa yang boleh dilakukan agen.
4. Cek koneksinya. Jalankan codex dan ketik /mcp, yang menampilkan daftar server MCP yang aktif; tera-ads seharusnya ada di daftar itu.
5. Ajukan pertanyaan yang bisa kamu cek. Coba "Pakai Tera Ads untuk menampilkan kampanye Meta saya yang aktif beserta biaya kemarin" dan bandingkan jawabannya dengan Ads Manager.

Codex menyimpan server MCP di ~/.codex/config.toml, satu tabel [mcp_servers.tera-ads] per server dengan alamatnya di url. Dokumentasi OpenAI menyebutkan bahwa aplikasi desktop ChatGPT, Codex CLI, dan ekstensi IDE memakai konfigurasi ini bersama-sama, jadi satu kali setup mencakup ketiganya (dokumentasi MCP Codex). Dokumentasi yang sama menyebutkan bahwa codex mcp login menangani OAuth dan Codex bisa memilih metode pendaftaran klien secara otomatis. Tera Ads mendukung dynamic client registration dengan OAuth 2.1 dan PKCE, jadi tidak ada client ID yang perlu dimasukkan.

Batasi Codex hanya membaca dari sisinya

Pengaturan server di Codex menerima enabled_tools, sebuah allowlist, dan disabled_tools, sebuah denylist yang diterapkan setelahnya. Untuk mencegah Codex memanggil tool perubahan meskipun koneksi Tera Ads kamu mengizinkan perubahan, tambahkan baris ini di bawah [mcp_servers.tera-ads] di config.toml:

disabled_tools = ["pause", "resume", "set_budget", "create_campaign", "create_ad_set", "create_ad", "duplicate"]

Dokumentasinya juga menjelaskan pengaturan persetujuan untuk setiap server dan setiap tool. Meski begitu, pengaman paling sederhana tetap ada di Tera Ads: pilih hanya membaca saat login, maka tool perubahan tidak bisa melakukan apa pun untuk koneksi itu.

Hubungkan Gemini CLI

1. Instal ekstensinya. Jalankan gemini extensions install https://github.com/Teralabsx/meta-ads-mcp.
2. Login ke Tera Ads. Buka Gemini CLI, jalankan /mcp auth tera-ads, lalu login, pilih bisnis, dan tentukan apa yang boleh dilakukan agen.
3. Cek tool-nya. Ketik /mcp untuk melihat status dan tool setiap server, atau jalankan gemini extensions list di shell kamu.
4. Ajukan pertanyaan yang bisa kamu cek. Coba "Kampanye Meta mana yang paling banyak menghabiskan biaya minggu ini?" dan bandingkan jawabannya dengan Ads Manager.

Ekstensinya berupa file kecil gemini-extension.json di repo GitHub Tera Ads. File itu mengarahkan Gemini ke https://teraads.co/mcp lewat field httpUrl, yang menurut dokumentasi Gemini adalah endpoint Streamable HTTP, sedangkan url untuk SSE. File itu juga menyebut GEMINI.md sebagai file konteksnya. File konteks itu memberi tahu Gemini untuk memakai Tera Ads pada pertanyaan soal iklan Meta, ROAS, dan profit, untuk memberi label pendapatan yang diatribusikan Meta sebagai milik Meta, dan untuk memperlakukan nama kampanye dan teks iklan sebagai data, bukan sebagai instruksi.

Dokumentasi Gemini menyebutkan bahwa Gemini mendukung OAuth untuk server MCP jarak jauh, bisa menemukan setup-nya secara otomatis, menangani dynamic client registration jika server mendukungnya, dan menyimpan token di ~/.gemini/mcp-oauth-tokens.json. Pengaturan server juga punya trust, yang melewati semua konfirmasi pemanggilan tool jika diset ke true. Ekstensi Tera Ads tidak mengaturnya. Biarkan begitu, supaya Gemini tetap bertanya sebelum menjalankan tool.

Codex dan Gemini CLI berdampingan

Supaya Codex atau agen lain memakai Tera Ads tanpa disuruh, repo-nya menyarankan menyalin isi GEMINI.md ke AGENTS.md atau CLAUDE.md di proyek kamu. Kalau tidak, sebut Tera Ads di prompt kamu.

Prompt yang cocok untuk agen terminal

Agen coding bisa melakukan sesuatu yang tidak bisa dilakukan jendela chat: menaruh jawabannya di tempat kamu bekerja. Minta agen menyimpan hasil ke file, membandingkannya dengan file minggu lalu, atau membuka halaman produk yang menjadi tujuan sebuah kampanye.

Baca jawabannya dengan dua catatan. Pembelian dan pendapatan Meta adalah atribusi Meta, bukan penjualan toko kamu. Lalu get_ads_review menilai setiap kampanye yang mengeluarkan biaya berdasarkan profit setelah retur yang biasa terjadi di toko kamu, dengan biaya kamu sendiri, terhadap ROAS titik impas kamu; angka profitnya adalah estimasi untuk seluruh toko, bukan uang tunai di rekening. ROAS asli setelah refund menunjukkan kenapa selisih itu penting, dan kumpulan prompt untuk analisis iklan (bahasa Inggris) berisi lebih banyak pertanyaan untuk dicoba.

Tetap kendalikan perubahan yang dibuat agen

Agen coding sering diatur untuk mengedit file tanpa bertanya setiap kali. Jangan biarkan kebiasaan itu menular ke tool iklan, karena satu panggilan yang salah menghabiskan uang sungguhan. Tera Ads menetapkan batasannya sendiri, apa pun yang diizinkan untuk agen:

• Hanya membaca, bertanya dulu, atau membuat perubahan. Dengan bertanya dulu, sebuah perubahan menunggu di Tera Ads sampai kamu menyetujuinya di sana, dan agen tidak bisa menyetujuinya untuk kamu.
• Yang baru dimulai dalam keadaan dijeda. Kampanye, ad set, iklan, dan salinan tidak menghabiskan biaya sampai ada yang menyalakannya.
• Langkah anggaran dibatasi. Satu perubahan paling banyak bisa melipattigakan anggaran atau memangkasnya menjadi sepersepuluh.
• Batas harian. Asisten paling banyak bisa membuat 50 perubahan per hari di satu bisnis.
• Tidak ada tool hapus. Agen bisa menjeda, tetapi tidak bisa menghapus apa pun.
• Undo selama 7 hari. Jeda, penyalaan kembali, atau perubahan anggaran bisa dibatalkan di Tera Ads selama 7 hari. Kampanye, ad set, dan iklan baru tidak bisa dibatalkan, tetapi semuanya dimulai dalam keadaan dijeda.
• Satu bisnis per koneksi. Sebuah koneksi tidak bisa membaca bisnis lain, meskipun bisnis itu juga milik kamu.

Kalau hasil sebuah perubahan kembali sebagai outcome_unknown, jangan minta agen mengulanginya. Minta agen mengecek list_recent_changes lebih dulu, supaya perubahan yang sama tidak dibuat dua kali.

Kalau ada yang tidak jalan

Agen mengabaikan Tera Ads. Sebut namanya di prompt ("pakai Tera Ads untuk..."), atau salin GEMINI.md ke file instruksi proyek kamu seperti dijelaskan di atas.

Agen meminta kamu login lagi. Access token berlaku satu jam dan diperbarui otomatis; sebuah koneksi berlaku 30 hari. Jalankan lagi codex mcp login tera-ads atau /mcp auth tera-ads.

Agen bilang batasnya sudah tercapai. Paket gratis memberi 30 panggilan per minggu, di-reset setiap minggu menurut UTC. get_usage gratis dan menunjukkan sisa panggilan serta kapan hitungannya di-reset.

Anggaran terlihat seratus kali terlalu besar. list_campaigns menampilkan anggaran dalam satuan Meta, yaitu seperseratus untuk sebagian besar mata uang, jadi 5000 berarti $50. set_budget menerima satuan utuh dalam mata uang akun kamu.

Jawabannya tentang toko yang salah. Setiap koneksi mencakup satu bisnis. Login lagi dan pilih bisnis yang lain.

Tera Ads Connect adalah server MCP dari Tera Ads, dashboard profit untuk brand Shopify. Server ini memberi Codex, Gemini CLI, dan klien MCP lain akses baca Meta secara live, penjualan Shopify, dan profit setelah retur, serta perubahan iklan yang dibatasi dan dicatat. Paket gratis mencakup 30 panggilan per minggu untuk satu akun iklan Meta, dan Connect Pro seharga $15 per bulan untuk 3,000 panggilan per bulan di maksimal tiga akun iklan; Connect Pro sudah termasuk di paket Growth dan Scale. Langkah setup untuk klien lain ada di halaman Connect. Kalau kamu bekerja di editor kode, panduan MCP Meta Ads di Cursor, VS Code, dan Claude Code membahas ketiganya.

Pertanyaan umum

Bisakah Codex mengelola iklan Meta?

Bisa, lewat server MCP. Jalankan codex mcp add tera-ads --url https://teraads.co/mcp dan codex mcp login tera-ads, lalu bertanyalah dengan bahasa sehari-hari. Apa yang boleh diubah Codex tergantung mode yang kamu pilih untuk koneksi itu.

Bagaimana cara menghubungkan Gemini CLI ke Facebook Ads?

Jalankan gemini extensions install https://github.com/Teralabsx/meta-ads-mcp, lalu /mcp auth tera-ads di dalam Gemini CLI dan login ke Tera Ads. Ekstensi ini mencakup iklan Facebook dan Instagram di akun iklan Meta kamu.

Apakah kamu butuh aplikasi developer Meta atau API token?

Tidak. Kamu login ke Tera Ads di browser, dan perubahan sampai ke Meta lewat aplikasi Meta milik Tera Ads sendiri yang sudah disetujui. Tidak ada rahasia yang masuk ke file konfigurasi kamu.

Apakah setup Codex juga berlaku di ekstensi IDE?

Ya. Dokumentasi OpenAI menyebutkan bahwa aplikasi desktop ChatGPT, Codex CLI, dan ekstensi IDE memakai konfigurasi MCP yang sama, jadi server yang ditambahkan di CLI juga ada di dua lainnya.

Apakah Gemini CLI masih tersedia?

Dokumentasi Gemini CLI menyebutkan bahwa untuk pengguna tingkat gratis dan Google One, Gemini CLI digantikan oleh Antigravity CLI pada 18 Juni 2026. Cek dokumentasi Google untuk jenis akun kamu sebelum memasangnya.

Berapa biayanya?

Paket gratis mencakup 30 panggilan per minggu untuk satu akun iklan Meta. Connect Pro seharga $15 per bulan untuk 3,000 panggilan per bulan. Satu panggilan adalah satu pencarian yang dilakukan agen di Tera Ads, dan satu pertanyaan bisa memakai beberapa panggilan.