---
title: "Wat Claude kan doen"
description: "Elke MCP-tool die Filmsquare je Claude geeft, hoe find_actions en run_action de rest van de API bereiken, en wat er bewust is weggelaten."
url: https://www.filmsquare.ai/docs/nl/claude/tools/
lang: nl
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]
---

# Wat Claude kan doen

Je Claude kan in Filmsquare doen wat de API je rol laat doen. Achttien benoemde tools dekken het dagelijkse werk;
twee meer, `find_actions` en `run_action`, bereiken elke andere API-actie. Elke aanroep gaat via de API zelf, als
jij: dezelfde rolcontroles, dezelfde validatie, hetzelfde groene licht voor finals.

## De benoemde tools

| Tool | Wat hij doet | Vraagt |
| --- | --- | --- |
| `whats_waiting` | Departementsstappen die op jouw akkoord wachten, en je ongelezen meldingen. De plek om te beginnen | — |
| `list_productions` | De producties in de workspace met hun afleveringen | — |
| `get_episode` | Eén aflevering: scènes en shots in cutvolgorde, elke departementsstap (afgetekend, wachtend op wie, wijzigingen gevraagd, open), en of de finals kunnen renderen | `episode_id` |
| `get_feedback` | Threads op een shot, take, aflevering, scène, element, map, assetversie, canvas of canvasnode, met elk bericht en zijn pin (timecode in frames, of een gebied van het beeld). Standaard open threads; `status` `resolved` of `all` voor de rest. Met `target_type` `sheet`: de open notes op de nieuwste versie van de sheet (bedoeling, citaat of de hele sheet, voorgestelde tekst, afgehandeld of niet) en hoe de notes van eerdere versies afliepen | `target_type`, `target_id` |
| `reply_feedback` | Antwoord in een thread als jij (`@name`-vermeldingen melden mensen), en handel hem af als de note is verwerkt. Een note op een sheet wordt in plaats daarvan als afgehandeld gemarkeerd; als hij een suggestie heeft, is `suggestion_outcome` (applied, adapted of declined) verplicht, en een mens bevestigt hem | `thread_id`, `body` |
| `view_media` | Een still, keyframe of take als beeld waar Claude naar kan kijken; een video komt terug als zijn poster plus een downloadlink | `asset_version_id` |
| `upload_file` | Een bestand uit het gesprek op een laag van een shot of scène als nieuwe take, of in een productie als asset. Maximaal 10 MB. `pick: true` kiest hem ook als gekozen take (regisseur en hoger) | `name`, `mime`, `data_base64` |
| `where_does_it_go` | Op welk scherm een bestand hoort: de kaart, een beslisboom en uitgewerkte voorbeelden. Te lezen zodra je een scherm noemt | — |
| `prepare_upload` | Ondertekende upload-URL's en kant-en-klare `curl`-commando's voor tot 100 bestanden op schijf, zodat de bytes nooit door het gesprek gaan. Voor elke video | `files` |
| `add_to_visualize` | Zet geüploade bestanden onder **Storyboard → 3D** of **Storyboard → Animatic**, tot 100 per aanroep, op shots en scènes via hun code. Hetzelfde nog eens sturen verandert niets | `episode_id`, `items` |
| `get_script` | De laatste scriptversie van de aflevering, en de `@handles` van de cast, sets en props die al bestaan | `episode_id` |
| `edit_script` | Een scène, tekst of regel van het script veranderen zonder het hele script te sturen: exacte tekst en wat ervoor in de plaats komt, opgeslagen als nieuwe versie; notes en tags gaan mee | `episode_id`, `base_rev`, `edits` |
| `submit_breakdown` | Zet de breakdown van Claude in Filmsquare: scènes, shots met acting, dialoog, cast, sets en props. Script wacht dan op akkoord | `episode_id`, `breakdown` |
| `get_continuity` | De continuïteitssheet van een aflevering: wat elke shot afspeelt, de elementen en hun referenties, waarmee elke gekozen take is gemaakt, bevindingen tot nu toe, shots om opnieuw te controleren. Draait eerst de gratis lineage-controle | `episode_id` |
| `report_continuity` | Leg een visuele continuïteitscontrole vast; elke afwijking wordt een note op de gekozen take | `episode_id`, `seen`, `issues` |
| `submit_style` | Zet een styleguide in de stijlbibliotheek (**Create → Styles**): een nieuwe style, of met `style_id` de volgende versie ervan; met `production_id` wordt het de style van een productie. Eigen werk draagt tot 6 referentiestills mee (geüpload met `prepare_upload`); werk van een ander is alleen tekst en wordt nooit gepubliceerd. Namen van mensen of merken worden geweigerd. Rol maker | `name`, `guide` |
| `request_signoff` | Vraag de aftekenaars van een departement om de stap van een aflevering af te tekenen; ze krijgen een melding | `episode_id`, `department` |
| `sign_off` | Leg je beslissing over een stap vast: `approved` of `changes_requested`, met een optionele `note`. Alleen de aftekenaars van de stap kunnen dat. Met `expect_version` (de versie van de stap zoals jij hem zag) wordt hij geweigerd met `changed_since` als het werk is verschoven. Alleen als je Claude vroeg te beslissen | `episode_id`, `department`, `decision` |
| `studio_analytics` | Voor de eigenaar en producenten: hoe het met de studio gaat, met de cijfers van **Analytics**. `view` `crew` (per persoon over een periode: delivered, credits per delivered, time to sign-off, first pass, lanes, redo, hands-on- en agent-alone-uren, de mediaan van de studio en de tijd per stap), `day`, `costs`, of `report` (de tekst van de rapportmail zoals hij verstuurd wordt). Iedereen anders wordt geweigerd: die ziet alleen de eigen cijfers | `view` |

