Filmsquare BantuanPanduan

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.

Diperbarui 6 menit baca.md

Di halaman ini
  1. Alat bernama
  2. Ke mana media pergi
  3. find_actions dan run_action
  4. Contoh
  5. Kalau API menolak
  6. Sengaja ditinggalkan
  7. Keamanan
  8. Prompt

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 #

AlatFungsinyaButuh
whats_waitingTahap departemen yang menunggu persetujuan Anda, dan notifikasi Anda yang belum dibaca. Tempat memulai—
list_productionsProduksi di ruang kerja beserta episodenya—
get_episodeSatu episode: adegan dan shot dalam urutan cut, setiap tahap departemen (disetujui, menunggu siapa, minta revisi, terbuka), dan apakah final bisa direnderepisode_id
get_feedbackUtas 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 berakhirtarget_type, target_id
reply_feedbackMembalas 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 mengonfirmasithread_id, body
view_mediaStill, keyframe, atau take sebagai gambar yang bisa dilihat Claude; video kembali sebagai poster beserta tautan unduhasset_version_id
upload_fileFile 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_goLayar mana tempat sebuah file seharusnya: peta, pohon keputusan, dan contoh kerja. Baca saat Anda menyebut sebuah layar—
prepare_uploadURL unggah bertanda tangan dan perintah curl siap pakai untuk hingga 100 file di disk, jadi byte tidak lewat percakapan. Pakai untuk setiap videofiles
add_to_visualizeMenaruh 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 punepisode_id, items
get_scriptRevisi skenario terbaru episode, dan @handle pemeran, set, dan properti yang sudah adaepisode_id
edit_scriptMengubah satu adegan, satu ucapan, atau satu baris skenario tanpa mengirim seluruhnya: teks persis dan penggantinya, disimpan sebagai versi baru; catatan dan tag ikut berpindahepisode_id, base_rev, edits
submit_breakdownMemasukkan breakdown Claude ke Filmsquare: adegan, shot dengan akting, dialog, pemeran, set, dan properti. Penulisan lalu menunggu persetujuanepisode_id, breakdown
get_continuityLembar 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 duluepisode_id
report_continuityMencatat pemeriksaan kontinuitas visual; setiap ketidakcocokan menjadi catatan pada take terpilihepisode_id, seen, issues
submit_styleMemasukkan 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 pembuatname, guide
request_signoffMeminta penyetuju sebuah departemen menyetujui tahap sebuah episode; mereka mendapat notifikasiepisode_id, department
sign_offMencatat 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 memutuskanepisode_id, department, decision
studio_analyticsUntuk 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 sendiriview

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 punyaTempatnyaDengan
Render clay atau still satu shot, dengan lensa, tinggi, dan gerakStoryboard → 3D, pada shotadd_to_visualize
Klip Blender untuk satu shot, satu take, atau satu adeganStoryboard → 3D, pada apa yang dicakupnyaadd_to_visualize
Animatic sebuah adegan, sekuens, atau episodeStoryboard → Animaticadd_to_visualize
Video draf atau final sebuah shotStoryboard → Shots, sebagai takeupload_file
Gambar referensi atau mood boardHome → Filesupload_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.

  1. find_actions mencari 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.
  2. run_action menjalankan satu aksi menurut namanya, dengan path_params (bukan ruang kerja), query, dan body sesuai 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, chooseselect
note, notes, comment, comments, feedbackthread, message
replymessage
rendergeneration, generate
makecreate, generate
new, addcreate
remove, deletearchive
signsignoff
approvesignoff, approval
cast, character, propelement
setelement, location
production, productionsproject
crewmember, steps
costcosts, estimate
priceestimate
prompt, preview, dry rungenerate
kosten, schatting, prijs (Belanda)generate, estimate
mismatchcontinuity
model, modelsmodels, acceptance, routing

Aksi API baru muncul di find_actions begitu dirilis. Tidak perlu alat baru.

Contoh #

UntukCariAksi
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_off mencatat 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

MCP

Claude Anda sendiri mengerjakan ini lewat MCP, atas nama Anda dan dengan peran Anda:

  • find_actions

    Mencari semua yang bisa dilakukan API dan mengembalikan aksi yang cocok beserta inputnya.

    Tanya: Cari aksi yang mengubah aturan persetujuan sebuah tahap.

  • run_action

    Menjalankan satu aksi yang ditemukan dengan find_actions, sebagai Anda, dengan peran dan hak Anda.

    Tanya: Pilih take kedua shot 5 di episode 2.

  • whats_waiting

    Mendaftar tahap yang menunggu persetujuan Anda dan notifikasi Anda yang belum dibaca.

    Tanya: Apa yang menunggu saya di Filmsquare?

  • list_productions

    Mendaftar produksi di ruang kerja Anda beserta episodenya.

    Tanya: Produksi dan episode apa saja yang kita punya di Filmsquare?

  • get_episode

    Menampilkan 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_feedback

    Membaca 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_feedback

    Membalas 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_media

    Melihat 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_file

    Menambahkan 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_script

    Membaca revisi skenario terbaru sebuah episode, beserta @handle yang sudah ada.

    Tanya: Baca skenario episode 2 dan sebutkan karakter mana yang belum punya @handle.

  • edit_script

    Mengubah 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_breakdown

    Memasukkan 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_continuity

    Menata take terpilih sebuah episode berdampingan, dengan versi elemen yang dipakai masing-masing.

    Tanya: Tampilkan take terpilih adegan S2 untuk pemeriksaan kontinuitas.

  • report_continuity

    Mencatat 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_style

    Memasukkan 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_signoff

    Meminta 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_off

    Mencatat 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_go

    Memberi tahu layar mana tempat sebuah file seharusnya: peta, pohon keputusan, dan contoh kerja.

    Tanya: Blockout reel ini sebaiknya ditaruh di mana?

  • prepare_upload

    Memberi tautan unggah bertanda tangan dan perintah curl siap pakai untuk hingga 100 file di disk.

    Tanya: Unggah video di folder ini.

  • add_to_visualize

    Menaruh 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_analytics

    Untuk 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

Halaman ini sebagai Markdown: /docs/id/claude/tools.md