Generate Gambar di Gemini CLI: Panduan MCP Server

Gemini CLI adalah terminal agent open-source dari Google, dan MCP merupakan protokol yang digunakannya untuk mengakses tools eksternal. Arahkan ke remote MCP server, dan sesi obrolan yang sama untuk mengedit kode juga dapat menghasilkan gambar, video, dan suara, menyimpan file langsung ke direktori kerja Anda.

Jawaban cepat: jalankan gemini mcp add --transport http --scope user bananabanana https://bananabanana.pro/api/mcp -H "Authorization: Bearer $BB_KEY", setujui kepercayaan folder saat diminta oleh CLI, lalu periksa gemini mcp list untuk melihat status hijau Connected. Gambar dikenakan biaya mulai $0.03 per generasi yang dipotong langsung dari saldo Anda.

Jendela terminal di atas meja dengan gambar berbingkai kecil yang muncul darinya, ilustrasi editorial

Semua langkah di bawah ini diuji menggunakan Gemini CLI 0.55.1 pada 17 Agustus 2026 dengan kunci aktif bb_live_…. Jika ada perbedaan antara dokumentasi resmi dan perilaku aktual CLI, kami menjelaskannya secara terbuka.

Setup langsung

Hanya dua perintah. Perintah pertama mendaftarkan server:

export BB_KEY=bb_live_…   # create one at https://bananabanana.pro/profile
 
gemini mcp add --transport http --scope user \
  bananabanana https://bananabanana.pro/api/mcp \
  -H "Authorization: Bearer $BB_KEY"

Perintah kedua memeriksa koneksi:

gemini mcp list
# ✓ bananabanana: https://bananabanana.pro/api/mcp (http) - Connected

Jika Anda melihat Disabled alih-alih Connected, baca bagian berikutnya sebelum mengubah pengaturan lain. Detail kecil ini sempat menyita waktu saya sekitar lima menit.

Lima detail yang tidak disebutkan dalam dokumentasi

Kepercayaan folder menonaktifkan semuanya secara diam-diam. Jalankan gemini mcp list di direktori yang tidak dipercaya CLI, dan Anda akan melihat:

Warning: MCP servers are configured but disabled because this folder is untrusted.
User-level servers are also suppressed in untrusted folders to prevent accidental side-effects.

○ bananabanana: https://bananabanana.pro/api/mcp (http) - Disabled

Perhatikan baris kedua: bahkan server dengan --scope user tetap dinonaktifkan. CLI meminta konfirmasi kepercayaan pada peluncuran interaktif pertama; jika Anda mengotomatiskan dengan skrip, status kepercayaan tersimpan di ~/.gemini/trustedFolders.json sebagai pemetaan path ke TRUST_FOLDER. Ini adalah langkah keamanan yang logis tetapi membingungkan, karena status "Disabled" tidak secara jelas menyebutkan masalah folder.

gemini mcp add menulis url, bukan httpUrl. Dokumentasi mencantumkan httpUrl untuk Streamable HTTP. Namun konfigurasi yang sebenarnya dibuat oleh CLI 0.55.1 adalah:

{
  "mcpServers": {
    "bananabanana": {
      "url": "https://bananabanana.pro/api/mcp",
      "type": "http",
      "headers": { "Authorization": "Bearer $BB_KEY" }
    }
  }
}

Kedua format dapat terhubung. Tetapi jika Anda membandingkan konfigurasi dari dokumen resmi dengan hasil yang dibuat CLI, Anda mungkin mengira salah satunya keliru. Keduanya berfungsi.

Scope default adalah project, dan di sanalah kunci Anda disimpan. Jika tidak menyertakan --scope user, kunci akan masuk ke .gemini/settings.json di dalam repositori Anda. Cukup satu git add ., kunci akan masuk ke riwayat commit. Selalu gunakan --scope user atau gunakan referensi variabel lingkungan seperti contoh di atas.