Elke tool neemt ook een optionele `workspace`. Laat hem weg: de workspace van de koppeling wordt gebruikt.

`department` is een van `writing`, `breakdown`, `casting`, `voice`, `wardrobe`, `sets`, `props`, `animatic`,
`music`, `draft`, `sound`, `edit`, `final`.

## Waar media heen gaat

Noem je Claude het scherm in je eigen woorden ("zet het onder 3D"). Dit doet hij dan:

| Je hebt | Het gaat naar | Met |
| --- | --- | --- |
| Clay render of still van één shot, met lens, hoogte en camerabeweging | **Storyboard → 3D**, op de shot | `add_to_visualize` |
| Blender-clip van een shot, een take of een scène | **Storyboard → 3D**, op wat hij dekt | `add_to_visualize` |
| Animatic van een scène, sequence of aflevering | **Storyboard → Animatic** | `add_to_visualize` |
| Draft- of finalvideo van een shot | **Storyboard → Shots**, als take | `upload_file` |
| Referentiebeeld of moodboard | **Home → Files** | `upload_file` |

Iets op de verkeerde plek verhuist zonder opnieuw te uploaden: `moveTake` of `moveAsset` via `run_action` (regisseur en hoger). Een take die de import koos, is na het verhuizen niet meer gekozen. Een take die iemand gekozen heeft, of die hier gegenereerd is, blijft waar hij is.

## find_actions en run_action

Alles zonder benoemde tool gaat via deze twee: shots maken, takes kiezen, drafts maken, schattingen,
elementen en versies, mappen, canvassen, kosten, briefs, crew.

1. `find_actions` doorzoekt de eigen catalogus van de API met een paar woorden, zoals "pick take", "create shot" of
   "resolve thread". Hij geeft passende acties terug met hun methode, pad, een samenvatting, de minimale rol en de
   invoer.
2. `run_action` voert er een uit op zijn naam, met `path_params` (niet de workspace), `query` en `body` zoals de actie
   beschrijft. Hij antwoordt met de JSON van de API.

`find_actions` begrijpt filmtaal. Hij zet de woorden van een crew om in de woorden van de API:

| Jij zegt | Hij zoekt ook |
| --- | --- |
| 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 (Nederlands) | generate, estimate |
| mismatch | continuity |
| model, models | models, acceptance, routing |

