Cline MCP Sunucusu: Editörünüzden Görsel Üretin

Cline içindeki uzak bir MCP sunucusu, ajanın HTTP üzerinden çağırdığı barındırılan araçlar bütünüdür: MCP ayarları JSON dosyasına tek bir blok eklersiniz ve Cline hiçbir dil modelinin tek başına yapamayacağı şeyleri yapabilir hale gelir. Görsel dosyası üretmek bunun en net örneğidir. Cline bileşenlerinizi yeniden yapılandırır, testleri çalıştırır, veritabanı geçişini yazar ve ardından «buraya ürün fotoğrafı gelecek» noktasında durup kalır.

Sabırsız olanlar için tüm kurulum. BananaBanana profilinizde bir anahtar oluşturun, Cline'ın MCP ayarlarını açın ve şunu ekleyin:

{
  "mcpServers": {
    "bananabanana": {
      "type": "streamableHttp",
      "url": "https://bananabanana.pro/api/mcp",
      "headers": {
        "Authorization": "Bearer bb_live_YOUR_KEY"
      },
      "disabled": false,
      "autoApprove": ["list_models", "get_account", "get_result"]
    }
  }
}

On adet araç panelinizde belirir. Görseller ön ödemeli bakiyenizden görsel başına $0.03'tan, videolar $0.10'dan ücretlendirilir. type satırı isteğe bağlı değildir ve bunun nedeni birazdan değineceğim oldukça can sıkıcı bir hata durumudur.

Cline'a neden bir görsel üretici eklemelisiniz?

Cline'ın temel çalışma mantığı «sonucu tarif et, adımları ajana bırak» şeklindedir. Bu süreç, sonuç bir görsel içermediği sürece kusursuz işler. Ancak görsel gerektiği anda döngü kırılır ve manuel iş başlar: tarayıcı sekmesi aç, istemi yaz, indir, yeniden adlandır, public/ klasörüne taşı, editöre dön ve nerede kaldığını hatırla. Varlık başına beş dakika kayıp ve odak dağılmasının maliyeti bu beş dakikadan çok daha fazladır.

Bir MCP aracıyla tüm döngüyü ajan yönetir. İstemi yazar, generate_image fonksiyonunu çağırır, üretilen dosyayı belirttiğiniz klasöre indirir ve ilgili kodu günceller. Size yalnızca diff'i incelemek kalır.

Fiyatlandırma modeli de Cline kullanıcılarının alışkanlıklarına uygundur. Cline «kendi modelini getir» esasına dayandığından, kullanıcıları aylık abonelikler yerine birim başına ödeme yapmaya alışıktır. Üretim fiyatları da aynı şekilde işler. Plan yok, kullanıcı başı lisans yok, aylık minimum ödeme yok. İstediğiniz zaman doldurabileceğiniz bir bakiyeden $0.03'tan başlayan görseller, $0.10'dan başlayan videolar.

Alternatif olarak yerel bir görsel MCP sunucusu çalıştırmak gerekir; bu da makinenizde çalışan bir Node veya Python süreci, kendi sağlayıcı anahtarınız, kota ve harcama takibi demektir. Barındırılan bir uç nokta her iki zorluğu da ortadan kaldırır. Üretim bizim tarafımızda, web oluşturucu ile aynı altyapı üzerinde gerçekleşir ve tek ihtiyacınız iptal edilebilir tek bir anahtardır.

Cline'a uzak bir MCP sunucusu nasıl eklenir?

Aynı sonuca varan üç yöntem vardır. Aşağıdaki ayrıntılar 20 Ağustos 2026 itibarıyla resmi Cline MCP belgelerine göre doğrulanmıştır.

Arayüz üzerinden. Cline paneli araç çubuğundaki MCP Sunucuları simgesine tıklayın, Remote Servers sekmesini açın, sunucu adını, https://bananabanana.pro/api/mcp adresini girin ve aktarım türü olarak Streamable HTTP seçin. Add Server butonuna basın. Ardından Authorization başlığını ekleyin: form hızlı kayıt için idealdir ancak kimlik bilgisi JSON içinde saklanır.

JSON dosyasını düzenleyerek. Aynı simgeye tıklayın, Configure sekmesinden Configure MCP Servers butonuna basın; uzantının ayar dosyası açılır. Bu dosya VS Code'un genel depolama alanında, saoudrizwan.claude-dev adlı bir klasörde yer alır (uzantı kimliği hâlâ ilk yazarın adını taşır ve «cline» adında klasör arayanları yanıltabilir). CLI üzerinde ise yalnızca ~/.cline/mcp.json yolundadır ve cline mcp komutu aynı alanları içeren etkileşimli bir sihirbaz açar.

