Filmsquare HelpDocs

5.0 Werken met je eigen Claude5.2 Wat Claude kan doen

Wat Claude kan doen

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.

Bijgewerkt 7 min lezen.md

Op deze pagina
  1. De benoemde tools
  2. Waar media heen gaat
  3. find_actions en run_action
  4. Voorbeelden
  5. Als de API weigert
  6. Bewust weggelaten
  7. Veiligheid
  8. Prompts

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 #

ToolWat hij doetVraagt
whats_waitingDepartementsstappen die op jouw akkoord wachten, en je ongelezen meldingen. De plek om te beginnen—
list_productionsDe producties in de workspace met hun afleveringen—
get_episodeEén aflevering: scènes en shots in cutvolgorde, elke departementsstap (afgetekend, wachtend op wie, wijzigingen gevraagd, open), en of de finals kunnen renderenepisode_id
get_feedbackThreads 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 afliepentarget_type, target_id
reply_feedbackAntwoord 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 hemthread_id, body
view_mediaEen still, keyframe of take als beeld waar Claude naar kan kijken; een video komt terug als zijn poster plus een downloadlinkasset_version_id
upload_fileEen 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_goOp welk scherm een bestand hoort: de kaart, een beslisboom en uitgewerkte voorbeelden. Te lezen zodra je een scherm noemt—
prepare_uploadOndertekende 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 videofiles
add_to_visualizeZet 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 nietsepisode_id, items
get_scriptDe laatste scriptversie van de aflevering, en de @handles van de cast, sets en props die al bestaanepisode_id
edit_scriptEen 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 meeepisode_id, base_rev, edits
submit_breakdownZet de breakdown van Claude in Filmsquare: scènes, shots met acting, dialoog, cast, sets en props. Script wacht dan op akkoordepisode_id, breakdown
get_continuityDe 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-controleepisode_id
report_continuityLeg een visuele continuïteitscontrole vast; elke afwijking wordt een note op de gekozen takeepisode_id, seen, issues
submit_styleZet 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 makername, guide
request_signoffVraag de aftekenaars van een departement om de stap van een aflevering af te tekenen; ze krijgen een meldingepisode_id, department
sign_offLeg 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 beslissenepisode_id, department, decision
studio_analyticsVoor 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 cijfersview

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 hebtHet gaat naarMet
Clay render of still van één shot, met lens, hoogte en camerabewegingStoryboard → 3D, op de shotadd_to_visualize
Blender-clip van een shot, een take of een scèneStoryboard → 3D, op wat hij dektadd_to_visualize
Animatic van een scène, sequence of afleveringStoryboard → Animaticadd_to_visualize
Draft- of finalvideo van een shotStoryboard → Shots, als takeupload_file
Referentiebeeld of moodboardHome → Filesupload_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 zegtHij zoekt ook
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 (Nederlands)generate, estimate
mismatchcontinuity
model, modelsmodels, acceptance, routing

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

Voorbeelden #

OmZoekActie
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.

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.

Met Claude

MCP

Je eigen Claude doet dit via MCP, op jouw naam en met jouw rol:

  • find_actions

    Doorzoekt alles wat de API kan en geeft de passende acties met hun invoer.

    Vraag: Zoek de actie die de aftekenregel van een stap wijzigt.

  • run_action

    Voert één actie uit die find_actions vond, als jij, met jouw rol en rechten.

    Vraag: Kies de tweede take van shot 5 op aflevering 2.

  • whats_waiting

    Toont de stappen die op jouw akkoord wachten en je ongelezen meldingen.

    Vraag: Wat wacht er in Filmsquare op mij?

  • list_productions

    Toont de producties in je workspace met hun afleveringen.

    Vraag: Welke producties en afleveringen hebben we in Filmsquare?

  • get_episode

    Toont de scènes en shots van een aflevering in montagevolgorde, elke departementsstap, en of finals kunnen renderen.

    Vraag: Hoe staat aflevering 2 ervoor, en op wie wacht elke stap?

  • get_feedback

    Leest de commentaarthreads op een shot, take, aflevering of element, met de timecode of het gebied van elke pin.

    Vraag: Welke notes staan er nog open op aflevering 2?

  • reply_feedback

    Antwoordt in een commentaarthread op jouw naam, en handelt hem af als de note is verwerkt.

    Vraag: Antwoord op de note bij shot 4 dat de nieuwe draft de kijkrichting oplost, en handel hem af.

  • view_media

    Bekijkt een still, keyframe of take; video komt terug als poster met een downloadlink.

    Vraag: Laat de gekozen still van shot 3 zien en zeg of hij klopt met zijn referenties.

  • upload_file

    Voegt een bestand toe als nieuwe take op een shot of scène, of als asset van de productie (hooguit 10 MB).

    Vraag: Upload deze referentiefoto naar de assets van de productie.

  • get_script

    Leest de laatste scriptversie van een aflevering, met de @handles die al bestaan.

    Vraag: Lees het script van aflevering 2 en zeg welke personages nog geen @handle hebben.

  • edit_script

    Verandert een scène, tekst of regel in het script van een aflevering en slaat het op als nieuwe versie, zonder het hele script te sturen.

    Vraag: Herschrijf de opening van S02 in aflevering 2 zoals we net bespraken, en sla het op als nieuwe versie.

  • submit_breakdown

    Zet je breakdown in Filmsquare: scènes, shots, dialoog, cast, sets en props.

    Vraag: Maak de breakdown van het script van aflevering 2 en dien hem in. Gebruik de handles die we al hebben.

  • get_continuity

    Legt de gekozen takes van een aflevering naast elkaar, met de elementversies die elk shot gebruikt.

    Vraag: Leg de picks van scène S2 klaar voor een continuïteitscheck.

  • report_continuity

    Legt de continuïteitscheck vast; elke afwijking wordt een note op de gekozen take van het shot.

    Vraag: Check de continuïteit in scène S2 en meld de afwijkingen die je vindt.

  • submit_style

    Zet een style guide in je stijlbibliotheek (Create, Styles): een nieuwe style of de volgende versie van een bestaande.

    Vraag: Kijk naar deze beelden, schrijf een style guide, laat hem aan me zien en dien hem in als ik go zeg.

  • request_signoff

    Vraagt de aftekenaars van een departementsstap om af te tekenen; zij krijgen een melding.

    Vraag: Vraag de aftekenaars van de volgende stap op aflevering 2 om af te tekenen, met een note over wat er veranderd is.

  • sign_off

    Legt jouw besluit over een stap vast: afgetekend of wijzigingen gevraagd. Alleen als je Claude laat beslissen.

    Vraag: Teken de volgende stap van aflevering 2 voor mij af.

  • where_does_it_go

    Zegt op welk scherm een bestand hoort: de kaart, een beslisboom en uitgewerkte voorbeelden.

    Vraag: Waar hoort dit blockout-reel?

  • prepare_upload

    Geeft ondertekende uploadlinks en kant-en-klare curl-commando's voor tot 100 bestanden op schijf.

    Vraag: Upload de video's in deze map.

  • add_to_visualize

    Zet geüploade bestanden onder Storyboard, 3D of Animatic, op shots en scènes via hun code.

    Vraag: Zet het Blender-werk onder 3D en de animatics onder Animatic.

  • studio_analytics

    Voor de owner en producers: hoe het met de studio gaat, uit de crew, één dag, de kosten of de rapportmail zoals hij verstuurd wordt.

    Vraag: Hoe deed de crew het vorige week, en wie heeft hulp nodig?

Claude koppelen 5.1

Deze pagina als Markdown: /docs/nl/claude/tools.md