yesilcam-studios paketi Yeşilçam Studios'u terminalinize ve MCP (Model Context Protocol) konuşan yapay zekâ asistanlarına getirir. İki komut kurar: betikler ve üretim hatları için komut satırı aracı yesilcam ile Claude Code, Claude Desktop, Cursor, VS Code, Windsurf ve diğer MCP istemcilerinin stüdyoları araç olarak kullanmasını sağlayan yesilcam-mcp sunucusu. 0.3 sürümü 131 işlemle tüm stüdyoları kapsar: Image, Film, Animation, Cinema, Design, Website, Fashion Try-On, Maket ve AI Influencer Studio; bunlara hesabınız ve kütüphaneniz de dahildir. Web uygulamasıyla aynı hesabı, aynı jeton bakiyesini ve aynı fiyatları kullanır. Bu rehber sizi kurulumdan ilk çalışan sohbete kadar götürür. Genel bakış için Geliştiriciler sayfasına göz atın.

Neye ihtiyacım var?

  • npm komutunu da getiren Node.js 18 ya da daha yeni bir sürüm.
  • Bir Yeşilçam Studios hesabı. Free, Basic ve Pro'nun hepsi çalışır; bazı özellikler, uygulamada olduğu gibi, Basic ya da Pro ister.
  • Bir terminal. Asistan tarafı için Claude Code, Claude Desktop ya da Cursor gibi bir MCP istemcisi.

Nasıl kurarım?

Paketi Yeşilçam Studios sitesinden genel olarak kurun:

npm install -g https://yesilcamstudios.com/downloads/yesilcam-studios.tgz
yesilcam --version
yesilcam --help

yesilcam --version çıktısı 0.3.0 olmalıdır. yesilcam --help her stüdyo için bir tane olmak üzere komut gruplarını listeler; yesilcam <grup> --help (örneğin yesilcam image --help) ise o grubun komutlarını ve seçeneklerini gösterir.

Nasıl giriş yaparım?

Önerilen yol bir API anahtarıdır. Anahtarı uygulamada Hesap → Geliştirici sayfasından oluşturursunuz. Anahtar oluştururken şunları seçersiniz:

  • Ad: anahtarlarınızı sonra ayırt edebilmeniz için (örneğin "Dizüstü" ya da "Derleme sunucusu").
  • Yetki: Yalnız okuma (bakiye, fiyatlar, kütüphane, iş durumu) ya da iş başlatabilen ve jeton harcayabilen Okuma ve üretim.
  • Geçerlilik: 30 gün, 90 gün, 1 yıl ya da süresiz.

Anahtar ysk_ ile başlar ve yalnız bir kez gösterilir; hemen kopyalayın. Ardından yesilcam login komutunu çalıştırıp anahtarı yapıştırın. Yazdığınız görünmez, anahtar hiçbir zaman ekrana basılmaz ve ~/.config/yesilcam/config.json dosyasına yalnız sizin kullanıcınızın okuyabileceği izinlerle kaydedilir. Çalıştığını kontrol edin:

yesilcam login
yesilcam account show

Henüz anahtarınız yoksa e-posta adresiniz ve parolanızla da giriş yapabilirsiniz: yesilcam login --password. Bu yol aynı dosyaya bir oturum kaydeder. Bir sunucuda ya da CI'da diske hiçbir şey yazmayın: anahtarı YESILCAM_API_KEY ortam değişkeniyle verin ya da yesilcam login --key-stdin ile standart girdiden aktarın.

Claude Code'u nasıl bağlarım?

Sunucuyu tek bir komut kaydeder:

claude mcp add yesilcam -- yesilcam-mcp

Sunucu, yesilcam login ile kaydedilen kimlik bilgisini okur; bu yüzden ne komutta ne de Claude Code yapılandırmasında anahtar bulunur.

Claude Desktop, Cursor, VS Code ya da Windsurf'ü nasıl bağlarım?

Bu istemciler MCP sunucularını bir JSON yapılandırma dosyasından okur: Claude Desktop için claude_desktop_config.json, Cursor için ~/.cursor/mcp.json, VS Code ve Windsurf için kendi MCP ayarları. Şu girdiyi ekleyin:

{"mcpServers":{"yesilcam":{"command":"yesilcam-mcp","args":[]}}}

