Filmsquare AiutoDocumentazione

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.

Aggiornato il 7 min di lettura.md

In questa pagina
  1. Gli strumenti con nome
  2. Dove va il materiale
  3. find_actions e run_action
  4. Esempi
  5. Quando l'API rifiuta
  6. Lasciato fuori di proposito
  7. Sicurezza
  8. Prompt

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 #

StrumentoCosa faRichiede
whats_waitingLe fasi dei reparti in attesa della tua approvazione, e le tue notifiche non lette. Il posto da cui partire—
list_productionsLe produzioni dello spazio di lavoro con i loro episodi—
get_episodeUn 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 partireepisode_id
get_feedbackDiscussioni 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 precedentitarget_type, target_id
reply_feedbackRisponde 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 personathread_id, body
view_mediaUno still, un fotogramma chiave o un ciak come immagine che Claude può guardare; un video torna come locandina più un link per scaricarloasset_version_id
upload_fileUn 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_goSu quale schermata va un file: la mappa, un albero di decisione ed esempi svolti. Leggilo quando nomini una schermata—
prepare_uploadURL 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 videofiles
add_to_visualizeMette 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 nullaepisode_id, items
get_scriptL'ultima stesura della sceneggiatura dell'episodio, e gli @handle di cast, set e oggetti di scena che esistono giàepisode_id
edit_scriptCambia 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 essaepisode_id, base_rev, edits
submit_breakdownMette in Filmsquare lo spoglio di Claude: scene, inquadrature con recitazione, dialoghi, cast, set e oggetti di scena. La Sceneggiatura aspetta poi l'approvazioneepisode_id, breakdown
get_continuityLa 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 discendenzaepisode_id
report_continuityRegistra un controllo visivo di continuità; ogni discordanza diventa una nota sul ciak sceltoepisode_id, seen, issues
submit_styleMette 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 makername, guide
request_signoffChiede a chi approva un reparto di approvare la fase di un episodio; riceve una notificaepisode_id, department
sign_offRegistra 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 decidereepisode_id, department, decision
studio_analyticsPer 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 numeriview

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:

HaiVaCon
Render in argilla o still di un'inquadratura, con ottica, altezza e movimentoStoryboard → 3D, sull'inquadraturaadd_to_visualize
Clip Blender di un'inquadratura, un ciak o una scenaStoryboard → 3D, su ciò che copreadd_to_visualize
Animatic di una scena, sequenza o episodioStoryboard → Animaticadd_to_visualize
Video in bozza o finale di un'inquadraturaStoryboard → Shots, come ciakupload_file
Immagine di riferimento o moodboardHome → Filesupload_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.

  1. find_actions cerca 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.
  2. run_action ne esegue una per nome, con path_params (non lo spazio di lavoro), query e body come 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 diciCerca anche
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 (olandese)generate, estimate
mismatchcontinuity
model, modelsmodels, acceptance, routing

Le nuove azioni dell'API compaiono in find_actions nel momento in cui escono. Non serve nessuno strumento nuovo.

Esempi #

PerCercaAzione
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_off registra 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

MCP

Il tuo Claude lo fa via MCP, a tuo nome e con il tuo ruolo:

  • find_actions

    Cerca 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_action

    Esegue 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_waiting

    Elenca le fasi in attesa della tua approvazione e le tue notifiche non lette.

    Chiedi: Cosa mi aspetta in Filmsquare?

  • list_productions

    Elenca le produzioni del tuo spazio di lavoro con i loro episodi.

    Chiedi: Quali produzioni ed episodi abbiamo in Filmsquare?

  • get_episode

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

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

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

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

    Aggiunge 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_script

    Legge 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_script

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

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

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

    Registra 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_style

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

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

    Registra 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_go

    Ti dice su quale schermata va un file: la mappa, un albero di decisione ed esempi svolti.

    Chiedi: Dove va questo showreel di blockout?

  • prepare_upload

    Dà link di caricamento firmati e comandi curl pronti per fino a 100 file sul disco.

    Chiedi: Carica i video di questa cartella.

  • add_to_visualize

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

    Per 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

Questa pagina in Markdown: /docs/it/claude/tools.md