Referenz der MCP-Tools von Scenaloom

Hier findest du jedes Tool, das der MCP-Server von Scenaloom einer verbundenen KI-App anbietet, jeweils mit der Berechtigung, die es braucht. Die Namen der Tools und die Beschreibungen, die die App liest, sind englisch; antworten wird dir die App trotzdem auf Deutsch. Wie du eine App verbindest, steht unter Scenaloom mit KI-Apps verbinden.

Tools

Tool	Berechtigung	Was es tut
list_projects	Projekte lesen	Listet die Projekte der Autorin oder des Autors auf, die neuesten zuerst, auf Wunsch gefiltert nach Suchbegriff oder Typ (Skript, Roman, Kino).
get_project	Projekte lesen	Liefert Titel, Beschreibung und Typ eines Projekts, die eigene Rolle darin, die Folgen mit ihrer Szenenzahl sowie die Zahl der Figuren, Orte und offenen Kommentare.
read_script	Projekte lesen	Liest das Drehbuch einer Folge als typisierte Blöcke (Szenenüberschrift, Regieanweisung, Figur, Dialog, Klammerbemerkung, Übergang, Einstellung) oder als Fountain, abschnittsweise oder Szene für Szene, mit der Revision und den Hashes, die Änderungen brauchen.
list_scenes	Projekte lesen	Zeigt die Szenen einer Folge der Reihe nach: Überschrift, Ort, Figuren, Blockbereich und Zusammenfassung.
list_entities	Projekte lesen	Zeigt die Figuren, Orte oder Requisiten des Projekts mit ihren Angaben, der Zahl ihrer Szenen und den Beziehungen der Figuren.
get_story_structure	Projekte lesen	Liefert die Beats, die Gliederung des Projekts und die Gliederung der Folge.
read_novel	Projekte lesen	Liefert die Kapitelliste eines Romans oder den Text eines Kapitels in Abschnitten von bis zu 40.000 Zeichen, mit der Revision, die Änderungen brauchen.
search_project	Projekte lesen	Findet eine Zeile, einen Namen oder eine Wendung in Skript, Roman, Figuren und Orten, Kommentaren und Beats eines Projekts.
list_comments	Projekte lesen	Zeigt offene oder erledigte Kommentare eines Projekts mit ihren Ankerstellen, ihren Verfassern und der App, die sie geschrieben hat.
list_generations	Projekte lesen	Zeigt Aufträge zur Bild-, Video- und Audiogenerierung mit ihrem Status und ihren Credits.
get_generation	Projekte lesen	Zeigt Status, Fortschritt, verbrauchte oder erstattete Credits und das Ergebnis eines einzelnen Generierungsauftrags.
propose_script_edits	Drehbücher und Romane bearbeiten	Bereitet bis zu sechs Änderungen an einer Folge vor (Regieanweisung einfügen, Zeile umschreiben, Text ersetzen, überall ersetzen, Beat hinzufügen) und liefert Vorschauen mit Vorher und Nachher; geändert wird erst mit apply_script_edits.
apply_script_edits	Drehbücher und Romane bearbeiten	Übernimmt einen Vorschlag, dem die Autorin oder der Autor zugestimmt hat; die Änderung wird mit laufenden Bearbeitungen zusammengeführt, erscheint im Versionsverlauf und lässt sich rückgängig machen.
undo_script_edits	Drehbücher und Romane bearbeiten	Macht einen übernommenen Änderungsstapel rückgängig, sofern spätere Änderungen nicht damit kollidieren.
propose_novel_edits	Drehbücher und Romane bearbeiten	Bereitet Suchen-und-Ersetzen-Änderungen oder eine angehängte Passage für ein Kapitel vor und liefert Vorschauen; jede gesuchte Stelle muss genau einmal vorkommen.
apply_novel_edits	Drehbücher und Romane bearbeiten	Übernimmt einen bestätigten Vorschlag für den Roman, zusammengeführt mit allen, die gleichzeitig im Kapitel schreiben.
undo_novel_edits	Drehbücher und Romane bearbeiten	Nimmt übernommene Romanänderungen aus dem Kapitel zurück und behält, was seitdem geschrieben wurde; abgelehnt, wenn jemand diese Stelle bearbeitet hat.
update_entity	Drehbücher und Romane bearbeiten	Ändert die Angaben zu einer Figur, einem Drehort oder einer Requisite. Abgelehnt, wenn jemand den Eintrag seit dem Lesen geändert hat; Autorinnen und Autoren können es einen Tag lang im KI-Bereich rückgängig machen.
undo_entity_update	Drehbücher und Romane bearbeiten	Nimmt eine Änderung von update_entity zurück, solange diese Felder seither nicht bearbeitet wurden.
create_project	Drehbücher und Romane bearbeiten	Legt ein Drehbuch- oder Romanprojekt an, im Rahmen der Limits des Tarifs.
create_episode	Drehbücher und Romane bearbeiten	Fügt einer Serie eine Folge hinzu.
add_comment	Kommentieren	Hinterlässt eine Notiz an einem Skriptblock, gekennzeichnet als Beitrag der verbundenen App; Mitwirkende werden erst benachrichtigt, wenn die Autorin oder der Autor das bestätigt.
resolve_comment	Kommentieren	Markiert einen Kommentar als erledigt oder öffnet ihn wieder.
get_credits	Credits ausgeben	Zeigt Guthaben und Tarif, die Ausgabeeinstellung und das Tageslimit dieser App und was sie heute schon ausgegeben hat.
quote_generation	Credits ausgeben	Berechnet den Preis einer Bild-, Video- oder Audiogenerierung, ohne etwas auszugeben, und liefert ein Angebot, das einmal verwendbar ist und fünf Minuten gilt.
start_generation	Credits ausgeben	Gibt die angebotenen Credits aus und startet die Generierung, aber erst nachdem die Autorin oder der Autor die Kosten bestätigt hat.
cancel_generation	Credits ausgeben	Bricht eine laufende Generierung ab; die Credits werden nach der Guthabenrichtlinie erstattet.