Terminalden. cline config mcp --json komutu yüklü olan mevcut yapılandırmayı yazdırır; bu da düzenlemenizin geçerli olduğunu doğrulamanın en hızlı yoludur.

Hangi yolu seçerseniz seçin, uç nokta adresi https://bananabanana.pro/api/mcp şeklindedir. İnsanlar için hazırlanan ve POST isteklerine HTML döndüren dokümantasyon sayfası /mcp adresini kullanmayın. MCP sunucu sayfamız genel yapılandırma kodunu ve doğrulanmış istemciler için uyumluluk tablosunu içerir:

Harcama yapmadan önce ücretsiz bir çağrıyla bağlantıyı test edin. get_account fonksiyonu bakiyenizi, anahtar adını ve günlük limitini döndürür; list_models güncel fiyatlarla tüm modelleri listeler. İkisi de ücretsizdir ve yetkilendirmeyi yaklaşık bir saniyede doğrular.

Kullanım senaryosu: Act modunda toplu katalog görselleri

Cline'ın asıl gücünü gösterdiği yer burasıdır ve bu, «bana bir başlık görseli yap» demekten çok farklı bir iştir. Önce Plan modu: kataloğu, her biri kurumsal tarzda bir yer tutucu görsele ihtiyaç duyan on iki ürünü tanımlayın ve Cline'ın hiçbir dosyaya dokunmadan önce döngüyü planlamasına izin verin. Ardından Act modu bunu yürütür.

Kurumsal tarz, yalnızca konu nesnesinin değiştirildiği ve her çağrıda tekrarlanan tek bir metin kalıbıdır. Bir setteki tutarlılık, modelin bir dakika önce ne yaptığını hatırlamasından değil, istemin sabit kısmından kaynaklanır:

→ generate_image {"prompt": "A photorealistic overhead product shot of a
   small monstera in a matte terracotta pot on a pale linen backdrop, soft
   diffused window light from the left, 50mm lens, subtle natural shadow,
   generous empty space around the subject, no text",
   "model": "nano-banana-pro", "aspect_ratio": "4:5"}
← {"job_id": "…", "status": "processing", "cost_charged_usd": 0.11,
   "balance_remaining_usd": 1110.65}

İkinci ürün; aynı stil ifadesi, farklı bir bitki ve farklı bir açı:

Nano Banana Pro ile bu görsellerin on iki tanesi $1.32 tutar. Standart nano-banana-2-lite modelinde bu tutar $0.36'dır ve tasarımcının daha sonra değiştireceği yer tutucular için benim tercihim bu olurdu; Lite rehberimiz ucuz modelin sınırlarını detaylandırır. Bu yazıda iki görseli tam boyutta sergilediğimiz için Pro kullanıldı.

Toplu üretim, güvenlik önlemlerine tam olarak ihtiyaç duyduğunuz yerdir. İki önlem bulunur. Her MCP anahtarı, Profil → MCP API Keys bölümünde isteğe bağlı bir günlük USD limiti alabilir; böylece kontrolden çıkan bir döngü bakiyenizi tüketmek yerine belirlediğiniz rakamda durur. Ayrıca çoklu görsel istekleri (number_of_images birden büyükse) video gibi davranır: ilk çağrı bir fiyat teklifi döndürür ve ajan çağrıyı confirm_cost ile tekrarlayana kadar hiçbir ücret alınmaz.

Video üretimi de aynı onay kuralıyla aynı sohbet üzerinden çalışır. Veo 3.1 Lite üzerinde dört saniyelik sessiz 720p klip $0.10'dan başlar; Omni Flash ise saniye başına $0.10 ücretlendirilir ve ses her zaman dahildir, dolayısıyla üç saniyelik bir klip $0.30 tutar. İşlem 1 ila 10 dakika sürer; generate_video hemen bir iş kimliği döndürdüğü için Cline kodunuz üzerinde çalışmaya devam eder ve hazır olduğunda arka planda get_result ile sorgular.

Yayına almadan önce bilinmesi gereken Cline detayları

Size kazandıracakları zamana göre sıralanmış beş önemli detay.

1. "type": "streamableHttp" tam olarak bu şekilde yazılmalıdır ve yazılmaması sessizce arızaya yol açar. Belgeler son derece açıktır: bu alan boş bırakılırsa istemci geriye dönük uyumluluk için varsayılan olarak eski sse aktarımına döner. Eski SSE, istemcinin URL'nize bir GET isteği açıp olay akışı beklemesi anlamına gelir. Uç noktamız durum bilgisi tutmayan Streamable HTTP olduğundan, GET isteği 405 Method Not Allowed yanıtı alır (bu yazıyı yazarken tekrar kontrol ettim: curl -i https://bananabanana.pro/api/mcp 405 döndürür). Cline'da bu durum, eksik bir yapılandırma alanından hiç bahsetmeyen genel bir bağlanamama hatası olarak görünür. Tireli streamable-http yazımı da aynı şekilde başarısız olur.

