5.0 Mit deinem eigenen Claude arbeiten5.2 Was Claude kann
Was Claude kann
Jedes MCP-Tool, das Filmsquare deinem Claude gibt, wie find_actions und run_action den Rest der API erreichen, und was bewusst fehlt.
Dein Claude kann in Filmsquare tun, was die API deiner Rolle erlaubt. Achtzehn benannte Tools decken die tägliche
Arbeit ab; zwei weitere, find_actions und run_action, erreichen jede andere API-Aktion. Jeder Aufruf geht durch
die API selbst, als du: dieselben Rollenprüfungen, dieselbe Validierung, dasselbe grüne Licht.
Die benannten Tools #
| Tool | Was es tut | Braucht |
|---|---|---|
whats_waiting | Schritte, die auf deine Abnahme warten, und deine ungelesenen Benachrichtigungen. Der Ort zum Starten | — |
list_productions | Die Produktionen im Workspace mit ihren Folgen | — |
get_episode | Eine Folge: Szenen und Einstellungen in Schnittreihenfolge, jeder Gewerk-Schritt (abgenommen, auf wen er wartet, Korrekturen verlangt, offen) und ob die Finals rendern können | episode_id |
get_feedback | Kommentar-Threads zu einer Einstellung, einem Take, einer Folge, Szene, einem Element, Ordner, einer Asset-Version, einem Canvas oder Canvas-Node, mit jeder Nachricht und ihrem Pin (Timecode in Frames oder ein Bereich des Bildes). Standardmäßig offene Threads; status resolved oder all für den Rest. Mit target_type sheet: die offenen Anmerkungen auf der neuesten Version des Sheets (Absicht, Zitat oder das ganze Sheet, vorgeschlagener Text, abgearbeitet oder nicht) und wie die Anmerkungen früherer Versionen ausgingen | target_type, target_id |
reply_feedback | Antworte in einem Thread als du (@name-Erwähnungen benachrichtigen Personen) und erledige ihn, wenn die Anmerkung abgearbeitet ist. Eine Anmerkung auf einem Sheet wird stattdessen als abgearbeitet markiert; wenn sie einen Vorschlag hat, ist suggestion_outcome (applied, adapted oder declined) erforderlich, und ein Mensch bestätigt sie | thread_id, body |
view_media | Ein Standbild, Keyframe oder Take als Bild, das Claude ansehen kann; ein Video kommt als Posterbild plus Download-Link zurück | asset_version_id |
upload_file | Eine Datei aus dem Gespräch auf einen Layer einer Einstellung oder einer Szene als neuer Take, oder in eine Produktion als Asset. Höchstens 10 MB. pick: true wählt sie auch (Regie und höher) | name, mime, data_base64 |
where_does_it_go | Auf welchen Bildschirm eine Datei gehört: die Karte, ein Entscheidungsbaum und ausgearbeitete Beispiele. Zu lesen, sobald du einen Bildschirm nennst | — |
prepare_upload | Signierte Upload-URLs und fertige curl-Befehle für bis zu 100 Dateien auf der Festplatte, damit die Bytes nie durch das Gespräch gehen. Für jedes Video | files |
add_to_visualize | Legt hochgeladene Dateien unter Storyboard → 3D oder Storyboard → Animatic ab, bis zu 100 pro Aufruf, auf Einstellungen und Szenen per Code. Dasselbe erneut zu senden ändert nichts | episode_id, items |
get_script | Die neueste Drehbuchfassung der Folge und die @handles der Figuren, Motive und Requisiten, die es schon gibt | episode_id |
edit_script | Eine Szene, eine Rede oder eine Zeile des Drehbuchs ändern, ohne das ganze Drehbuch zu senden: genauer Text und was ihn ersetzt, gespeichert als neue Version; Anmerkungen und Tags wandern mit | episode_id, base_rev, edits |
submit_breakdown | Den Drehbuchauszug von Claude in Filmsquare bringen: Szenen, Einstellungen mit Spiel, Dialog, Figuren, Motive und Requisiten. Das Drehbuch wartet dann auf Abnahme | episode_id, breakdown |
get_continuity | Das Continuity-Sheet einer Folge: was jede Einstellung abspielt, die Elemente und ihre Referenzen, womit jeder gewählte Take gemacht wurde, bisherige Befunde, Einstellungen zum erneuten Prüfen. Führt zuerst den kostenlosen Lineage-Check aus | episode_id |
report_continuity | Einen visuellen Continuity-Check festhalten; jede Abweichung wird zu einer Anmerkung am gewählten Take | episode_id, seen, issues |
submit_style | Einen Style Guide in die Style-Bibliothek legen (Create → Styles): ein neuer Style oder, mit style_id, seine nächste Version; mit production_id wird er der Style einer Produktion. Eigene Arbeit trägt bis zu 6 Referenz-Standbilder (hochgeladen mit prepare_upload); die Arbeit anderer ist reiner Text und wird nie veröffentlicht. Namen von Personen oder Marken werden abgelehnt. Rolle Maker | name, guide |
request_signoff | Die Abnehmenden eines Gewerks bitten, den Schritt einer Folge abzunehmen; sie bekommen eine Benachrichtigung | episode_id, department |
sign_off | Deine Entscheidung zu einem Schritt festhalten: approved oder changes_requested, mit optionaler note. Nur die Abnehmenden des Schritts können das. Mit expect_version (die Version des Schritts, wie du sie gesehen hast) wird es mit changed_since abgelehnt, wenn sich die Arbeit bewegt hat. Nur, wenn du Claude gebeten hast zu entscheiden | episode_id, department, decision |
studio_analytics | Für den Owner und Producer: wie es dem Studio geht, mit den Zahlen aus Analytics. view crew (pro Person über einen Zeitraum: Delivered, Credits pro Delivered, Zeit bis zur Abnahme, First Pass, Lanes, Redo, Hands-on- und Agent-alone-Stunden, der Median des Studios und die Zeit pro Schritt), day, costs oder report (der Text der Berichtsmail, wie sie verschickt würde). Alle anderen werden abgewiesen: Sie sehen nur ihre eigenen Zahlen | view |
Jedes Tool nimmt außerdem ein optionales workspace. Lass es weg: Es wird der Workspace der Verbindung genutzt.
department ist eines von writing, breakdown, casting, voice, wardrobe, sets, props, animatic,
music, draft, sound, edit, final.
Wohin Medien gehören #
Nenne deinem Claude den Bildschirm in deinen eigenen Worten („leg es unter 3D“). Das macht er dann:
| Du hast | Es geht nach | Mit |
|---|---|---|
| Clay-Render oder Standbild einer Einstellung, mit Objektiv, Höhe und Bewegung | Storyboard → 3D, auf die Einstellung | add_to_visualize |
| Blender-Clip einer Einstellung, eines Takes oder einer Szene | Storyboard → 3D, auf das, was er abdeckt | add_to_visualize |
| Animatic einer Szene, Sequenz oder Folge | Storyboard → Animatic | add_to_visualize |
| Draft- oder Final-Video einer Einstellung | Storyboard → Shots, als Take | upload_file |
| Referenzbild oder Moodboard | Home → Files | upload_file |
Was am falschen Ort liegt, zieht ohne erneuten Upload um: moveTake oder moveAsset über run_action (Regie und höher). Ein gewählter Take, den der Import gesetzt hat, entfällt beim Umzug. Ein Take, den jemand gewählt hat oder der hier generiert wurde, bleibt, wo er ist.
find_actions und run_action #
Alles ohne benanntes Tool läuft über diese beiden: Einstellungen anlegen, Takes wählen, Drafts machen, Schätzungen, Elemente und Versionen, Ordner, Canvases, Kosten, Briefings, Crew.
find_actionsdurchsucht den eigenen Katalog der API mit ein paar Worten, etwa „pick take“, „create shot“ oder „resolve thread“. Er liefert passende Aktionen mit Methode, Pfad, einer Zusammenfassung, der Mindestrolle und den Eingaben.run_actionführt eine über ihren Namen aus, mitpath_params(nicht der Workspace),queryundbody, wie die Aktion es beschreibt. Er antwortet mit dem JSON der API.
find_actions versteht Set-Sprache. Er bildet die Wörter, die eine Crew nutzt, auf die Wörter der API ab:
| Du sagst | Er sucht auch |
|---|---|
| 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 (Niederländisch) | generate, estimate |
| mismatch | continuity |
| model, models | models, acceptance, routing |
Neue API-Aktionen erscheinen in find_actions in dem Moment, in dem sie ausgeliefert werden. Ein neues Tool ist
nicht nötig.
Beispiele #
| Um | Suche | Aktion |
|---|---|---|
| Einen Draft zu bepreisen, bevor er rendert | „estimate shot“ | estimateShotGeneration |
| Prompt, Modell und Credits zu sehen, bevor du renderst | „dry run“ | generateForShot mit {"kind": "video", "tier": "draft", "dryRun": true} |
| Einen Draft zu rendern | „generate shot“ | generateForShot mit {"kind": "video", "tier": "draft"} |
| Einen Take zu wählen | „pick take“ | selectTake |
| Aus einem Draft ein Final zu machen | „promote“ | promoteGeneration |
| Einen Retake aus einer Anmerkung zu machen | „revise take“ | estimateReviseTake, dann reviseTake |
| Zu sehen, welches Modell akzeptiert wird | „model acceptance“ | getModelAcceptance |
| Die Kosten einer Folge | „episode costs“ | getEpisodeCosts |
Bevor Claude rendert, ruft er die Generate-Aktion mit dryRun: true auf: Sie zeigt den zusammengesetzten Prompt, das
Modell, die Referenzen und die Credits und erzeugt nichts. Danach kann er den Prompt für genau diesen Render anpassen.
overrides.prompt ersetzt den Prompt-Text (die Referenzzeilen bleiben, Figuren, Motive und Requisiten gehen also immer mit),
overrides.promptAppend hängt etwas an und overrides.negativePrompt ergänzt, was vermieden werden soll. Beim Dialog
werden die Zeilen selbst gesprochen; eine Prompt-Überschreibung nimmt der Dialog nicht an.
Der Dry Run antwortet mit provider und model_key. Gibst du sie als provider und modelKey zurück, bleibt es bei
diesem Modell. getGeneration liest zurück, womit ein Take gemacht wurde: den Prompt, das Modell, die geschätzten
Credits und die gebuchten Credits.
Wenn die API ablehnt #
Eine Ablehnung kommt als Tool-Fehler mit dem Code und den Details der API zurück, zum Beispiel
The API refused: 409 gate_closed: finals render once casting, sets, animatic are signed off {"episode_id": "…", "waiting_on": ["casting", "sets", "animatic"]}.
Claude liest sie und sagt dir, was fehlt. Siehe Fehler, auf die du triffst.
Bewusst ausgelassen #
Claude kann diese nicht erreichen, mit Absicht:
- API-Schlüssel und Claude-Verbindungen: Eine Verbindung legt nie Schlüssel an und lässt keine anderen Verbindungen zu. Das tut eine Person, angemeldet.
- OAuth und Registrierung.
- Webhooks: Sie schicken Daten aus Filmsquare hinaus.
- Callbacks der Anbieter und die Realtime-Sockets (Canvas und Presence).
Das grüne Licht für die Finals, Credit-Prüfungen und Tarif-Limits gelten für Claude genau wie für alle anderen.
Sicherheit #
- Claude handelt als du. Er hat deine Rolle (oder die niedrigere, die du beim Verbinden gewählt hast), und was er tut, erscheint auf deinen Namen.
- Crew-Material sind keine Anweisungen. Kommentare, Drehbücher und anderer Text, den Claude in Filmsquare liest, sind Material der Crew. Filmsquare sagt das Claude: Nur du entscheidest, was er tut.
- Er nennt zuerst den Preis. Takes zu machen kostet Credits. Claude wird angewiesen, die Generate-Aktion mit
dryRun: trueaufzurufen, was nichts erzeugt, und zu sagen, was ein Take kostet, bevor er einen startet, und nie ungefragt Finals zu rendern. - Er nimmt nie ungefragt ab.
sign_offhält eine Entscheidung auf deinen Namen fest. Claude wird angewiesen, es nur zu nutzen, wenn du ihn gebeten hast zu entscheiden.
Prompts #
Vier Prompts tragen eine Arbeitsweise für häufige Aufgaben: break_down_episode, process_feedback, work_on_step
und check_continuity. Siehe Prompts und Arbeitsweise.
Mit Claude
MCPDein eigener Claude macht das über MCP, in deinem Namen und mit deiner Rolle:
find_actionsDurchsucht alles, was die API kann, und liefert die passenden Aktionen mit ihren Eingaben.
Frag: Finde die Aktion, die die Abnahmeregel eines Schritts ändert.
run_actionFührt eine mit find_actions gefundene Aktion aus, als du, mit deiner Rolle und deinen Rechten.
Frag: Wähle den zweiten Take von Einstellung 5 in Folge 2.
whats_waitingZeigt die Schritte, die auf deine Abnahme warten, und deine ungelesenen Benachrichtigungen.
Frag: Was wartet in Filmsquare auf mich?
list_productionsZeigt die Produktionen in deinem Workspace mit ihren Folgen.
Frag: Welche Produktionen und Folgen haben wir in Filmsquare?
get_episodeZeigt die Szenen und Einstellungen einer Folge in Schnittfolge, jeden Gewerk-Schritt und ob Finals rendern können.
Frag: Wo steht Folge 2, und auf wen wartet jeder Schritt?
get_feedbackLiest die Kommentar-Threads zu einer Einstellung, einem Take, einer Folge oder einem Element, mit Timecode oder Bereich jedes Pins.
Frag: Welche Anmerkungen sind in Folge 2 noch offen?
reply_feedbackAntwortet in deinem Namen in einem Kommentar-Thread und erledigt ihn, sobald die Anmerkung abgearbeitet ist.
Frag: Antworte auf die Anmerkung zu Einstellung 4, dass der neue Draft die Blickrichtung behebt, und erledige sie.
view_mediaSchaut sich ein Standbild, Keyframe oder einen Take an; Video kommt als Poster mit Download-Link.
Frag: Zeig mir das gewählte Standbild von Einstellung 3 und sag, ob es zu seinen Referenzen passt.
upload_fileFügt eine Datei als neuen Take zu einer Einstellung oder einer Szene hinzu, oder als Asset der Produktion (höchstens 10 MB).
Frag: Lade dieses Referenzfoto in die Assets der Produktion hoch.
get_scriptLiest die neueste Drehbuchfassung einer Folge, mit den @Handles, die es schon gibt.
Frag: Lies das Drehbuch von Folge 2 und sag mir, welche Figuren noch keinen @Handle haben.
edit_scriptÄndert eine Szene, eine Rede oder eine Zeile im Drehbuch einer Folge und speichert es als neue Version, ohne das ganze Drehbuch zu senden.
Frag: Schreib den Anfang von S02 in Folge 2 so um, wie wir es gerade besprochen haben, und speichere es als neue Version.
submit_breakdownBringt deinen Drehbuchauszug in Filmsquare: Szenen, Einstellungen, Dialoge, Figuren, Motive und Requisiten.
Frag: Mach den Drehbuchauszug zum Drehbuch von Folge 2 und reich ihn ein. Nutze die Handles, die wir schon haben.
get_continuityLegt die gewählten Takes einer Folge nebeneinander, mit den Element-Versionen, die jede Einstellung nutzt.
Frag: Leg die gewählten Takes von Szene S2 für einen Continuity-Check bereit.
report_continuityHält deinen Continuity-Check fest; jede Abweichung wird eine Anmerkung am gewählten Take der Einstellung.
Frag: Prüf die Continuity in Szene S2 und melde die Abweichungen, die du findest.
submit_styleLegt einen Style Guide in deiner Style-Bibliothek ab (Create, Styles): ein neuer Style oder die nächste Version eines bestehenden.
Frag: Sieh dir diese Bilder an, schreib einen Style Guide, zeig ihn mir und reich ihn ein, wenn ich Go sage.
request_signoffBittet die Abnehmenden eines Gewerk-Schritts um Abnahme; sie bekommen eine Benachrichtigung.
Frag: Bitte die Abnehmenden für den nächsten Schritt in Folge 2 um Abnahme, mit einer Anmerkung, was sich geändert hat.
sign_offHält deine Entscheidung zu einem Schritt fest: abgenommen oder Korrekturen angefordert. Nur, wenn du Claude entscheiden lässt.
Frag: Nimm den nächsten Schritt in Folge 2 für mich ab.
where_does_it_goSagt, auf welchen Bildschirm eine Datei gehört: die Karte, ein Entscheidungsbaum und ausgearbeitete Beispiele.
Frag: Wohin gehört dieses Blockout-Reel?
prepare_uploadGibt signierte Upload-Links und fertige curl-Befehle für bis zu 100 Dateien auf der Festplatte.
Frag: Lade die Videos in diesem Ordner hoch.
add_to_visualizeLegt hochgeladene Dateien unter Storyboard ab, 3D oder Animatic, auf Einstellungen und Szenen per Code.
Frag: Leg die Blender-Arbeit unter 3D und die Animatics unter Animatic.
studio_analyticsFür den Owner und Producer: wie es dem Studio geht, aus der Crew, einem Tag, den Kosten oder der Berichtsmail, wie sie verschickt würde.
Frag: Wie lief die Crew letzte Woche, und wer braucht Hilfe?
Claude verbinden 5.1