Gemini CLI ile Görsel Üretimi: MCP Sunucu Kurulumu

Gemini CLI, Google'ın açık kaynaklı terminal ajanıdır ve MCP, kendi dışındaki araçlara erişmek için kullandığı protokoldür. Ajanı uzak bir MCP sunucusuna yönlendirdiğinizde, kodunuzu düzenleyen aynı sohbet oturumu doğrudan çalışma dizininize görsel, video ve ses dosyaları da üretebilir.

Hızlı yanıt: gemini mcp add --transport http --scope user bananabanana https://bananabanana.pro/api/mcp -H "Authorization: Bearer $BB_KEY" komutunu çalıştırın, CLI sorduğunda klasöre güvenmeyi onaylayın, ardından gemini mcp list ile yeşil Connected durumunu kontrol edin. Görseller, bakiyenizden üretim başına $0.03'tan başlayan fiyatlarla ücretlendirilir.

Aşağıda açıklanan her şey, 17 Ağustos 2026 tarihinde Gemini CLI 0.55.1 ve geçerli bir bb_live_… anahtarı ile test edilmiştir. Resmi belgelerle CLI'ın gerçek davranışı arasındaki farklar açıkça belirtilmiştir.

Doğrudan kurulum

Yalnızca iki komut. İlki sunucuyu kaydeder:

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"

İkincisi bağlantıyı kontrol eder:

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

Connected yerine Disabled görüyorsanız, başka bir ayara dokunmadan önce bir sonraki bölümü okuyun. Bu ayrıntıyı çözmek benim yaklaşık beş dakikamı aldı.

Belgelerin bahsetmediği beş ayrıntı

Klasör güveni her şeyi sessizce devre dışı bırakır. CLI'ın güvenmediği bir dizinde gemini mcp list çalıştırdığınızda şu çıktıyı alırsınız:

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

İkinci satıra dikkat edin: --scope user ile eklenen bir sunucu bile devre dışı kalır. CLI, ilk etkileşimli çalıştırmada klasöre güvenip güvenmediğinizi sorar; komut dosyalarıyla otomasyon yapıyorsanız güven kararı ~/.gemini/trustedFolders.json dosyasında yol ile TRUST_FOLDER eşleşmesi olarak tutulur. Mantıklı bir güvenlik tercihi olsa da kafa karıştırıcıdır, çünkü "Disabled" ifadesi doğrudan klasör kaynaklı olduğunu belirtmez.

gemini mcp add, httpUrl yerine url yazar. Belgeler Streamable HTTP için httpUrl parametresini anlatır. Ancak CLI 0.55.1 sürümünün gerçekte oluşturduğu yapılandırma şudur:

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

Her iki biçim de bağlanır. Ancak resmi belgelerdeki örnekle CLI'ın ürettiği dosyayı karşılaştırırsanız birinin hatalı olduğunu düşünebilirsiniz. İkisi de çalışır.

Varsayılan kapsam project'tir ve anahtarınız oraya yazılır. --scope user eklemezseniz anahtar projenizin içindeki .gemini/settings.json dosyasına yazılır. Tek bir git add . sonrasında anahtar commit geçmişinize girer. Daima --scope user kullanın veya başlığı yukarıdaki blokta gösterildiği gibi bir ortam değişkeni referansı olarak tutun.

$BB_KEY yer tutucusu çalışır ancak sessizce başarısız olur. Değişken dışa aktarıldığında durum Connected olur. Değişkeni tanımlamadan yeni bir terminal açarsanız, aynı yapılandırma kimlik doğrulama hatası vermek yerine sessizce Disconnected durumu bildirir. Bu satırı kabuk profilinize eklemek iyi bir fikirdir.

Gemini CLI, SSE yoklaması yapar ve 405 alır. Bağlantı anında sunucu günlükleri incelendiğinde sıra şöyledir: POST initialize (200), POST notification (202), GET /api/mcp (405), POST tools/list (200). GET isteği, CLI'ın durumsuz bir sunucuda Server-Sent Events kanalı açma girişimidir. 405 döner, CLI işlemine devam eder ve her şey sorunsuz çalışır. Kendi MCP sunucunuzu çalıştırıyorsanız bu 405 yanıtına takılmayın.

Neler elde edersiniz ve maliyeti nedir?

Oturumda araç referansında listelenen dokuz araç tanımlanır. Dört araç tamamen ücretsizdir: list_models, get_account, get_result, list_generations. Diğer araçlar hesap bakiyenizden üretim başına ücretlendirilir.

Video ve çoklu görsel çağrıları daima önce fiyat teklifi sunar. Ajan tam tutarı öğrenir, henüz bir çekim yapılmaz ve üretim ancak bu tutar onaylandıktan sonra başlar. İçerik filtresi retleri ve upstream hataları otomatik olarak iade edilir; arka planda toplu üretim yaparken bu çok önemlidir.

Bakiye yüklemeleri bonus kazandırır: $50 üzeri için %5, $100 üzeri için %10 ve aktif bir promosyon kodu yatırılan tutara ilave %10 ekler. Promosyon koduyla $100 yükleme hesabınıza $120 tanımlar.

Gemini'ın Nano Banana üretmesi neden mantıklı?