Interpolasi $BB_KEY bekerja, tetapi gagal secara diam-diam. Ketika variabel diekspor, statusnya Connected. Buka terminal baru tanpa mengekspornya, dan konfigurasi yang sama akan melaporkan Disconnected tanpa pesan kesalahan autentikasi yang jelas. Tambahkan baris export tersebut ke profil shell Anda.

Gemini CLI memeriksa SSE dan menerima respons 405. Melihat log server saat koneksi terjalin, urutannya adalah: POST initialize (200), POST notification (202), GET /api/mcp (405), POST tools/list (200). Permintaan GET adalah upaya CLI untuk membuka saluran Server-Sent Events pada server stateless. Responsnya 405, CLI melanjutkan prosesnya, dan semuanya bekerja normal. Jika Anda menjalankan server MCP sendiri, abaikan respons 405 tersebut.

Dinding penuh pintu kecil terkunci dengan satu pintu terbuka dan bercahaya, ilustrasi editorial

Alat yang Anda dapatkan dan biayanya

Sesi menyediakan sembilan tools, sama seperti yang tercantum pada referensi alat. Empat di antaranya gratis untuk dipanggil: list_models, get_account, get_result, list_generations. Sisanya ditagih per generasi dari saldo akun Anda.

Jenis	Model	Harga
Gambar, 1K	Nano Banana 2 Lite	$0.03
Gambar, 512 → 4K	Nano Banana 2	$0.03 – $0.13
Gambar, 1K → 4K	Nano Banana Pro	$0.11 – $0.20
Video, 3–10 dtk dengan audio	Gemini Omni Flash	$0.10 per detik
Video, 4–8 dtk	Seri Veo 3.1	hingga $4.40 per klip
Suara	Gemini Flash TTS	$0.01 per 200 karakter

Panggilan video dan batch gambar selalu memberikan estimasi harga terlebih dahulu. Agent menerima harga pasti, saldo belum dipotong, dan pembuatan hanya dimulai setelah harga tersebut dikonfirmasi. Penolakan filter keamanan dan kegagalan upstream akan dikembalikan otomatis ke saldo, hal penting saat memproses banyak prompt di latar belakang.

Pengisian saldo memberikan bonus: 5% mulai $50, 10% mulai $100, dan kode promo aktif memberikan tambahan 10% dari deposit. Deposit $100 dengan kode promo menghasilkan saldo $120.

Koin di samping tumpukan gambar kecil berbingkai dan rol film yang disusun seperti tangga, ilustrasi editorial

Mengapa integrasi Gemini dan Nano Banana masuk akal?

Dua jalan menuju gerbang bercahaya yang sama: satu lurus dan pendek, satu lagi berliku melewati pos pemeriksaan, ilustrasi editorial

Mengakses model gambar Gemini dari Gemini CLI lewat server pihak ketiga mungkin tampak seperti jalan memutar. Tentu ada jalur langsung: menyiapkan akun tagihan Google Cloud, mengaktifkan API model, mengelola kredensial, dan mengatur kuota regional. Ini pilihan tepat jika Anda fokus membangun infrastruktur.

Namun pendekatan kami melayani kebutuhan berbeda: satu token akses, saldo prabayar, tanpa akun penagihan cloud, tanpa tiket permohonan kuota, dan tanpa keterikatan wilayah. Anda juga memperoleh akses ke model video Veo dan Omni serta sintesis suara TTS melalui satu koneksi yang sama, dengan penagihan per pembuatan dan bukan per proyek. Jika tujuan Anda adalah membuat karya daripada mengelola platform, cara ini jauh lebih efisien.

Pada skala besar, infrastruktur cloud mandiri tentu lebih ekonomis. Tetapi opsi kami memungkinkan Anda memulai dalam hitungan menit dan menghindari tagihan tak terduga.

Jika Anda menggunakan editor lain, server yang sama dapat dihubungkan ke Claude Code, Cursor, dan Codex menggunakan kunci API yang sama dengan konfigurasi masing-masing.

