---
title: "Ce que Claude peut faire"
description: "Chaque outil MCP que Filmsquare donne à votre Claude, comment find_actions et run_action atteignent le reste de l'API, et ce qui est laissé de côté volontairement."
url: https://www.filmsquare.ai/docs/fr/claude/tools/
lang: fr
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]
---

# Ce que Claude peut faire

Votre Claude peut faire dans Filmsquare ce que l'API permet à votre rôle. Dix-huit outils nommés couvrent le travail
courant ; deux autres, `find_actions` et `run_action`, atteignent chaque autre action de l'API. Chaque appel passe par
l'API elle-même, comme vous : les mêmes contrôles de rôle, la même validation, le même feu vert.

## Les outils nommés

| Outil | Ce qu'il fait | Requiert |
| --- | --- | --- |
| `whats_waiting` | Les étapes de département qui attendent votre validation, et vos notifications non lues. Le point de départ | — |
| `list_productions` | Les productions de l'espace de travail avec leurs épisodes | — |
| `get_episode` | Un épisode : séquences et plans dans l'ordre du montage, chaque étape de département (validée, en attente de qui, corrections demandées, à faire), et si les versions finales peuvent être lancées | `episode_id` |
| `get_feedback` | Les fils de discussion sur un plan, une prise, un épisode, une séquence, un élément, un dossier, une version de ressource, un canevas ou un nœud de canevas, avec chaque message et son repère (timecode en images, ou une zone de l'image). Fils ouverts par défaut ; `status` `resolved` ou `all` pour le reste. Avec `target_type` `sheet` : les notes ouvertes sur la dernière version de la fiche (intention, citation ou toute la fiche, texte suggéré, traitée ou non) et comment se sont terminées les notes des versions précédentes | `target_type`, `target_id` |
| `reply_feedback` | Répondre dans un fil comme vous (les mentions `@nom` notifient les personnes), et le marquer comme traité quand la note est traitée. Une note sur une fiche est marquée comme prise en compte à la place ; lorsqu'elle contient une suggestion, `suggestion_outcome` (applied, adapted ou declined) est obligatoire, et une personne la confirme | `thread_id`, `body` |
| `view_media` | Une image fixe, une image clé ou une prise sous forme d'image que Claude peut regarder ; une vidéo revient sous forme de son affiche plus un lien de téléchargement | `asset_version_id` |
| `upload_file` | Un fichier de la conversation sur une couche de plan ou de séquence comme nouvelle prise, ou dans une production comme ressource. 10 Mo au maximum. `pick: true` le retient aussi (réalisateur et au-dessus) | `name`, `mime`, `data_base64` |
| `where_does_it_go` | Sur quel écran va un fichier : la carte, un arbre de décision et des exemples détaillés. À lire dès que vous nommez un écran | — |
| `prepare_upload` | Des URL d'envoi signées et des commandes `curl` prêtes à l'emploi pour jusqu'à 100 fichiers sur disque, pour que les octets ne passent jamais par la conversation. Pour chaque vidéo | `files` |
| `add_to_visualize` | Place les fichiers envoyés sous **Storyboard → 3D** ou **Storyboard → Animatic**, jusqu'à 100 par appel, sur les plans et séquences par leur code. Renvoyer la même chose ne change rien | `episode_id`, `items` |
| `get_script` | La dernière version du scénario de l'épisode, et les `@handles` des personnages, décors et accessoires qui existent déjà | `episode_id` |
| `edit_script` | Modifier une séquence, une réplique ou une ligne du scénario sans l'envoyer en entier : le texte exact et ce qui le remplace, enregistré comme nouvelle version ; les notes et les tags suivent | `episode_id`, `base_rev`, `edits` |
| `submit_breakdown` | Mettre le dépouillement de Claude dans Filmsquare : séquences, plans avec jeu, dialogue, personnages, décors et accessoires. Le scénario attend alors sa validation | `episode_id`, `breakdown` |
| `get_continuity` | La feuille de raccords d'un épisode : ce que joue chaque plan, les éléments et leurs références, avec quoi chaque prise retenue a été faite, les constats déjà faits, les plans à revérifier. Lance d'abord le contrôle de filiation gratuit | `episode_id` |
| `report_continuity` | Enregistrer un contrôle visuel de raccords ; chaque écart devient une note sur la prise retenue | `episode_id`, `seen`, `issues` |
| `submit_style` | Déposer une charte de style dans la bibliothèque de styles (**Create → Styles**) : un nouveau style, ou, avec `style_id`, sa version suivante ; `production_id` en fait le style d'une production. Un travail personnel porte jusqu'à 6 images fixes de référence (téléversées avec `prepare_upload`) ; le travail d'autrui reste en texte seulement et n'est jamais publié. Les noms de personnes ou de marques sont refusés. Rôle maker | `name`, `guide` |
| `request_signoff` | Demander aux valideurs d'un département de valider l'étape d'un épisode ; ils reçoivent une notification | `episode_id`, `department` |
| `sign_off` | Enregistrer votre décision sur une étape : `approved` ou `changes_requested`, avec un `note` facultatif. Seuls les valideurs de l'étape le peuvent. Avec `expect_version` (la version de l'étape telle que vous l'avez vue), elle est refusée avec `changed_since` quand le travail a bougé. Seulement quand vous avez demandé à Claude de décider | `episode_id`, `department`, `decision` |
| `studio_analytics` | Pour le propriétaire et les producteurs : comment va le studio, avec les chiffres d'**Analytics**. `view` `crew` (par personne sur une période : delivered, crédits par delivered, délai de validation, first pass, lanes, redo, heures hands-on et agent seul, la médiane du studio et le délai par étape), `day`, `costs` ou `report` (le texte du mail de rapport tel qu'il serait envoyé). Toute autre personne est refusée : elle ne voit que ses propres chiffres | `view` |