2. Anahtar bu dosyada düz metin olarak durur. Cline belgeleri gizli bilgileri ortam değişkenlerinde tutmayı önerir, ancak Cursor'daki ${env:…} veya Windsurf'teki ${file:…} özelliklerinin aksine uzak headers nesnesi içinde değişken kullanımı belgelenmiş bir özellik değildir. Buradaki avantaj konumdur: uzantının ayar dosyası git deponuzda değil, VS Code'un genel depolama alanında tutulur; bu yüzden yanlışlıkla git'e yükleme riski yoktur. Yine de anahtarı diskteki bir kimlik bilgisi olarak değerlendirin: günlük bir limit belirleyin ve bilgisayar el değiştirdiğinde anahtarı profil sayfasından derhal iptal edin.

3. Auto Approve düşündüğünüzden daha geniştir. Cline'ın Auto Approve panelinde «Use MCP servers» seçeneği, bir kategori olarak MCP araçlarını kapsayan tek bir düğmedir; bu nedenle açıldığında para harcayan araçları da ücretsiz olanlarla birlikte onaylar. Araç bazında kontrol yapılandırmanın içinde, sunucunun autoApprove dizisinde yer alır. Benim önerdiğim izin listesi üç ücretsiz çağrıdır (list_models, get_account, get_result); bu da toplu işlemler sırasında onay yorgunluğunu ortadan kaldırırken her ücretli render işleminde onay istemeye devam eder.

4. YOLO modu ile ücretli araçlar birlikte dikkat gerektirir. Cline'ın YOLO modu her şeyi otomatik olarak onaylar: dosya değişiklikleri, terminal komutları, tarayıcı işlemleri ve MCP araçları. Belgeler haklı olarak bunu tehlikeli olarak nitelendirir. Maliyet onaylama adımımız bu modda sizi korumaz, çünkü tamamen otonom bir ajan teklif-onay sürecinin her iki adımını da onaylayacaktır. Sizi koruyan şey, anahtar başına günlük limittir. YOLO modunu açmadan önce mutlaka bir limit belirleyin.

5. Pazar yeri üzerinden kurulum yoktur ve kurumsal denetimler kendi yöntemlerine sahiptir. Resmi SDK destekli VS Code uzantısında artık bir MCP Marketplace gezinme arayüzü bulunmadığından, manuel JSON düzenleme herkes için standart yoldur. Yöneticiler ise farklı bir seçeneğe sahiptir: organizasyonun uzak yapılandırmasındaki remoteMCPServers ayarı sunucuyu tüm kullanıcılara dağıtır ve blockPersonalRemoteMCPServers kullanıcıların kendi sunucularını eklemesini engeller. Bunu bir ekibe dağıtıyorsanız, merkezi olarak dağıtın ve her geliştiriciye kendi anahtarını verin.

Bizim tarafımızdaki dürüst bir kısıtlama: generate_speech çağrısı, Cline panelinde doğrudan çalınabilecek bir oynatıcı yerine imzalı bir WAV bağlantısı döndürür, bu yüzden sesi dinlemek için dosyayı açmak gerekir. Görseller ise URL'nin yanında küçük bir önizleme ile döner. Cline, 2025 yılında araç sonuçlarında görsel içeriği desteği eklediğinden güncel tüm sürümlerde önizleme sorunsuz çalışır.

Cline, uzak MCP sunucuları için OAuth destekliyor mu?

Resmi olarak belgelenmiş bir şekilde hayır; istemciler arasında bu durum farklılık gösterdiği için bunu açıkça belirtmekte fayda var. Cline'ın MCP dokümantasyonu stdio, SSE ve Streamable HTTP aktarımlarını kapsar ve kimlik doğrulama kullanıcı tanımlı başlıklar olarak tanımlanır. OAuth yer almaz. Cline deposunda OAuth desteği için özellik talebi Ağustos 2025'ten bu yana açıktır ve 20 Ağustos 2026 itibarıyla açık kalmaya devam etmektedir.

Pratikte bu durum bir sorun teşkil etmez. Sunucumuz hem OAuth 2.1 belirteçlerini hem de Bearer API anahtarlarını kabul eder ve Cline zaten anahtar yöntemi için tasarlanmıştır. Bu benim de tercih edeceğim yöntemdir: anahtarlar ücretsizdir, birden fazlasına sahip olabilirsiniz ve her biri kendi kullanım günlüğünü (araç, model, maliyet, istem önizlemesi) ve günlük limitini taşır. Bir yüklenici işi bitirdiğinde tek bir anahtarı iptal edersiniz ve kimsenin ortamı bundan etkilenmez.