Lese-Tools ändern nie etwas. Bearbeitungs-Tools ändern dein Werk nur über einen Vorschlag, dem du zugestimmt hast, und jeder übernommene Stapel lässt sich rückgängig machen. Das einzige Tool, das Credits ausgibt, ist start_generation, und auch das erst, wenn du die genannten Kosten bestätigt hast.

So läuft eine Änderung ab

Die App liest die Szene mit read_script; zurück kommen alle Blöcke mit ihrer ID und die Revision des Skripts.
Sie ruft propose_script_edits mit bis zu sechs Änderungen auf. Scenaloom prüft sie und liefert zu jeder eine Vorschau mit Vorher und Nachher; der Vorschlag wartet 30 Minuten und erscheint auch im KI-Panel des Editors.
Die App zeigt dir die Vorschauen. Stimmst du zu, ruft sie apply_script_edits auf. Hat jemand das Skript inzwischen geändert, wird das Übernehmen abgelehnt, und die App liest neu.
Das Ergebnis enthält die ID des Stapels. undo_script_edits mit dieser ID macht den Stapel rückgängig, und der Versionsverlauf behält die frühere Fassung in jedem Fall.

Romane funktionieren genauso, mit read_novel, propose_novel_edits und apply_novel_edits: Jede Passage, die ersetzt werden soll, muss genau einmal im Kapitel vorkommen, damit eine Änderung nie an der falschen Stelle landet.

So wird eine Generierung bezahlt

quote_generation berechnet den Preis, ohne etwas auszugeben, und liefert ein Angebot, das fünf Minuten gilt und nur einmal verwendet werden kann.
Die App nennt dir die Kosten und dein Guthaben danach und ruft start_generation erst auf, wenn du zustimmst. Apps, die Bestätigungen unterstützen, zeigen dir die Bestätigung von Scenaloom selbst; andere Apps dürfen nur innerhalb des Tageslimits ausgeben, das du festgelegt hast.
get_generation meldet Fortschritt und Ergebnis. Hat sich der Preis nach dem Angebot geändert, startet Scenaloom nicht, und eine fehlgeschlagene Generierung wird nach der Guthabenrichtlinie erstattet.

Ressourcen und Prompts

Apps, die Ressourcen durchsuchen können, hängen an ein Gespräch ein Projekt, eine Folge als Fountain, ein Romankapitel oder die Story-Bibel des Projekts an (Figuren, Orte, Requisiten, Beziehungen, Beats und Gliederung). Prompts starten häufige Aufgaben: einen Durchgang als Script-Doktor, Anmerkungen zur Beat-Struktur, die Überarbeitung einer Szene, Notizen zu einer Leseprobe sowie Logline und Synopsis. Die Titel der Prompts folgen der Sprache deiner Scenaloom-Oberfläche.

Fehlermeldungen einer App

Meldung	Was du tun kannst
Skript nach dem Vorschlag geändert (The script changed after the proposal)	Lies die Szene neu und schlag die Änderung erneut vor.
Fehlende Berechtigung (Insufficient scope)	Der App fehlt eine Berechtigung. Trenn sie unter Verbundene Apps, verbinde sie dann neu und setz den Haken bei der Berechtigung.
Nicht gefunden (Not found)	Das Projekt wurde gelöscht, oder du hast keinen Zugriff mehr darauf.
App kann Ausgaben nicht bestätigen (This app can't confirm spending)	Leg ein tägliches Credit-Limit für die App fest, oder starte die Generierung in Scenaloom.
Zu viele Anfragen (Rate limited)	Warte die angegebene Anzahl Sekunden und versuch es dann erneut.