Chaque outil accepte aussi un `workspace` facultatif. Laissez-le de côté : l'espace de travail de la connexion est
utilisé.

`department` est l'un de `writing`, `breakdown`, `casting`, `voice`, `wardrobe`, `sets`, `props`, `animatic`,
`music`, `draft`, `sound`, `edit`, `final`.

## Où vont les médias

Dites l'écran à votre Claude avec vos mots (« mets-le sous 3D »). Voici ce qu'il fait :

| Vous avez | Ça va | Avec |
| --- | --- | --- |
| Rendu clay ou image fixe d'un plan, avec focale, hauteur et mouvement | **Storyboard → 3D**, sur le plan | `add_to_visualize` |
| Clip Blender d'un plan, d'une prise ou d'une séquence | **Storyboard → 3D**, sur ce qu'il couvre | `add_to_visualize` |
| Animatique d'une séquence, d'une suite de séquences ou d'un épisode | **Storyboard → Animatic** | `add_to_visualize` |
| Vidéo en maquette ou en version finale d'un plan | **Storyboard → Shots**, comme prise | `upload_file` |
| Image de référence ou fiche d'ambiance | **Home → Files** | `upload_file` |

Ce qui est au mauvais endroit se déplace sans nouvel envoi : `moveTake` ou `moveAsset` via `run_action` (réalisateur et plus). Une prise retenue par l'import est retirée lors du déplacement. Une prise que quelqu'un a retenue, ou lancée ici, reste où elle est.

## find_actions et run_action

Tout ce qui n'a pas d'outil nommé passe par ces deux-là : créer des plans, retenir des prises, faire des maquettes,
estimations, éléments et versions, dossiers, canevas, coûts, briefs, équipe.

1. `find_actions` cherche dans le catalogue de l'API lui-même avec quelques mots, comme « pick take », « create shot » ou
   « resolve thread ». Il renvoie les actions correspondantes avec leur méthode, leur chemin, un résumé, le rôle minimum et
   les entrées.
