Filmsquare HilfeDocs

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.

Aktualisiert 7 Min. Lesezeit.md

Auf dieser Seite
  1. Die benannten Tools
  2. Wohin Medien gehören
  3. find_actions und run_action
  4. Beispiele
  5. Wenn die API ablehnt
  6. Bewusst ausgelassen
  7. Sicherheit
  8. Prompts

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 #

ToolWas es tutBraucht
whats_waitingSchritte, die auf deine Abnahme warten, und deine ungelesenen Benachrichtigungen. Der Ort zum Starten—
list_productionsDie Produktionen im Workspace mit ihren Folgen—
get_episodeEine Folge: Szenen und Einstellungen in Schnittreihenfolge, jeder Gewerk-Schritt (abgenommen, auf wen er wartet, Korrekturen verlangt, offen) und ob die Finals rendern könnenepisode_id
get_feedbackKommentar-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 ausgingentarget_type, target_id
reply_feedbackAntworte 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 siethread_id, body
view_mediaEin Standbild, Keyframe oder Take als Bild, das Claude ansehen kann; ein Video kommt als Posterbild plus Download-Link zurückasset_version_id
upload_fileEine 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_goAuf welchen Bildschirm eine Datei gehört: die Karte, ein Entscheidungsbaum und ausgearbeitete Beispiele. Zu lesen, sobald du einen Bildschirm nennst—
prepare_uploadSignierte 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 Videofiles
add_to_visualizeLegt 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 nichtsepisode_id, items
get_scriptDie neueste Drehbuchfassung der Folge und die @handles der Figuren, Motive und Requisiten, die es schon gibtepisode_id
edit_scriptEine 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 mitepisode_id, base_rev, edits
submit_breakdownDen Drehbuchauszug von Claude in Filmsquare bringen: Szenen, Einstellungen mit Spiel, Dialog, Figuren, Motive und Requisiten. Das Drehbuch wartet dann auf Abnahmeepisode_id, breakdown
get_continuityDas 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 ausepisode_id
report_continuityEinen visuellen Continuity-Check festhalten; jede Abweichung wird zu einer Anmerkung am gewählten Takeepisode_id, seen, issues
submit_styleEinen 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 Makername, guide
request_signoffDie Abnehmenden eines Gewerks bitten, den Schritt einer Folge abzunehmen; sie bekommen eine Benachrichtigungepisode_id, department
sign_offDeine 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 entscheidenepisode_id, department, decision
studio_analyticsFü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 Zahlenview

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 hastEs geht nachMit
Clay-Render oder Standbild einer Einstellung, mit Objektiv, Höhe und BewegungStoryboard → 3D, auf die Einstellungadd_to_visualize
Blender-Clip einer Einstellung, eines Takes oder einer SzeneStoryboard → 3D, auf das, was er abdecktadd_to_visualize
Animatic einer Szene, Sequenz oder FolgeStoryboard → Animaticadd_to_visualize
Draft- oder Final-Video einer EinstellungStoryboard → Shots, als Takeupload_file
Referenzbild oder MoodboardHome → Filesupload_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.

  1. find_actions durchsucht 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.
  2. run_action führt eine über ihren Namen aus, mit path_params (nicht der Workspace), query und body, 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 sagstEr sucht auch
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 (Niederländisch)generate, estimate
mismatchcontinuity
model, modelsmodels, 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 #

UmSucheAktion
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: true aufzurufen, 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_off hä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

MCP

Dein eigener Claude macht das über MCP, in deinem Namen und mit deiner Rolle:

  • find_actions

    Durchsucht alles, was die API kann, und liefert die passenden Aktionen mit ihren Eingaben.

    Frag: Finde die Aktion, die die Abnahmeregel eines Schritts ändert.

  • run_action

    Fü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_waiting

    Zeigt die Schritte, die auf deine Abnahme warten, und deine ungelesenen Benachrichtigungen.

    Frag: Was wartet in Filmsquare auf mich?

  • list_productions

    Zeigt die Produktionen in deinem Workspace mit ihren Folgen.

    Frag: Welche Produktionen und Folgen haben wir in Filmsquare?

  • get_episode

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

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

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

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

    Fü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_script

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

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

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

    Hä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_style

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

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

    Hä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_go

    Sagt, auf welchen Bildschirm eine Datei gehört: die Karte, ein Entscheidungsbaum und ausgearbeitete Beispiele.

    Frag: Wohin gehört dieses Blockout-Reel?

  • prepare_upload

    Gibt 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_visualize

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

    Fü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

Diese Seite als Markdown: /docs/de/claude/tools.md