Projeleri izole etmek istiyorsanız, her şey için tek bir anahtar kullanmak yerine proje başına bir anahtar oluşturun. Böylece faturalandırma zamanı geldiğinde kullanım günlüğü, dahili yönetim paneli maliyeti ile pazarlama sitesi maliyetini net bir şekilde görmenizi sağlar.

Bu makaledeki tanıtım görselleri ne kadara mal oldu?

Standart üretim fiyatları, list_models çağrısının ajana sunduğu rakamların aynısıdır:

Bakiye yüklerken bilmenizde fayda var: $50 ve üzeri yüklemeler bakiyeye %5, $100 ve üzeri yüklemeler %10 ekler ve aktif bir promosyon kodu yükleme tutarına %10 daha ekler. Her iki bonus da ana tutar üzerinden hesaplanır; bu nedenle promosyon koduyla yapılan $100'lık bir yükleme hesabınıza $120 olarak yansır.

Aynı anahtar diğer tüm istemcilerde de çalışır; Cursor veya VS Code kullanıyorsanız yeni bir şey oluşturmanıza gerek kalmaz: aynı bakiye, aynı geçmiş ve tek bir uç nokta. Cursor rehberi ve VS Code kurulumu bu ortamları anlatır. Bir anahtar oluşturun ve Cline'dan ilk görsel grubunuzu isteyin.

SSS

Cline, Streamable HTTP üzerinden uzak MCP sunucularını destekliyor mu?

Evet, Cline'ın kendi belgelerinde önerilen aktarım yöntemi budur. Uzak bir sunucu bir url, streamableHttp olarak belirlenmiş bir type ve kimlik doğrulama için isteğe bağlı bir headers nesnesinden oluşur; eski SSE ise geriye dönük uyumluluk için korunmuştur. type değerini her zaman açıkça belirtin: belirtilmezse modern durum bilgisi tutmayan bir uç noktada çalışmayacak olan SSE'ye geri döner. 20 Ağustos 2026 tarihinde resmi belgelere göre doğrulanmıştır.

Cline'ın MCP ayar dosyası nerede bulunur?

Nasıl çalıştırdığınıza bağlı olarak iki yerde bulunur. VS Code uzantısı bunu VS Code'un genel depolama alanında, saoudrizwan.claude-dev adlı klasörde tutar; klasörleri aramak yerine MCP panelinin Configure sekmesindeki Configure MCP Servers butonuna tıklamak en güvenli yoldur. CLI ise ~/.cline/mcp.json dosyasını kullanır. İkisi de aynı mcpServers nesnesini kabul eder.

Cline'da görsel üretmek için kendi bulut hesabıma ihtiyacım var mı?

Hayır. Yerel olarak çalıştırılan bir görsel MCP sunucusu, kendi hesabınızda kotaları ve faturalandırması olan harici bir sağlayıcı anahtarı gerektirir. Uzak sunucu, üretimi bizim yönetilen anahtar havuzumuz üzerinde çalıştırır; bu nedenle kullanacağınız tek kimlik bilgisi profilinizdeki bb_live_ anahtarıdır. Yeni hesaplar, herhangi bir ödeme yapmadan önce temel modelde altı görseli kapsayan $0.20 başlangıç bakiyesiyle başlar.

Bir ajanın çok fazla harcama yapmasını nasıl engellerim?

Üç kontrolü de kullanmanızı öneririm. Her render işleminin onay istemesi için autoApprove ayarını yalnızca ücretsiz araçlarla sınırlayın. Profil → MCP API Keys bölümünden anahtara günlük bir USD limiti belirleyin; bu, YOLO modunu açsanız bile çalışan tek mekanizmadır. Ayrıca maliyet onaylama adımından yararlanın: video ve çoklu görsel çağrıları ilk çağrıda fiyat teklifi döndürür ve ajan çağrıyı teklif edilen miktarla confirm_cost olarak yineleyene kadar ücret almaz.

Cline MCP sunucum neden bağlanmıyor?

Bu sırayla kontrol edin. "type": "streamableHttp" ifadesinin camelCase olarak yazıldığından emin olun; bu olmadan Cline eski SSE'yi dener ve uç noktamız GET isteğine 405 yanıtı verir. URL'nin /mcp yerine /api/mcp ile bittiğini kontrol edin. Yetkilendirme başlığının fazladan boşluk olmadan tam olarak Bearer bb_live_... şeklinde olduğunu doğrulayın (geçersiz veya iptal edilmiş bir anahtar 401 döndürür). Bağlanıyor ancak araçlar görünmüyorsa MCP panelinden sunucuyu yeniden başlatın. Şirket ağlarındaysanız kişisel uzak sunucuların kurumunuz tarafından engellenip engellenmediğini kontrol edin.