Contoh kasus praktis: ilustrasi dokumentasi

Kasus penggunaan nyata: sebuah repositori dengan folder docs/, berisi dua belas halaman, masing-masing membutuhkan gambar header dengan gaya visual seragam.

Prompt di sesi terminal:

Read every heading in docs/*.md. For each file, generate a 16:9 illustration matching the page topic, in this style: editorial illustration, pastel paper background, dark ink details, violet and amber accents, no text. Use nano-banana-pro. Save each as docs/img/.png and add the image reference under the page title.

Agent membaca file, memanggil generate_image untuk tiap halaman, menunggu via get_result, mengunduh file, dan menambahkan referensi markdown. Dua belas gambar seharga $0.11 menghasilkan total $1.32, dan seluruh proses selesai saat Anda menyeduh kopi. Semua ilustrasi pada artikel ini dibuat melalui alur yang sama menggunakan Nano Banana Pro dengan deskripsi gaya visual terpadu.

Dua tips penting: buat satu gambar uji coba terlebih dahulu untuk memastikan gaya visual (kesalahan deskripsi pada 12 file membuang $1.32 sia-sia), dan biarkan opsi --trust mati agar setiap pemanggilan alat berbayar memerlukan konfirmasi manual untuk mencegah loop tak disengaja.

Selusin kartu bergambar kecil tersusun rapi di atas meja dalam gaya visual seragam, ilustrasi editorial

Bisakah menggunakan OAuth sebagai pengganti API key?

Gemini CLI mendokumentasikan dukungan OAuth 2.0 untuk remote MCP server dengan discovery dan perintah /mcp auth. Server kami merupakan OAuth 2.1 authorization server lengkap (dynamic client registration, PKCE S256, RFC 9728 discovery), dan klien seperti Claude Code serta claude.ai dapat login tanpa input kunci manual.

Jalur API key telah diuji secara menyeluruh dan terbukti stabil. Alur OAuth di Gemini CLI belum kami uji secara khusus pada sesi ini, jadi anggaplah ini berpeluang bekerja namun belum terkonfirmasi. Membuat API key hanya butuh sepuluh detik dan tidak akan kedaluwarsa sebelum Anda mencabutnya.

Pertanyaan yang Sering Diajukan

Di mana file pengaturan disimpan?

~/.gemini/settings.json untuk user scope, dan .gemini/settings.json untuk project scope. Perintah gemini mcp add --scope user menulis ke file pertama.

Mengapa status server menunjukkan Disabled?

Folder tersebut belum dipercaya oleh CLI. Berikan izin saat peluncuran interaktif atau tambahkan jalurnya ke ~/.gemini/trustedFolders.json dengan nilai TRUST_FOLDER. Server ber-scope user juga dinonaktifkan di folder yang tidak dipercaya.

Bisakah saya membatasi alat yang dapat dilihat model?

Bisa. Gunakan flag --include-tools dan --exclude-tools pada gemini mcp add, atau gunakan opsi includeTools / excludeTools di settings. Pengaturan exclude akan menimpa include.

Apakah ini bekerja dalam proyek tim bersama?

Konfigurasikan server pada level proyek dan simpan kunci dalam variabel lingkungan, jangan pernah ditulis mentah. Setiap developer menjalankan export BB_KEY=… dengan kunci mereka masing-masing, sehingga konfigurasi git tetap bersih.

Apa yang terjadi jika proses generasi gagal?

Saldo Anda akan dikembalikan secara otomatis, termasuk saat ditolak oleh filter moderasi konten. Mencoba ulang prompt yang berada di batas aman sangat disarankan, karena evaluasi keamanan memeriksa piksel akhir dan generasi ulang akan menghasilkan gambar baru.

Lebih menyukai antarmuka grafis? Generator web menjalankan model yang sama dengan saldo yang sama. Pada terminal, mulailah dengan list_models setelah terhubung: gratis, menampilkan harga terbaru, dan memverifikasi koneksi sebelum Anda mengeluarkan biaya.