Cinevva'yı Claude veya Cursor'a Bağlama (MCP Sunucusu)

Cinevva; Claude, Claude Code, Cursor veya herhangi bir MCP istemcisinin oyunlarınızı geliştirmesine olanak tanıyan, barındırılan bir MCP sunucusuyla birlikte gelir. Zaten kullandığınız yapay zekâ beyniniz hâline gelir: oyun dosyalarınızı doğrudan sunucularımızda okur ve düzenler, tarayıcı sekmesi gerekmez. Oyununuzu Cinevva oluşturucusunda da açtığınızda oturum canlıya geçer: yapay zekâ CC0 kitaplığımızdan varlıkları içe aktarabilir, 3D modelleri donatıp canlandırabilir, ekran görüntüleri alabilir, çalışan oyunu test etmek için girdileri simüle edebilir ve her değişiklik ekranınıza aktarılırken önizlemeyi yenileyebilir.

Gereksinimler

Bir Cinevva hesabı (ücretsiz hesap kullanılabilir; 3D donatma, bakiyenizdeki kredileri harcar) ve OAuth ile uzak sunucuları destekleyen bir MCP istemcisi gerekir. Sunucu URL'si:

https://api.cinevva.com/create/mcp

Sunucu, Streamable HTTP kullanır ve OAuth 2.0 ile kimlik doğrulaması yapar. Bağlandığınızda istemciniz tarayıcıda bir Cinevva giriş sayfası açar. Bir kez onayladıktan sonra istemci bağlı kalır.

Her yerde düzenleyin. İzlemek ve test etmek için canlıya geçin.

Dosya düzenlemek için bağlantı dışında hiçbir şeye ihtiyacınız yoktur. Dosya araçları, oyunlarınızın sunucularımızdaki yetkili kopyasını okuyup yazar; böylece hiçbir yerde açık bir Cinevva sekmesi olmasa bile asistanınız bir hatayı düzeltebilir veya yeni bir özellik ekleyebilir. İstediğiniz oyunun adını belirtin (ya da yapay zekânın oyunlarınız arasından seçmesine izin verin) ve komutunuzu yazın.

Canlıya geçmek bir yükseltmedir, zorunluluk değildir. Oyunu cinevva.com/create adresinde açın, önizlemenin yüklenmesini bekleyin ve ardından oluşturucu araç çubuğundaki Harici ajan seçeneğine tıklayın (fiş simgesi; küçük ekranlarda "daha fazla" menüsünde de bulunur). Bağlantı kurulduğunda panel "Ajan canlı" durumuna geçer. Canlı oturum, yapay zekâya çalışan oyunu görme ve kullanma olanağı verir: ekran görüntüleri, konsol günlükleri, simüle edilmiş girdiler, varlık içe aktarma ve 3D donatma. Ayrıca düzenleme ister bu sekmeden ister arka planda yapılmış olsun, gerçekleştiği anda her değişikliği ekranınıza aktarır. "Canlı oturumu durdur" seçeneğine tıklayana kadar canlı bağlantı sonraki ziyaretlerde de açık kalır.

list_live_sessions aracı hangi oturumların bağlı olduğunu gösterir ve yalnızca bir oyun açık olduğunda otomatik olarak o oyun hedeflenir.

Claude'da kurulum (claude.ai ve masaüstü)

1. Ayarlar'ı, ardından Bağlayıcılar'ı açın ve "Özel bağlayıcı ekle" seçeneğini belirleyin.
2. Cinevva adını verin ve URL olarak https://api.cinevva.com/create/mcp adresini yapıştırın. Yanlışlıkla eklenmiş karakterlere dikkat edin; URL /create/mcp ile bitmelidir.
3. Ekle'ye, ardından Bağlan'a tıklayın. Yetkilendirme sayfası açıldığında Cinevva hesabınızla giriş yapın (oyun sekmenizde oturum açtığınız hesapla aynı olmalıdır).
4. Bağlantıyı doğrulamak için Claude'dan "Cinevva oyun dosyalarımı listele" gibi bir istekte bulunun. Canlı test için oyununuzu başka bir sekmede cinevva.com/create adresinde açın ve araç çubuğundaki Harici ajan seçeneğine tıklayın.

Claude Code'da kurulum

claude mcp add --transport http cinevva https://api.cinevva.com/create/mcp

Claude Code, ilk kullanımda OAuth giriş sürecinde size rehberlik eder. Ardından oyun dosyalarınızı okumasını veya bir değişiklik yapmasını isteyin. Açık bir tarayıcı sekmesine gerek olmadan doğrudan terminalden çalışır.

Cursor'da kurulum

Bunu .cursor/mcp.json (proje başına) veya ~/.cursor/mcp.json (genel) dosyasına ekleyin:

{
  "mcpServers": {
    "cinevva": {
      "url": "https://api.cinevva.com/create/mcp"
    }
  }
}

Cursor sunucuyu algılar, tarayıcınızda OAuth akışını çalıştırır ve araçları MCP ayarlarında listeler.

Araçlar ne işe yarar?

Grup	Araçlar	Canlı oturum gerekiyor mu?
Oyunu okuma	list_game_files, read_files, search_game_file	Hayır, oyunlarınızdan herhangi birinin sunucu kopyasını okur
Oyunu düzenleme	edit_files, write_files, delete_files, rename_files	Hayır, düzenlemeler sunucu tarafında uygulanır ve açık bir sekmeye aktarılır
Önizleme	game_ready	Canlı sekmenin önizlemesini yeniler; aksi durumda arka planda kaydeder
Oyunu izleme	read_console_logs, take_screenshot	Evet
Test	execute_js, simulate_input, get_task_status	Evet
Varlıklar	search_assets, list_asset_packs, import_asset, search_fonts	Evet. Yaklaşık 7.000 CC0 nesne, ses ve HDRI
3D donatma	rig_model, apply_animation	Evet, kredi harcar
Belgeler	list_library_docs, search_library_docs, read_library_docs, list_animations	Evet

Donatma, uygulama içi Game Creator ile aynı miktarda krediye mal olur. Diğer her şey ücretsizdir. Uygulama içi oluşturucu ayrıca yapay zekâyla görseller, müzikler, ses efektleri ve gökyüzü kutuları üretir; bu araçlar Cinevva uygulamasının içinde bulunur ve MCP bağlayıcısının parçası değildir.

Sorun giderme

Kurulum sırasında görülen "Belirtilen URL'de MCP sunucusu bulunamadı" mesajı genellikle URL'de bir yazım hatası veya sonunda fazladan bir karakter olduğu anlamına gelir. URL tam olarak https://api.cinevva.com/create/mcp olmalıdır.

"Canlı oturum yok" mesajı yalnızca çalışma zamanı araçlarından (ekran görüntüleri, konsol, girdi, varlıklar, donatma) gelir. Bu, canlı bağlantısı açık olarak oyunun bulunduğu hiçbir tarayıcı sekmesi olmadığı anlamına gelir. Oyununuzu açın, araç çubuğundaki Harici ajan seçeneğine tıklayın ve tekrar deneyin. Dosya araçlarının buna hiçbir zaman ihtiyacı yoktur: oturum olmadığında oyunlarınızdan herhangi biri üzerinde gameId ile çalışır ve bir gameId belirtmezseniz oyunlarınızı listeler.

Yeni kurulan bir bağlantıda araçlar yanıt vermiyorsa yeniden bağlanması için oyun sekmesini yenileyin, ardından list_live_sessions çağrısını yapın.

Sorular veya sorunlar için: [email protected].