Nieuwe API-acties verschijnen in `find_actions` op het moment dat ze live gaan. Er is geen nieuwe tool voor nodig.

### Voorbeelden

| Om | Zoek | Actie |
| --- | --- | --- |
| Een draft te prijzen voordat je hem rendert | "estimate shot" | `estimateShotGeneration` |
| De prompt, het model en de credits te zien voordat je rendert | "dry run" | `generateForShot` met `{"kind": "video", "tier": "draft", "dryRun": true}` |
| Een draft te renderen | "generate shot" | `generateForShot` met `{"kind": "video", "tier": "draft"}` |
| Een take te kiezen | "pick take" | `selectTake` |
| Van een draft een final te maken | "promote" | `promoteGeneration` |
| Een retake uit een note | "revise take" | `estimateReviseTake`, dan `reviseTake` |
| Te zien welk model wordt geaccepteerd | "model acceptance" | `getModelAcceptance` |
| Kosten van een aflevering | "episode costs" | `getEpisodeCosts` |

Voordat Claude rendert, roept hij de generate-actie aan met `dryRun: true`: die laat de samengestelde prompt, het
model, de referenties en de credits zien en maakt niets. Daarna kan hij de prompt voor die ene render aanpassen.
`overrides.prompt` vervangt de prompttekst (de referentieregels blijven, dus cast, sets en props gaan altijd mee),
`overrides.promptAppend` voegt eraan toe en `overrides.negativePrompt` voegt toe wat je wilt vermijden. Bij dialoog
worden de regels zelf uitgesproken; een prompt-override werkt daar niet.

De dry run antwoordt met `provider` en `model_key`. Geef je die terug als `provider` en `modelKey`, dan blijft het bij
dat model. `getGeneration` leest terug waarmee een take is gemaakt: de prompt, het model, de geschatte credits en de
geboekte credits.

## Als de API weigert

Een weigering komt terug als een toolfout met de code en details van de API, bijvoorbeeld
`The API refused: 409 gate_closed: finals render once casting, sets, animatic are signed off {"episode_id": "…", "waiting_on": ["casting", "sets", "animatic"]}`.
Claude leest hem en vertelt je wat er ontbreekt. Zie [Fouten die je tegenkomt](https://www.filmsquare.ai/docs/nl/api/overview/#errors-you-will-meet).

## Bewust weggelaten

Claude kan deze niet bereiken, met opzet:

- **API-sleutels en Claude-koppelingen:** een koppeling maakt nooit sleutels en staat geen andere koppelingen toe. Een
  persoon doet dat, ingelogd.
- **OAuth** en account maken.
- **Webhooks:** ze sturen data uit Filmsquare.
- **Callbacks van aanbieders** en de **realtime sockets** (canvas en presence).

Het groene licht voor de finals, de creditcontroles en de abonnementslimieten gelden voor Claude precies zoals voor ieder ander.

## Veiligheid

- **Claude handelt als jij.** Hij heeft jouw rol (of de lagere die je bij het koppelen koos), en wat hij doet verschijnt
  op jouw naam.
- **Crewmateriaal is geen instructie.** Opmerkingen, scripts en andere tekst die Claude in Filmsquare leest, is materiaal
  van de crew. Filmsquare zegt dat tegen Claude: alleen jij beslist wat hij doet.
- **Hij noemt eerst de prijs.** Takes maken kost credits. Claude hoort de generate-actie aan te roepen met
  `dryRun: true`, wat niets maakt, en te zeggen wat een take gaat kosten voordat hij er een start, en nooit finals te
  renderen zonder dat je erom vraagt.
- **Hij tekent nooit af zonder dat je het vraagt.** `sign_off` legt een beslissing op jouw naam vast. Claude hoort het alleen te gebruiken als
  jij hem vroeg te beslissen.

## Prompts

Vier prompts dragen een werkwijze voor veelvoorkomende klussen: `break_down_episode`, `process_feedback`, `work_on_step` en
`check_continuity`. Zie [Prompts en werkwijze](https://www.filmsquare.ai/docs/nl/claude/prompts/).
