5.0 Bekerja dengan Claude Anda sendiri5.2 Apa yang bisa dikerjakan Claude
Apa yang bisa dikerjakan Claude
Setiap alat MCP yang diberikan Filmsquare kepada Claude Anda, cara find_actions dan run_action menjangkau sisa API, dan apa yang sengaja ditinggalkan.
Claude Anda bisa melakukan di Filmsquare apa yang diizinkan API untuk peran Anda. Delapan belas alat bernama mencakup pekerjaan sehari-hari;
dua lagi, find_actions dan run_action, menjangkau setiap aksi API lainnya. Setiap panggilan lewat API itu sendiri, sebagai
Anda: pemeriksaan peran yang sama, validasi yang sama, gerbang yang sama.
Alat bernama #
| Alat | Fungsinya | Butuh |
|---|---|---|
whats_waiting | Tahap departemen yang menunggu persetujuan Anda, dan notifikasi Anda yang belum dibaca. Tempat memulai | — |
list_productions | Produksi di ruang kerja beserta episodenya | — |
get_episode | Satu episode: adegan dan shot dalam urutan cut, setiap tahap departemen (disetujui, menunggu siapa, minta revisi, terbuka), dan apakah final bisa dirender | episode_id |
get_feedback | Utas komentar pada shot, take, episode, adegan, elemen, folder, versi aset, kanvas, atau blok kanvas, dengan setiap pesan dan pin-nya (timecode dalam frame, atau region gambar). Utas terbuka secara default; status resolved atau all untuk sisanya. Dengan target_type sheet: catatan terbuka pada versi terbaru lembar (maksud, kutipan atau seluruh lembar, teks saran, ditangani atau belum) dan bagaimana catatan versi sebelumnya berakhir | target_type, target_id |
reply_feedback | Membalas di utas sebagai Anda (mention @nama memberi notifikasi kepada orang), dan menandainya selesai saat catatan tertangani. Catatan pada lembar ditandai ditangani sebagai gantinya; kalau ada saran, suggestion_outcome (diterapkan, disesuaikan, atau ditolak) wajib diisi, dan seseorang yang mengonfirmasi | thread_id, body |
view_media | Still, keyframe, atau take sebagai gambar yang bisa dilihat Claude; video kembali sebagai poster beserta tautan unduh | asset_version_id |
upload_file | File dari percakapan ke layer shot atau adegan sebagai take baru, atau ke produksi sebagai aset. Maksimal 10 MB. pick: true juga memilihnya (sutradara ke atas) | name, mime, data_base64 |
where_does_it_go | Layar mana tempat sebuah file seharusnya: peta, pohon keputusan, dan contoh kerja. Baca saat Anda menyebut sebuah layar | — |
prepare_upload | URL unggah bertanda tangan dan perintah curl siap pakai untuk hingga 100 file di disk, jadi byte tidak lewat percakapan. Pakai untuk setiap video | files |
add_to_visualize | Menaruh file yang diunggah di Storyboard → 3D atau Storyboard → Animatic, hingga 100 per panggilan, pada shot dan adegan menurut kode. Mengirim yang sama lagi tidak mengubah apa pun | episode_id, items |
get_script | Revisi skenario terbaru episode, dan @handle pemeran, set, dan properti yang sudah ada | episode_id |
edit_script | Mengubah satu adegan, satu ucapan, atau satu baris skenario tanpa mengirim seluruhnya: teks persis dan penggantinya, disimpan sebagai versi baru; catatan dan tag ikut berpindah | episode_id, base_rev, edits |
submit_breakdown | Memasukkan breakdown Claude ke Filmsquare: adegan, shot dengan akting, dialog, pemeran, set, dan properti. Penulisan lalu menunggu persetujuan | episode_id, breakdown |
get_continuity | Lembar kontinuitas sebuah episode: apa yang diputar tiap shot, elemen dan referensinya, dengan apa tiap take terpilih dibuat, temuan sejauh ini, shot yang perlu diperiksa lagi. Menjalankan pemeriksaan lineage gratis lebih dulu | episode_id |
report_continuity | Mencatat pemeriksaan kontinuitas visual; setiap ketidakcocokan menjadi catatan pada take terpilih | episode_id, seen, issues |
submit_style | Memasukkan panduan gaya ke pustaka style (Create → Styles): style baru, atau dengan style_id versi berikutnya; production_id menjadikannya milik sebuah produksi. Karya sendiri membawa hingga 6 still referensi (diunggah dengan prepare_upload); karya orang lain hanya teks dan tidak pernah dipublikasikan. Nama orang atau merek ditolak. Peran pembuat | name, guide |
request_signoff | Meminta penyetuju sebuah departemen menyetujui tahap sebuah episode; mereka mendapat notifikasi | episode_id, department |
sign_off | Mencatat keputusan Anda pada sebuah tahap: approved atau changes_requested, dengan note opsional. Hanya penyetuju tahap itu yang bisa. Dengan expect_version (versi tahap seperti yang Anda lihat) ia ditolak dengan changed_since kalau pekerjaan bergeser. Hanya saat Anda meminta Claude memutuskan | episode_id, department, decision |
studio_analytics | Untuk pemilik dan produser: bagaimana kabar studio, dengan angka Analytics. view crew (per orang dalam satu periode: terkirim, kredit per kiriman, waktu sampai persetujuan, lolos pertama, lane, ulang, jam kerja langsung dan jam agen sendiri, median studio, dan waktu per tahap), day, costs, atau report (teks email laporan seperti yang akan dikirim). Selain mereka ditolak: mereka hanya melihat angka mereka sendiri | view |
Setiap alat juga menerima workspace opsional. Tidak perlu diisi: ruang kerja koneksi yang dipakai.
department adalah salah satu dari writing, breakdown, casting, voice, wardrobe, sets, props, animatic,
music, draft, sound, edit, final.
Ke mana media pergi #
Sebut layarnya dengan kata-kata Anda sendiri ke Claude ("taruh di bawah 3D"). Begini yang dilakukannya:
| Yang Anda punya | Tempatnya | Dengan |
|---|---|---|
| Render clay atau still satu shot, dengan lensa, tinggi, dan gerak | Storyboard → 3D, pada shot | add_to_visualize |
| Klip Blender untuk satu shot, satu take, atau satu adegan | Storyboard → 3D, pada apa yang dicakupnya | add_to_visualize |
| Animatic sebuah adegan, sekuens, atau episode | Storyboard → Animatic | add_to_visualize |
| Video draf atau final sebuah shot | Storyboard → Shots, sebagai take | upload_file |
| Gambar referensi atau mood board | Home → Files | upload_file |
Sesuatu yang salah tempat dipindah tanpa mengunggah ulang: moveTake atau moveAsset lewat run_action (sutradara ke atas). Pilihan yang dibuat impor dihapus bersama pemindahan. Take yang dipilih seseorang, atau yang di-generate di sini, tetap di tempatnya.
find_actions dan run_action #
Semua yang tidak punya alat bernama lewat dua ini: membuat shot, memilih take, membuat draf, estimasi, elemen dan versi, folder, kanvas, biaya, brief, kru.
find_actionsmencari katalog API sendiri dengan beberapa kata, seperti "pick take", "create shot", atau "resolve thread". Ia mengembalikan aksi yang cocok beserta method, path, ringkasan, peran minimum, dan inputnya.run_actionmenjalankan satu aksi menurut namanya, denganpath_params(bukan ruang kerja),query, danbodysesuai yang dijelaskan aksinya. Ia menjawab dengan JSON API.
find_actions memahami bahasa set. Ia memetakan kata yang dipakai kru ke kata milik API:
| Anda menulis (dalam bahasa Inggris) | Ia juga mencari |
|---|---|
| pick, choose | select |
| note, notes, comment, comments, feedback | thread, message |
| reply | message |
| render | generation, generate |
| make | create, generate |
| new, add | create |
| remove, delete | archive |
| sign | signoff |
| approve | signoff, approval |
| cast, character, prop | element |
| set | element, location |
| production, productions | project |
| crew | member, steps |
| cost | costs, estimate |
| price | estimate |
| prompt, preview, dry run | generate |
| kosten, schatting, prijs (Belanda) | generate, estimate |
| mismatch | continuity |
| model, models | models, acceptance, routing |
Aksi API baru muncul di find_actions begitu dirilis. Tidak perlu alat baru.
Contoh #
| Untuk | Cari | Aksi |
|---|---|---|
| Menghitung harga draf sebelum merendernya | "estimate shot" | estimateShotGeneration |
| Melihat prompt, model, dan kredit sebelum merender | "dry run" | generateForShot dengan {"kind": "video", "tier": "draft", "dryRun": true} |
| Merender draf | "generate shot" | generateForShot dengan {"kind": "video", "tier": "draft"} |
| Memilih take | "pick take" | selectTake |
| Menjadikan draf sebagai final | "promote" | promoteGeneration |
| Retake dari catatan | "revise take" | estimateReviseTake, lalu reviseTake |
| Melihat model mana yang diterima | "model acceptance" | getModelAcceptance |
| Biaya sebuah episode | "episode costs" | getEpisodeCosts |
Sebelum merender, Claude memanggil aksi generate dengan dryRun: true: ia menampilkan prompt yang sudah disusun, model,
referensi, dan kredit, tanpa membuat apa pun. Ia lalu bisa mengubah prompt untuk satu render itu.
overrides.prompt mengganti teks prompt (baris referensi tetap, jadi pemeran, set, dan properti selalu ikut),
overrides.promptAppend menambahkannya, dan overrides.negativePrompt menambah apa yang harus dihindari. Dialog diucapkan dari
barisnya dan tidak menerima override prompt.
Dry run menjawab dengan provider dan model_key. Mengirim keduanya kembali sebagai provider dan modelKey menahan model itu.
getGeneration membaca kembali dengan apa take dibuat: prompt, model, kredit estimasi, dan kredit yang
dibukukan.
Kalau API menolak #
Penolakan kembali sebagai error alat dengan kode dan rincian API, misalnya
The API refused: 409 gate_closed: finals render once casting, sets, animatic are signed off {"episode_id": "…", "waiting_on": ["casting", "sets", "animatic"]}.
Claude membacanya dan menyampaikan apa yang kurang. Lihat Error yang akan Anda temui.
Sengaja ditinggalkan #
Claude tidak bisa menjangkau ini, by design:
- Kunci API dan koneksi Claude: koneksi tidak pernah membuat kunci atau mengizinkan koneksi lain. Orang yang melakukannya, setelah masuk.
- OAuth dan pendaftaran.
- Webhook: mengirim data keluar dari Filmsquare.
- Callback penyedia dan socket realtime (kanvas dan presence).
Gerbang final, pemeriksaan kredit, dan batas paket berlaku untuk Claude persis seperti untuk siapa pun.
Keamanan #
- Claude bertindak sebagai Anda. Ia memegang peran Anda (atau yang lebih rendah yang Anda pilih saat menghubungkan), dan apa yang dilakukannya tampil atas nama Anda.
- Materi kru bukan instruksi. Komentar, skenario, dan teks lain yang dibaca Claude di Filmsquare adalah materi dari kru. Filmsquare memberi tahu Claude demikian: hanya Anda yang memutuskan apa yang dikerjakannya.
- Ia menyebut harga lebih dulu. Membuat take memakai kredit. Claude diminta memanggil aksi generate dengan
dryRun: true, yang tidak membuat apa pun, dan menyebut biaya sebuah take sebelum memulainya, dan tidak pernah merender final tanpa diminta. - Ia tidak pernah menyetujui tanpa diminta.
sign_offmencatat keputusan atas nama Anda. Claude diminta memakainya hanya saat Anda memintanya memutuskan.
Prompt #
Empat prompt membawa cara kerja untuk pekerjaan umum: break_down_episode, process_feedback, work_on_step, dan
check_continuity. Lihat Prompt dan cara kerja.
Dengan Claude
MCPClaude Anda sendiri mengerjakan ini lewat MCP, atas nama Anda dan dengan peran Anda:
find_actionsMencari semua yang bisa dilakukan API dan mengembalikan aksi yang cocok beserta inputnya.
Tanya: Cari aksi yang mengubah aturan persetujuan sebuah tahap.
run_actionMenjalankan satu aksi yang ditemukan dengan find_actions, sebagai Anda, dengan peran dan hak Anda.
Tanya: Pilih take kedua shot 5 di episode 2.
whats_waitingMendaftar tahap yang menunggu persetujuan Anda dan notifikasi Anda yang belum dibaca.
Tanya: Apa yang menunggu saya di Filmsquare?
list_productionsMendaftar produksi di ruang kerja Anda beserta episodenya.
Tanya: Produksi dan episode apa saja yang kita punya di Filmsquare?
get_episodeMenampilkan adegan dan shot sebuah episode dalam urutan cut, setiap tahap departemen, dan apakah final bisa dirender.
Tanya: Episode 2 sudah sampai mana, dan tiap tahap menunggu siapa?
get_feedbackMembaca utas komentar pada sebuah shot, take, episode, atau elemen, dengan timecode atau region tiap pin.
Tanya: Catatan mana yang masih terbuka di episode 2?
reply_feedbackMembalas di utas komentar sebagai Anda, dan menandainya selesai setelah catatan ditangani.
Tanya: Balas catatan di shot 4 bahwa draf baru sudah memperbaiki eyeline, lalu tandai selesai.
view_mediaMelihat still, keyframe, atau take; video kembali sebagai poster beserta tautan unduh.
Tanya: Tunjukkan still terpilih shot 3 dan beri tahu saya apakah cocok dengan referensinya.
upload_fileMenambahkan file yang Anda punya sebagai take baru pada sebuah shot atau adegan, atau sebagai aset produksi (maksimal 10 MB).
Tanya: Unggah foto referensi ini ke aset produksi.
get_scriptMembaca revisi skenario terbaru sebuah episode, beserta @handle yang sudah ada.
Tanya: Baca skenario episode 2 dan sebutkan karakter mana yang belum punya @handle.
edit_scriptMengubah satu adegan, satu ucapan, atau satu baris skenario sebuah episode dan menyimpannya sebagai versi baru, tanpa mengirim seluruh skenario.
Tanya: Tulis ulang pembukaan S02 di episode 2 seperti yang baru kita bahas, dan simpan sebagai versi baru.
submit_breakdownMemasukkan breakdown Anda ke Filmsquare: adegan, shot, dialog, pemeran, set, dan properti.
Tanya: Pecah skenario episode 2 jadi breakdown dan kirimkan. Pakai handle yang sudah kita punya.
get_continuityMenata take terpilih sebuah episode berdampingan, dengan versi elemen yang dipakai masing-masing.
Tanya: Tampilkan take terpilih adegan S2 untuk pemeriksaan kontinuitas.
report_continuityMencatat pemeriksaan kontinuitas yang Anda lakukan; setiap ketidakcocokan menjadi catatan pada take terpilih shot.
Tanya: Periksa kontinuitas di adegan S2 dan laporkan ketidakcocokan yang Anda temukan.
submit_styleMemasukkan panduan gaya ke pustaka style Anda (Create, Styles): style baru atau versi berikutnya dari yang sudah ada.
Tanya: Lihat still ini, tulis panduan gaya, tunjukkan ke saya, dan kirimkan saat saya bilang jalan.
request_signoffMeminta penyetuju sebuah tahap departemen untuk menyetujui; mereka mendapat notifikasi.
Tanya: Minta penyetuju tahap berikutnya di episode 2 untuk menyetujui, dengan catatan tentang apa yang berubah.
sign_offMencatat keputusan Anda pada sebuah tahap: disetujui atau minta revisi. Hanya saat Anda memintanya memutuskan.
Tanya: Setujui tahap berikutnya di episode 2 atas nama saya.
where_does_it_goMemberi tahu layar mana tempat sebuah file seharusnya: peta, pohon keputusan, dan contoh kerja.
Tanya: Blockout reel ini sebaiknya ditaruh di mana?
prepare_uploadMemberi tautan unggah bertanda tangan dan perintah curl siap pakai untuk hingga 100 file di disk.
Tanya: Unggah video di folder ini.
add_to_visualizeMenaruh file yang diunggah di Storyboard, 3D, atau Animatic, pada shot dan adegan menurut kode.
Tanya: Taruh hasil Blender di 3D dan animatic di Animatic.
studio_analyticsUntuk pemilik dan produser: bagaimana kabar studio, dari kru, satu hari, biaya, atau email laporan seperti yang akan dikirim.
Tanya: Bagaimana kru minggu lalu, dan siapa yang butuh bantuan?
Hubungkan Claude 5.1