5.0 Lavora con il tuo Claude5.2 Cosa può fare Claude
Cosa può fare Claude
Ogni strumento MCP che Filmsquare dà al tuo Claude, come find_actions e run_action raggiungono il resto dell'API, e cosa è lasciato fuori di proposito.
Il tuo Claude può fare in Filmsquare ciò che l'API permette al tuo ruolo. Diciotto strumenti con nome coprono il
lavoro di tutti i giorni; altri due, find_actions e run_action, raggiungono ogni altra azione dell'API. Ogni
chiamata passa per l'API stessa, a tuo nome: gli stessi controlli di ruolo, la stessa validazione, gli stessi via
libera.
Gli strumenti con nome #
| Strumento | Cosa fa | Richiede |
|---|---|---|
whats_waiting | Le fasi dei reparti in attesa della tua approvazione, e le tue notifiche non lette. Il posto da cui partire | — |
list_productions | Le produzioni dello spazio di lavoro con i loro episodi | — |
get_episode | Un episodio: scene e inquadrature in ordine di montaggio, ogni fase dei reparti (approvata, in attesa di chi, modifiche richieste, da fare), e se le finali possono partire | episode_id |
get_feedback | Discussioni di commento su un'inquadratura, ciak, episodio, scena, elemento, cartella, versione di asset, canvas o nodo del canvas, con ogni messaggio e il suo pin (timecode in fotogrammi, o una zona dell'immagine). Di default le discussioni aperte; status resolved o all per le altre. Con target_type sheet: le note aperte sull'ultima versione della scheda (intento, citazione o tutta la scheda, testo suggerito, gestita o no) e come sono finite le note delle versioni precedenti | target_type, target_id |
reply_feedback | Risponde in una discussione come te (le menzioni @nome notificano le persone), e la risolve quando la nota è gestita. Una nota su una scheda viene invece segnata come gestita; quando ha un suggerimento, serve suggestion_outcome (applicato, adattato o rifiutato), e lo conferma una persona | thread_id, body |
view_media | Uno still, un fotogramma chiave o un ciak come immagine che Claude può guardare; un video torna come locandina più un link per scaricarlo | asset_version_id |
upload_file | Un file dalla conversazione su un livello di un'inquadratura o di una scena come nuovo ciak, o in una produzione come asset. Al massimo 10 MB. pick: true lo sceglie anche (regista e superiori) | name, mime, data_base64 |
where_does_it_go | Su quale schermata va un file: la mappa, un albero di decisione ed esempi svolti. Leggilo quando nomini una schermata | — |
prepare_upload | URL di caricamento firmati e comandi curl pronti per fino a 100 file sul disco, così i byte non passano mai per la conversazione. Usalo per ogni video | files |
add_to_visualize | Mette i file caricati sotto Storyboard → 3D o Storyboard → Animatic, fino a 100 per chiamata, su inquadrature e scene per numero. Rimandare lo stesso non cambia nulla | episode_id, items |
get_script | L'ultima stesura della sceneggiatura dell'episodio, e gli @handle di cast, set e oggetti di scena che esistono già | episode_id |
edit_script | Cambia una scena, una battuta o una riga della sceneggiatura senza mandarla tutta: il testo esatto e ciò che lo sostituisce, salvato come nuova versione; note e tag passano con essa | episode_id, base_rev, edits |
submit_breakdown | Mette in Filmsquare lo spoglio di Claude: scene, inquadrature con recitazione, dialoghi, cast, set e oggetti di scena. La Sceneggiatura aspetta poi l'approvazione | episode_id, breakdown |
get_continuity | La scheda di continuità di un episodio: cosa riproduce ogni inquadratura, gli elementi e i loro riferimenti, con cosa è stato fatto ogni ciak scelto, le segnalazioni finora, le inquadrature da ricontrollare. Esegue prima il controllo gratuito della discendenza | episode_id |
report_continuity | Registra un controllo visivo di continuità; ogni discordanza diventa una nota sul ciak scelto | episode_id, seen, issues |
submit_style | Mette una guida di stile nella libreria degli stili (Create → Styles): uno stile nuovo, o con style_id la sua versione successiva; production_id ne fa lo stile di una produzione. Il lavoro proprio porta fino a 6 still di riferimento (caricati con prepare_upload); il lavoro di qualcun altro è solo testo e non viene mai pubblicato. I nomi di persone o di marchi vengono rifiutati. Ruolo di maker | name, guide |
request_signoff | Chiede a chi approva un reparto di approvare la fase di un episodio; riceve una notifica | episode_id, department |
sign_off | Registra la tua decisione su una fase: approved o changes_requested, con una note facoltativa. Solo chi approva la fase può. Con expect_version (la versione della fase come l'hai vista) viene rifiutato con changed_since quando il lavoro si è mosso. Solo quando hai chiesto a Claude di decidere | episode_id, department, decision |
studio_analytics | Per il proprietario e i produttori: come va lo studio, con i numeri di Analytics. view crew (per persona in un periodo: consegnato, crediti per consegna, tempo all'approvazione, primo passaggio, corsie, rifacimenti, ore con le mani sul lavoro e ore dell'agente da solo, la mediana dello studio e il tempo per fase), day, costs, o report (il testo della mail del report come verrebbe inviata). Chiunque altro viene rifiutato: vede solo i propri numeri | view |
Ogni strumento accetta anche un workspace facoltativo. Lascialo fuori: si usa lo spazio di lavoro della
connessione.
department è uno tra writing, breakdown, casting, voice, wardrobe, sets, props, animatic,
music, draft, sound, edit, final.
Dove va il materiale #
Di' al tuo Claude la schermata con parole tue («mettilo sotto 3D»). Questo è ciò che fa:
| Hai | Va | Con |
|---|---|---|
| Render in argilla o still di un'inquadratura, con ottica, altezza e movimento | Storyboard → 3D, sull'inquadratura | add_to_visualize |
| Clip Blender di un'inquadratura, un ciak o una scena | Storyboard → 3D, su ciò che copre | add_to_visualize |
| Animatic di una scena, sequenza o episodio | Storyboard → Animatic | add_to_visualize |
| Video in bozza o finale di un'inquadratura | Storyboard → Shots, come ciak | upload_file |
| Immagine di riferimento o moodboard | Home → Files | upload_file |
Qualcosa nel posto sbagliato si sposta senza ricaricarlo: moveTake o moveAsset tramite run_action (regista e
superiori). Una scelta fatta dall'importazione viene cancellata con lo spostamento. Un ciak che qualcuno ha scelto,
o che è stato generato qui, resta dov'è.
find_actions e run_action #
Tutto ciò che non ha uno strumento con nome passa da questi due: creare inquadrature, scegliere ciak, fare bozze, stime, elementi e versioni, cartelle, canvas, costi, brief, troupe.
find_actionscerca nel catalogo dell'API stessa con poche parole, come «pick take», «create shot» o «resolve thread». Restituisce le azioni corrispondenti con il loro metodo, percorso, un riassunto, il ruolo minimo e gli input.run_actionne esegue una per nome, conpath_params(non lo spazio di lavoro),queryebodycome descrive l'azione. Risponde con il JSON dell'API.
find_actions capisce il linguaggio del set. Mappa le parole che usa una troupe sulle parole dell'API:
| Tu dici | Cerca anche |
|---|---|
| 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 (olandese) | generate, estimate |
| mismatch | continuity |
| model, models | models, acceptance, routing |
Le nuove azioni dell'API compaiono in find_actions nel momento in cui escono. Non serve nessuno strumento nuovo.
Esempi #
| Per | Cerca | Azione |
|---|---|---|
| Dare un prezzo a una bozza prima di renderizzarla | "estimate shot" | estimateShotGeneration |
| Vedere il prompt, il modello e i crediti prima di renderizzare | "dry run" | generateForShot con {"kind": "video", "tier": "draft", "dryRun": true} |
| Renderizzare una bozza | "generate shot" | generateForShot con {"kind": "video", "tier": "draft"} |
| Scegliere un ciak | "pick take" | selectTake |
| Rendere finale una bozza | "promote" | promoteGeneration |
| Nuovo ciak da una nota | "revise take" | estimateReviseTake, poi reviseTake |
| Vedere quale modello viene approvato | "model acceptance" | getModelAcceptance |
| Costo di un episodio | "episode costs" | getEpisodeCosts |
Prima di renderizzare, Claude chiama l'azione di generazione con dryRun: true: mostra il prompt compilato, il
modello, i riferimenti e i crediti, e non crea nulla. Può poi cambiare il prompt per quel solo render.
overrides.prompt sostituisce il testo del prompt (le righe dei riferimenti restano, così cast, set e oggetti di
scena vanno sempre con esso), overrides.promptAppend vi aggiunge, e overrides.negativePrompt aggiunge ciò da
evitare. Il dialogo viene parlato dalle sue battute e non accetta override del prompt.
La prova a vuoto risponde con provider e model_key. Rimandandoli indietro come provider e modelKey si tiene
quel modello. getGeneration rilegge con cosa è stato fatto un ciak: il prompt, il modello, i crediti stimati e i
crediti registrati.
Quando l'API rifiuta #
Un rifiuto torna come errore dello strumento con il codice e i dettagli dell'API, per esempio
The API refused: 409 gate_closed: finals render once casting, sets, animatic are signed off {"episode_id": "…", "waiting_on": ["casting", "sets", "animatic"]}.
Claude lo legge e ti dice cosa manca. Vedi Errori che incontrerai.
Lasciato fuori di proposito #
Claude non può raggiungere queste cose, per scelta:
- Chiavi API e connessioni Claude: una connessione non crea mai chiavi né autorizza altre connessioni. Lo fa una persona, con l'accesso effettuato.
- OAuth e registrazione.
- Webhook: mandano dati fuori da Filmsquare.
- Callback dei fornitori e i socket realtime (canvas e presenza).
Il via libera alle finali, i controlli sui crediti e i limiti del piano valgono per Claude esattamente come per chiunque.
Sicurezza #
- Claude agisce come te. Ha il tuo ruolo (o quello più basso che hai scelto collegandolo), e ciò che fa compare a tuo nome.
- Il materiale della troupe non sono istruzioni. Commenti, sceneggiature e altro testo che Claude legge in Filmsquare sono materiale della troupe. Filmsquare lo dice a Claude: solo tu decidi cosa fa.
- Indica prima il prezzo. Fare ciak costa crediti. A Claude è detto di chiamare l'azione di generazione con
dryRun: true, che non crea nulla, e di dire quanto costerà un ciak prima di avviarne uno, e di non renderizzare mai finali se non richiesto. - Non approva mai se non richiesto.
sign_offregistra una decisione a tuo nome. A Claude è detto di usarlo solo quando gli hai chiesto di decidere.
Prompt #
Quattro prompt portano un metodo di lavoro per i compiti comuni: break_down_episode, process_feedback,
work_on_step e check_continuity. Vedi Prompt e metodo di lavoro.
Con Claude
MCPIl tuo Claude lo fa via MCP, a tuo nome e con il tuo ruolo:
find_actionsCerca tutto ciò che l'API sa fare e restituisce le azioni corrispondenti con i loro input.
Chiedi: Trova l'azione che cambia la regola di approvazione di una fase.
run_actionEsegue un'azione trovata con find_actions, come te, con il tuo ruolo e i tuoi diritti.
Chiedi: Scegli il secondo ciak dell'inquadratura 5 sull'episodio 2.
whats_waitingElenca le fasi in attesa della tua approvazione e le tue notifiche non lette.
Chiedi: Cosa mi aspetta in Filmsquare?
list_productionsElenca le produzioni del tuo spazio di lavoro con i loro episodi.
Chiedi: Quali produzioni ed episodi abbiamo in Filmsquare?
get_episodeMostra scene e inquadrature di un episodio in ordine di montaggio, ogni fase dei reparti e se le finali possono partire.
Chiedi: A che punto è l'episodio 2, e chi aspetta ogni fase?
get_feedbackLegge le discussioni di commento su un'inquadratura, ciak, episodio o elemento, con il timecode o la zona di ogni pin.
Chiedi: Quali note sono ancora aperte sull'episodio 2?
reply_feedbackRisponde in una discussione come te, e la risolve quando la nota è gestita.
Chiedi: Rispondi alla nota sull'inquadratura 4 che la nuova bozza sistema lo sguardo, e risolvila.
view_mediaGuarda uno still, un fotogramma chiave o un ciak; il video torna come locandina più un link per scaricarlo.
Chiedi: Mostrami lo still scelto dell'inquadratura 3 e dimmi se corrisponde ai suoi riferimenti.
upload_fileAggiunge un file che hai come nuovo ciak su un'inquadratura o una scena, o come asset della produzione (10 MB al massimo).
Chiedi: Carica questa foto di riferimento negli asset della produzione.
get_scriptLegge l'ultima stesura della sceneggiatura di un episodio, con gli @handle che esistono già.
Chiedi: Leggi la sceneggiatura dell'episodio 2 e dimmi quali personaggi non hanno ancora un @handle.
edit_scriptCambia una scena, una battuta o una riga della sceneggiatura di un episodio e la salva come nuova versione, senza mandarla tutta.
Chiedi: Riscrivi l'apertura di S02 nell'episodio 2 come abbiamo appena discusso, e salvala come nuova versione.
submit_breakdownMette il tuo spoglio in Filmsquare: scene, inquadrature, dialoghi, cast, set e oggetti di scena.
Chiedi: Fai lo spoglio della sceneggiatura dell'episodio 2 e consegnalo. Riusa gli handle che abbiamo già.
get_continuityAffianca le inquadrature scelte di un episodio, con le versioni degli elementi che ciascuna usa.
Chiedi: Disponi i ciak scelti della scena S2 per un controllo di continuità.
report_continuityRegistra il controllo di continuità che hai fatto; ogni discordanza diventa una nota sul ciak scelto dell'inquadratura.
Chiedi: Controlla la continuità nella scena S2 e segnala le discordanze che trovi.
submit_styleMette una guida di stile nella tua libreria degli stili (Create, Styles): uno stile nuovo o la versione successiva di uno esistente.
Chiedi: Guarda questi still, scrivi una guida di stile, mostramela e inviala quando dico via.
request_signoffChiede a chi approva una fase di un reparto di approvare; riceve una notifica.
Chiedi: Chiedi a chi approva la fase successiva sull'episodio 2 di approvare, con una nota su cosa è cambiato.
sign_offRegistra la tua decisione su una fase: approvata o modifiche richieste. Solo quando gli chiedi di decidere.
Chiedi: Approva la fase successiva sull'episodio 2 per me.
where_does_it_goTi dice su quale schermata va un file: la mappa, un albero di decisione ed esempi svolti.
Chiedi: Dove va questo showreel di blockout?
prepare_uploadDà link di caricamento firmati e comandi curl pronti per fino a 100 file sul disco.
Chiedi: Carica i video di questa cartella.
add_to_visualizeMette i file caricati sotto Storyboard, 3D o Animatic, su inquadrature e scene per numero.
Chiedi: Metti il lavoro di Blender sotto 3D e gli animatic sotto Animatic.
studio_analyticsPer il proprietario e i produttori: come va lo studio, dalla troupe, un giorno, i costi o la mail del report come verrebbe inviata.
Chiedi: Come è andata la troupe la settimana scorsa, e chi ha bisogno di aiuto?
Collega Claude 5.1