---
title: "Apa yang bisa dikerjakan Claude"
description: "Setiap alat MCP yang diberikan Filmsquare kepada Claude Anda, cara find_actions dan run_action menjangkau sisa API, dan apa yang sengaja ditinggalkan."
url: https://www.filmsquare.ai/docs/id/claude/tools/
lang: id
section: claude
updated: 2026-11-15
mcp: [find_actions, run_action, whats_waiting, list_productions, get_episode, get_feedback, reply_feedback, view_media, upload_file, get_script, edit_script, submit_breakdown, get_continuity, report_continuity, submit_style, request_signoff, sign_off, where_does_it_go, prepare_upload, add_to_visualize, studio_analytics]
---

# Apa yang bisa dikerjakan Claude

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.

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, 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](https://www.filmsquare.ai/docs/id/api/overview/#errors-you-will-meet).

## 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](https://www.filmsquare.ai/docs/id/claude/prompts/).