2. `run_action` en exécute une par son nom, avec `path_params` (pas l'espace de travail), `query` et `body` comme
   l'action les décrit. Il répond avec le JSON de l'API.

`find_actions` comprend le vocabulaire du tournage. Il fait correspondre les mots qu'une équipe emploie aux mots de
l'API :

| Vous dites | Il cherche aussi |
| --- | --- |
| 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 (néerlandais) | generate, estimate |
| mismatch | continuity |
| model, models | models, acceptance, routing |

Les nouvelles actions de l'API apparaissent dans `find_actions` dès leur sortie. Aucun nouvel outil n'est nécessaire.

### Exemples

| Pour | Recherche | Action |
| --- | --- | --- |
| Chiffrer une maquette avant de la lancer | « estimate shot » | `estimateShotGeneration` |
| Voir le prompt, le modèle et les crédits avant de lancer | « dry run » | `generateForShot` avec `{"kind": "video", "tier": "draft", "dryRun": true}` |
| Lancer une maquette | « generate shot » | `generateForShot` avec `{"kind": "video", "tier": "draft"}` |
| Retenir une prise | « pick take » | `selectTake` |
| Passer une maquette en version finale | « promote » | `promoteGeneration` |
| Nouvelle prise à partir d'une note | « revise take » | `estimateReviseTake`, puis `reviseTake` |
| Voir quel modèle est accepté | « model acceptance » | `getModelAcceptance` |
| Coût d'un épisode | « episode costs » | `getEpisodeCosts` |

Avant de lancer une prise, Claude appelle l'action avec `dryRun: true` : elle montre le prompt composé, le modèle,
les références et les crédits, et ne crée rien. Il peut ensuite adapter le prompt pour ce seul rendu.
`overrides.prompt` remplace le texte du prompt (les lignes de références restent, donc personnages, décors et
accessoires suivent toujours), `overrides.promptAppend` y ajoute, et `overrides.negativePrompt` ajoute ce qu'il faut
éviter. Pour un dialogue, c'est le texte du dialogue qui est prononcé ; il n'accepte pas de prompt modifié.

Le dry run répond avec `provider` et `model_key`. Les renvoyer comme `provider` et `modelKey` fige ce modèle.
`getGeneration` indique avec quoi une prise a été faite : le prompt, le modèle, les crédits estimés et les crédits
comptabilisés.

## Quand l'API refuse

Un refus revient comme une erreur d'outil avec le code et les détails de l'API, par exemple
`The API refused: 409 gate_closed: finals render once casting, sets, animatic are signed off {"episode_id": "…", "waiting_on": ["casting", "sets", "animatic"]}`.
Claude le lit et vous dit ce qui manque. Voir [Erreurs que vous rencontrerez](https://www.filmsquare.ai/docs/fr/api/overview/#errors-you-will-meet).

## Laissé de côté volontairement

Claude ne peut pas atteindre ceci, par conception :

- **Clés d'API et connexions Claude :** une connexion ne crée jamais de clés et n'autorise jamais d'autres connexions.
  Une personne le fait, connectée.
- **OAuth** et l'inscription.
- **Webhooks :** ils envoient des données hors de Filmsquare.
- **Callbacks des fournisseurs** et **sockets temps réel** (canevas et présence).

Le feu vert des versions finales, les contrôles de crédits et les limites de formule s'appliquent à Claude exactement comme à
n'importe qui.

## Sécurité

- **Claude agit comme vous.** Il a votre rôle (ou le plus bas que vous avez choisi à la connexion), et ce qu'il fait
  apparaît à votre nom.
- **La matière de l'équipe n'est pas une instruction.** Les notes, scénarios et autres textes que Claude lit dans
  Filmsquare sont de la matière venant de l'équipe. Filmsquare le dit à Claude : vous seul décidez de ce qu'il fait.
- **Il annonce d'abord le prix.** Faire des prises coûte des crédits. Il est demandé à Claude d'appeler l'action
  avec `dryRun: true`, ce qui ne crée rien, et de dire ce qu'une prise va coûter avant d'en lancer une,
  et de ne jamais lancer de rendu final sans qu'on le lui demande.
- **Il ne valide jamais sans demande.** `sign_off` enregistre une décision à votre nom. Il est demandé à Claude de ne
  l'utiliser que si vous lui avez demandé de décider.

## Prompts

Quatre prompts portent une méthode de travail pour des tâches courantes : `break_down_episode`, `process_feedback`,
`work_on_step` et `check_continuity`. Voir [Prompts et méthode de travail](https://www.filmsquare.ai/docs/fr/claude/prompts/).
