Hubungkan Claude atau Cursor ke Cinevva (Server MCP)

Cinevva menyediakan server MCP terkelola yang memungkinkan Claude, Claude Code, Cursor, atau klien MCP apa pun membuat game Anda. AI yang sudah Anda gunakan menjadi otaknya: AI tersebut membaca dan mengedit file game Anda langsung di server kami, tanpa memerlukan tab browser. Buka juga game Anda di kreator Cinevva dan sesi akan aktif: AI kemudian dapat mengimpor aset dari pustaka CC0 kami, membuat rig dan menganimasikan model 3D, mengambil tangkapan layar, menyimulasikan input untuk menguji game yang sedang berjalan, serta memuat ulang pratinjau sementara setiap perubahan ditampilkan langsung di layar Anda.

Yang Anda perlukan

Akun Cinevva (akun gratis dapat digunakan, tetapi pembuatan rig 3D memakai kredit dari saldo Anda) dan klien MCP yang mendukung server jarak jauh dengan OAuth. URL servernya adalah:

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

Server ini menggunakan Streamable HTTP dan melakukan autentikasi dengan OAuth 2.0. Saat Anda terhubung, klien akan membuka halaman masuk Cinevva di browser. Berikan persetujuan sekali, lalu klien akan tetap terhubung.

Edit dari mana saja. Aktifkan sesi langsung untuk melihat dan menguji.

Untuk mengedit file, Anda hanya memerlukan koneksi. Alat file membaca dan menulis salinan utama game Anda di server kami, sehingga asisten Anda dapat memperbaiki bug atau menambahkan fitur meskipun tidak ada tab Cinevva yang terbuka. Sebutkan game yang Anda inginkan (atau biarkan AI memilih dari game Anda), lalu berikan perintah.

Mengaktifkan sesi langsung adalah peningkatan kemampuan, bukan persyaratan. Buka game di cinevva.com/create, tunggu hingga pratinjau dimuat, lalu klik Agen eksternal di bilah alat kreator (ikon colokan, juga tersedia di menu "lainnya" pada layar kecil). Panel akan beralih menjadi "Agen aktif" setelah terhubung. Sesi langsung memberikan mata dan tangan kepada AI di dalam game yang sedang berjalan: tangkapan layar, log konsol, input simulasi, impor aset, dan pembuatan rig 3D. Sesi ini juga menampilkan setiap edit di layar Anda begitu perubahan diterapkan, baik edit tersebut dilakukan melalui tab ini maupun tanpa antarmuka. Tautan langsung akan tetap aktif untuk kunjungan berikutnya sampai Anda mengeklik "Hentikan sesi langsung".

Alat list_live_sessions menampilkan sesi yang terhubung, dan jika tepat satu game sedang terbuka, game tersebut akan dipilih secara otomatis.

Penyiapan di Claude (claude.ai dan desktop)

1. Buka Pengaturan, lalu Konektor, dan pilih "Tambahkan konektor khusus".
2. Beri nama Cinevva dan tempel https://api.cinevva.com/create/mcp sebagai URL. Pastikan tidak ada karakter tambahan; URL harus diakhiri dengan /create/mcp.
3. Klik Tambahkan, lalu Hubungkan. Masuk dengan akun Cinevva Anda saat halaman otorisasi terbuka (gunakan akun yang sama dengan akun yang digunakan di tab game Anda).
4. Minta Claude melakukan sesuatu seperti "tampilkan file game Cinevva saya" untuk mengonfirmasi koneksi. Untuk pengujian langsung, buka game Anda di cinevva.com/create pada tab lain, lalu klik Agen eksternal di bilah alat.

Penyiapan di Claude Code

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

Claude Code akan memandu Anda melalui proses masuk OAuth saat pertama kali digunakan. Setelah itu, minta Claude Code membaca file game Anda atau membuat perubahan. Claude Code dapat digunakan langsung dari terminal tanpa membuka tab browser.

Penyiapan di Cursor

Tambahkan konfigurasi berikut ke .cursor/mcp.json (per proyek) atau ~/.cursor/mcp.json (global):

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

Cursor akan mendeteksi server, menjalankan alur OAuth di browser Anda, dan mencantumkan alat-alatnya di pengaturan MCP.

Fungsi alat-alat tersebut

Kelompok	Alat	Memerlukan sesi langsung?
Membaca game	list_game_files, read_files, search_game_file	Tidak, membaca salinan di server dari game Anda mana pun
Mengedit game	edit_files, write_files, delete_files, rename_files	Tidak, edit diterapkan di sisi server dan ditampilkan langsung di tab yang terbuka
Pratinjau	game_ready	Memuat ulang pratinjau tab aktif, atau menyimpan tanpa antarmuka jika tidak ada tab aktif
Memantau game	read_console_logs, take_screenshot	Ya
Pengujian	execute_js, simulate_input, get_task_status	Ya
Aset	search_assets, list_asset_packs, import_asset, search_fonts	Ya. Sekitar 7.000 properti, audio, dan HDRI CC0
Pembuatan rig 3D	rig_model, apply_animation	Ya, memakai kredit
Dokumentasi	list_library_docs, search_library_docs, read_library_docs, list_animations	Ya

Pembuatan rig memerlukan jumlah kredit yang sama seperti di Game Creator dalam aplikasi. Semua fitur lainnya gratis. Kreator dalam aplikasi juga dapat menghasilkan gambar, musik, efek suara, dan skybox dengan AI; alat-alat tersebut tersedia di aplikasi Cinevva dan bukan bagian dari konektor MCP.

Pemecahan masalah

"Tidak ada server MCP yang ditemukan di URL yang diberikan" saat penyiapan biasanya berarti URL salah ketik atau memiliki karakter tambahan di bagian akhir. URL harus sama persis dengan https://api.cinevva.com/create/mcp.

"Tidak ada sesi langsung" hanya muncul dari alat runtime (tangkapan layar, konsol, input, aset, dan pembuatan rig). Ini berarti tidak ada tab browser yang membuka game tersebut dengan tautan langsung aktif. Buka game Anda, klik Agen eksternal di bilah alat, lalu coba lagi. Alat file tidak pernah memerlukan sesi ini: tanpa sesi, alat tersebut dapat digunakan pada game Anda mana pun berdasarkan gameId, dan akan menampilkan daftar game Anda jika Anda tidak memberikan gameId.

Jika alat terhenti pada koneksi baru, muat ulang tab game agar tersambung kembali, lalu panggil list_live_sessions.

Pertanyaan atau masalah: [email protected].