Référence des outils MCP de Scenaloom

Voici tous les outils que le serveur MCP de Scenaloom met à la disposition d'une application d'IA connectée, avec l'autorisation que chacun demande. Les noms des outils et les descriptions lues par l'application sont en anglais ; l'application, elle, vous répond dans votre langue. Pour connecter une application, voyez Connecter Scenaloom aux applications d'IA.

Les outils

Outil	Autorisation	Ce qu'il fait
list_projects	Lire	Liste les projets de l'auteur, du plus récent au plus ancien, avec un filtre facultatif par recherche ou par type (scénario, roman, film).
get_project	Lire	Donne le titre, la description et le type d'un projet, le rôle de l'auteur, ses épisodes avec leur nombre de séquences, et le nombre de personnages, de lieux et de commentaires ouverts.
read_script	Lire	Lit le scénario d'un épisode en blocs typés (intitulé, action, personnage, dialogue, didascalie, transition, plan) ou au format Fountain, par extrait ou séquence par séquence, avec la révision et les empreintes nécessaires aux modifications.
list_scenes	Lire	Liste les séquences d'un épisode dans l'ordre, avec l'intitulé, le lieu, les personnages, la plage de blocs et le résumé.
list_entities	Lire	Donne les personnages, lieux ou accessoires du projet avec leurs fiches, leur nombre de séquences et les relations entre personnages.
get_story_structure	Lire	Donne les temps forts, le plan du projet et le plan de l'épisode.
read_novel	Lire	Donne la liste des chapitres d'un roman, ou le texte d'un chapitre par pages de 40 000 caractères au plus, avec la révision nécessaire aux modifications.
search_project	Lire	Cherche une réplique, un nom ou une expression dans le scénario, le roman, les personnages, les lieux, les commentaires et les temps forts d'un projet.
list_comments	Lire	Liste les commentaires ouverts ou résolus d'un projet, avec leur ancrage, leur auteur et l'application qui les a écrits.
list_generations	Lire	Liste les générations d'images, de vidéos et d'audio avec leur état et leurs crédits.
get_generation	Lire	Donne l'état, la progression, les crédits dépensés ou remboursés et le résultat d'une génération.
propose_script_edits	Modifier	Prépare jusqu'à six modifications d'un épisode (ajout d'action, réécriture d'une ligne, remplacement ponctuel ou partout, ajout d'un temps fort) et renvoie les aperçus avant et après, sans rien changer avant apply_script_edits.
apply_script_edits	Modifier	Applique une proposition validée par l'auteur, fusionnée avec les modifications en cours, inscrite dans l'historique des versions et annulable.
undo_script_edits	Modifier	Annule un lot de modifications appliqué, sauf si des modifications ultérieures entrent en conflit avec lui.
propose_novel_edits	Modifier	Prépare des remplacements ou l'ajout d'un passage en fin de chapitre et renvoie les aperçus ; chaque passage recherché doit figurer une seule fois.
apply_novel_edits	Modifier	Applique une proposition validée sur un roman, fusionnée avec ce qu'écrivent au même moment les autres personnes dans le chapitre.
undo_novel_edits	Modifier	Retire de son chapitre les modifications appliquées à un roman en gardant ce qui a été écrit depuis ; refusé si quelqu'un a retouché ces mots.
update_entity	Modifier	Modifie les détails d'un personnage, d'un décor ou d'un accessoire. Refusé si quelqu'un a modifié la fiche depuis sa lecture ; l'auteur peut l'annuler depuis le panneau IA pendant une journée.
undo_entity_update	Modifier	Annule une modification faite par update_entity, tant que ces champs n'ont pas été retouchés depuis.
create_project	Modifier	Crée un projet de scénario ou de roman, dans les limites du forfait de l'auteur.
create_episode	Modifier	Ajoute un épisode à une série.
add_comment	Commenter	Laisse une note sur un bloc du scénario, signée de l'application connectée ; les collaborateurs ne sont prévenus qu'après confirmation de l'auteur.
resolve_comment	Commenter	Marque un commentaire comme résolu, ou le rouvre.
get_credits	Dépenser des crédits	Donne le solde de crédits et le forfait de l'auteur, le réglage de dépense et le plafond quotidien de cette application, et ce qu'elle a dépensé aujourd'hui.
quote_generation	Dépenser des crédits	Chiffre une génération d'image, de vidéo ou d'audio sans rien dépenser et renvoie un devis à usage unique valable cinq minutes.
start_generation	Dépenser des crédits	Dépense les crédits du devis et lance la génération, uniquement après l'accord de l'auteur sur le coût.
cancel_generation	Dépenser des crédits	Annule une génération en cours ; les crédits sont remboursés selon la politique des crédits.

Les outils de lecture ne changent jamais rien. Les outils de modification ne touchent à votre travail qu'au travers d'une proposition que vous avez validée, et chaque lot appliqué peut être annulé. Le seul outil qui dépense des crédits est start_generation, et seulement après votre accord sur le coût annoncé.

Comment se déroule une modification

L'application lit la séquence avec read_script, qui renvoie chaque bloc avec son identifiant et la révision du scénario.
Elle appelle propose_script_edits avec six changements au plus. Scenaloom les vérifie et renvoie pour chacun un aperçu avant et après ; la proposition reste valable 30 minutes et s'affiche aussi dans le panneau Scenaloom AI de l'éditeur.
L'application vous montre les aperçus. Si vous êtes d'accord, elle appelle apply_script_edits. Si quelqu'un a modifié le scénario entre-temps, l'opération est refusée et l'application doit relire le scénario.
Le résultat indique l'identifiant du lot. undo_script_edits avec cet identifiant annule le lot, et l'historique des versions garde de toute façon la version précédente.

Les romans fonctionnent de la même façon avec read_novel, propose_novel_edits et apply_novel_edits : chaque passage à remplacer doit figurer une seule fois dans le chapitre, si bien qu'une modification ne peut jamais tomber au mauvais endroit.

Comment une génération est payée

quote_generation chiffre la demande sans rien dépenser et renvoie un devis valable cinq minutes, utilisable une seule fois.
L'application vous indique le coût et votre solde après la dépense, et n'appelle start_generation qu'avec votre accord. Les applications qui gèrent les confirmations affichent celle de Scenaloom ; les autres ne peuvent dépenser que dans la limite du plafond quotidien que vous avez fixé.
get_generation indique la progression et le résultat. Si le prix a changé depuis le devis, Scenaloom refuse de lancer la génération, et une génération échouée est remboursée selon la politique des crédits.

Ressources et prompts

Les applications qui savent parcourir des ressources peuvent joindre à une conversation un projet, un épisode au format Fountain, un chapitre de roman ou la bible du projet (personnages, lieux, accessoires, relations, temps forts et plan). Des prompts prêts à l'emploi lancent les tâches courantes : une relecture de script doctor, des notes sur la structure en temps forts, la révision d'une séquence, des notes de lecture à la table, une logline et un synopsis. Leurs titres suivent la langue de votre interface Scenaloom.

Erreurs qu'une application peut signaler

Message	Que faire
The script changed after the proposal (le scénario a changé depuis la proposition)	Relire la séquence et proposer à nouveau.
Insufficient scope (autorisation insuffisante)	Il manque une autorisation à l'application. Déconnectez-la dans « Applications connectées », puis reconnectez-la en cochant l'autorisation.
Not found (introuvable)	Le projet a été supprimé, ou vous n'y avez plus accès.
This app can't confirm spending (l'application ne peut pas confirmer la dépense)	Fixez un plafond quotidien de crédits pour l'application, ou lancez la génération dans Scenaloom.
Rate limited (trop de requêtes)	Attendez le nombre de secondes indiqué, puis réessayez.