Gemini CLI'ın bir üçüncü taraf sunucu üzerinden Gemini görsel modeline ulaşması ilk bakışta dolaylı görünebilir. Doğrudan bir yol da vardır: Google Cloud faturalandırma hesabı açmak, model API'lerini yetkilendirmek, kimlik bilgilerini yapılandırmak ve bölgesel kotaları yönetmek. Amacınız bir altyapı inşa etmekse bu harika bir çözümdür.

Bizim yaklaşımımız ise farklı bir ihtiyacı karşılar: tek bir erişim belirteci, ön ödemeli bakiye, bulut faturalandırma hesabı yok, kota talepleri yok, bölge sabitleme zorunluluğu yok. Ayrıca aynı bağlantı üzerinden Veo ve Omni video modellerine ve TTS ses sentezine proje bazlı değil üretim bazlı fiyatlandırmayla ulaşırsınız. Amacınız platform yönetmek değil üretmek ise bu çok daha pratiktir.

Yüksek hacimlerde bulut altyapısı doğrudan daha ucuza gelecektir. Ancak bizim modelimiz iki dakikada başlamanızı sağlar ve arkada unutulan maliyetlerin birikmesini engeller.

Farklı editörler kullanıyorsanız aynı sunucu; Claude Code, Cursor ve Codex ile aynı API anahtarı ve uygun yapılandırma dosyası kullanılarak entegre edilir.

Pratik kullanım: dokümantasyon illüstrasyonları

Gerçek ve verimli bir kullanım örneği: docs/ klasöründe on iki sayfası olan ve her biri için tutarlı bir görsel stilde kapak resmi gereken bir depo.

Oturum içindeki istem:

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.

Ajan dosyaları okur, her sayfa için generate_image çağırır, get_result ile tamamlanmayı bekler, dosyaları indirir ve markdown referanslarını yazar. $0.11 tutarındaki on iki görsel toplam $1.32 tutar ve siz kahvenizi içerken her şey arka planda tamamlanır. Bu makaledeki tüm illüstrasyonlar Nano Banana Pro ve ortak stil açıklamasıyla aynı iş akışından üretilmiştir.

Denemeden önce iki öneri: stili doğrulamak için önce tek bir görsel üretin (on iki dosyaya yayılmış hatalı bir stil $1.32 israf demektir) ve --trust parametresini kapalı tutun; ücretli araç çağrılarında onay istemi ajanın döngüye girmesini engeller.

Anahtar yerine OAuth kullanılabilir mi?

Gemini CLI, uzak MCP sunucuları için otomatik keşif ve /mcp auth komutuyla OAuth 2.0 desteği sunar. Sunucumuz tam teşekküllü bir OAuth 2.1 yetkilendirme sunucusudur (dinamik istemci kaydı, PKCE S256, RFC 9728 keşfi) ve Claude Code ile claude.ai gibi istemciler manuel anahtara gerek kalmadan bu şekilde giriş yapar.

API anahtarı akışı baştan sona test edilmiştir ve sorunsuz çalışır. Gemini CLI üzerindeki OAuth akışını bu oturumda ayrıca doğrulamadığımız için bunu kesin bir garanti olarak değil olasılık olarak değerlendirin. API anahtarı oluşturmak on saniye sürer ve siz iptal edene kadar geçerlidir.

Sık sorulan sorular

Yapılandırma dosyası nerede bulunur?

Kullanıcı kapsamı için ~/.gemini/settings.json, proje kapsamı için .gemini/settings.json. gemini mcp add --scope user komutu ilk dosyaya yazar.

Sunucu neden Disabled görünüyor?

Klasör güvenilenler listesinde değildir. Başlangıçta klasöre güvenmeyi onaylayın veya yolu ~/.gemini/trustedFolders.json dosyasına TRUST_FOLDER değeriyle ekleyin. Kullanıcı kapsamındaki sunucular da güvenilmeyen klasörlerde engellenir.

Modelin gördüğü araçları sınırlandırabilir miyim?

Evet. gemini mcp add üzerinde --include-tools ve --exclude-tools parametrelerini veya ayarlarda includeTools / excludeTools alanlarını kullanabilirsiniz. Hariç tutma kuralı dahil etmeye göre önceliklidir.

Ekibimle paylaştığım bir projede çalışır mı?

Sunucuyu proje kapsamında tanımlayın ve anahtarı doğrudan dosyaya yazmak yerine bir ortam değişkenine bağlayın. Her geliştirici kendi anahtarıyla export BB_KEY=… komutunu çalıştırır ve git geçmişi temiz kalır.

Üretim başarısız olursa ne olur?

İçerik filtresi engellemeleri dahil olmak üzere bakiye otomatik olarak iade edilir. Sınırda bir istem kullandıysanız tekrar denemek mantıklıdır: güvenlik denetimi tamamlanan pikselleri değerlendirir ve ikinci deneme farklı bir görsel çizer.

Terminal yerine arayüz mü tercih ediyorsunuz? Web oluşturucu aynı bakiyeyle aynı modelleri çalıştırır. Terminalde ise bağlandıktan sonra list_models ile başlayın: ücretsizdir, güncel fiyatları listeler ve ücret harcamadan tüm akışın çalıştığını doğrular.