Dosyada başka sunucular zaten varsa ikinci bir mcpServers nesnesi açmak yerine "yesilcam" girdisini mevcut nesnenin içine ekleyin. Sonra istemciyi yeniden başlatın. Bunların hiçbirini ezberlemeniz gerekmez: yesilcam mcp her istemci için hazır parçaları ekrana yazar.

Daha az araç yükleyebilir miyim?

Evet. 131 araç uzun bir listedir; yalnız birkaç stüdyo kullanıyorsanız kısa bir liste asistanın odağını korur. İstediğiniz stüdyoları args içinde verin:

{"mcpServers":{"yesilcam":{"command":"yesilcam-mcp","args":["--studios","image,film,influencer"]}}}

Kullanılabilir adlar image, film, animation, cinema, design, website, fashion, maket ve influencer'dır. Hesap ve kütüphane araçları her zaman yüklenir. Yalnız okuyan araçları yüklemek için "--read-only" ekleyin; örneğin kütüphanenizi raporlayan ama hiçbir zaman iş başlatmaması gereken bir asistan için.

İlk sohbetim nasıl olmalı?

Ücretsiz bir şeyle başlayın: "Yeşilçam jeton bakiyem ne kadar, planımda taslak bir görsel kaça mal olur?" Asistan bakiye ve fiyat araçlarını çağırıp yanıtlar. Sonra küçük bir iş deneyin: "Gün batımında bir deniz fenerinin taslak kalitede 16:9 görselini yap. Önce fiyatını söyle, sonra masaüstüme kaydet." Asistan önce bir fiyat teklifi alır ve hiçbir şey kesilmez. Fiyatı size gösterir; ancak siz onayladıktan sonra aracı onayla yeniden çağırır, görseli bekler ve indirir. Bu adımı jeton onayı rehberi ayrıntılı anlatır; sonra ne isteyebileceğinizi stüdyo tarifleri gösterir.

Sorun giderme

  • "command not found". npm'in genel komutları koyduğu klasör PATH'inizde değil. npm prefix -g konumu gösterir; onun bin klasörünü PATH'e ekleyin ve yeni bir terminal açın.
  • "not signed in" (çıkış kodu 2). Kayıtlı kimlik bilgisi bulunamadı. yesilcam login komutunu yeniden çalıştırın ya da komutun çalıştığı ortamda YESILCAM_API_KEY değişkeninin tanımlı olduğunu kontrol edin.
  • Asistan Yeşilçam araçlarını göstermiyor. Yapılandırmayı düzenledikten sonra istemciyi yeniden başlatın. Sunucu yine başlamıyorsa "command" değerine komutun tam yolunu yazın (macOS ve Linux'ta which yesilcam-mcp gösterir).
  • Anahtar reddediliyor. Süresi dolmuş ya da iptal edilmiş olabilir. Hesap → Geliştirici sayfasından yeni bir anahtar oluşturun ve yesilcam login komutunu yeniden çalıştırın.
  • Üretim reddediliyor ya da asistanda üretim araçları yok. Anahtar Yalnız okuma yetkisiyle oluşturulmuş ya da sunucu --read-only ile başlatılmış.

Sık sorulanlar

CLI ya da MCP sunucusu ek ücretli mi? Hayır. İşlemler uygulamadaki fiyatıyla, planınızın fiyatlarıyla ücretlendirilir ve siz bir teklifi onaylamadan hiçbir şey kesilmez.

Anahtarım asistanın yapılandırmasına yazılıyor mu? Hayır. Yapılandırmada yalnız yesilcam-mcp komutunun adı geçer; sunucu, yesilcam login ile bilgisayarınıza kaydedilen anahtarı okur.

Bir bilgisayardan nasıl çıkış yaparım? yesilcam logout komutunu çalıştırın. Kayıtlı kimlik bilgisini o bilgisayardan siler. API anahtarı ise siz Hesap → Geliştirici sayfasından iptal edene kadar başka yerlerde çalışmaya devam eder.

Uygulamayı ve CLI'ı aynı anda kullanabilir miyim? Evet. Terminalden ya da asistandan başlatılan işler uygulamayla aynı kütüphanede görünür ve aynı bakiyeyi kullanır.