---
title: "Cosa può fare Claude"
description: "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."
url: https://www.filmsquare.ai/docs/it/claude/tools/
lang: it
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]
---

# Cosa può fare Claude

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.

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

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