---
title: "Was Claude kann"
description: "Jedes MCP-Tool, das Filmsquare deinem Claude gibt, wie find_actions und run_action den Rest der API erreichen, und was bewusst fehlt."
url: https://www.filmsquare.ai/docs/de/claude/tools/
lang: de
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]
---

# Was Claude kann

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.

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

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