Claude Code Integrationsanleitung
Steuern Sie AutoFlowCut direkt aus Claude Code via Model Context Protocol
🤖 Was ist MCP?
Das Model Context Protocol (MCP) ermöglicht es Ihnen, AutoFlowCut direkt aus Claude Code über Ihr Terminal zu steuern. Laden Sie CSV-Szenen, aktualisieren Sie Prompts, starten Sie die Batch-Bildgenerierung und exportieren Sie nach CapCut — alles durch natürliche Sprachbefehle.
Der MCP-Server kommuniziert über stdio mit Claude Code und verbindet sich über eine lokale HTTP-API auf Port 3210 mit der laufenden AutoFlowCut-App.
🏗️ Architektur
Claude Code ←→ MCP Server (stdio) ←→ Electron App (HTTP :3210)
↕ ↕
CSV / project.json React Renderer (IPC)
.audio_review.json Direkte State-Mutation
🧰 Tool-Kategorien
📊 CSV-Verwaltung
Laden, auflisten, suchen, aktualisieren und speichern Sie Szenen aus CSV-Dateien. Unterstützt Batch-Prompt-Updates und Szenenfeld-Verwaltung.
🖼️ Referenz-Tools
Verwalten Sie Charakter- und Szenenreferenzen in project.json. Unterstützt Auflisten, Prüfen und Aktualisieren von Referenz-Prompts.
🎬 App-Steuerung
Steuern Sie die laufende App über HTTP — 19 app_*-Tools plus zwei Export-Tools. Projekte verwalten, Bilder generieren, Batches ausführen, Status überwachen und exportieren. Hier ist nur eine Auswahl aufgeführt.
🚦 Workflow-Fortschritt
Lesen Sie den Wave-Fortschritt der Pipeline und melden Sie den QA-Review-Status an das App-Banner. Der Fortschritt ist schreibgeschützt — geschrieben wird er vom Skill.
🧩 Skill-Verwaltung
AutoFlowCut-Skills für Claude Code installieren, auflisten und entfernen. Template-Variablen werden bei der Installation ersetzt.
🎧 Audio-Review & Stile
Ungeeignete Sprecher- und Soundeffekt-Dateien in einem Audio-Paket markieren bzw. Markierungen aufheben und die integrierten Stil-Presets durchsuchen.
📖 Wichtige Tools-Referenz
| Tool | Beschreibung |
|---|---|
| load_csv | CSV-Datei und Bildverzeichnis laden |
| list_scenes | Szenen mit optionaler Bereichsfilterung auflisten |
| update_prompt | Englischen Prompt einer einzelnen Szene aktualisieren |
| batch_update_prompts | Prompts mehrerer Szenen gleichzeitig aktualisieren |
| app_start_scene_batch | Batch-Bildgenerierung für ausstehende Szenen starten |
| app_wait_batch | Auf Batch-Generierung warten (Long-Poll) |
| export_capcut | Projekt ins CapCut-Format exportieren |
| export_premiere | Projekt als Premiere-Pro-Projekt (.prproj) exportieren |
| get_schema | CSV/SRT/Audio-Schema-Dokumentation abrufen |
| list_styles | Stil-Presets nach Kategorie auflisten |
| get_progress | Wave-Fortschritt der Pipeline lesen (schreibgeschützt) |
🚦 Workflow-Fortschritt
Die Pipeline aus neun Waves (W1–W9) gehört zum story-engine-Skill für Claude Code — nicht zum eingebauten Story-Modus der App, der Drehbuch → Szenenaufteilung → Audio → Prompts durchläuft und keine Waves kennt. Der Orchestrator des Skills schreibt den Workflow-Status direkt in Dateien im Ordner _story_source/ des Projekts. Kein MCP-Tool schreibt den Workflow-Status — der MCP-Server liest ihn nur, über get_progress.
Workflow-Statusdateien
| Datei | Rolle | Geschrieben von |
|---|---|---|
| STATE.md | Hauptstatus — aktuelle Wave, abgeschlossene Schritte, Entscheidungen | story-engine-Skill |
| W{N}_SUMMARY.md | Ergebnisse pro Wave, Review-Runden, Probleme | story-engine-Skill |
| W_progress.json | Seitenprotokoll — Status waves.W1–waves.W9 für die App und externe Tools |
story-engine-Skill (Abruf über get_progress) |
Verwendung
# Wave-Fortschritt aus W_progress.json lesen get_progress() # QA-Review-Fortschritt an das Status-Banner der App melden app_notify_qa(kind="scene", state="progress", current=12, total=40, round=1, issues=3)
🌐 HTTP-API-Endpunkte
Wenn der MCP-HTTP-Server in den AutoFlowCut-Einstellungen aktiviert ist, sind diese Endpunkte unter 127.0.0.1:3210 verfügbar.
| Methode | Pfad | Beschreibung |
|---|---|---|
| GET | /api/status | Server-Zustandsprüfung |
| GET | /api/references | Referenzliste (ohne Base64-Bilder) |
| GET | /api/scenes | Szenenliste (ohne Bilddaten) |
| GET | /api/batch-status | Batch-Generierungsfortschritt |
| POST | /api/generate-reference | Referenzbild-Generierung auslösen |
| POST | /api/generate-scene | Einzelne Szenen-Generierung auslösen |
| POST | /api/start-batch | Batch-Generierung für alle ausstehenden Szenen starten |
| POST | /api/update | Generische State-Aktualisierung (IPC-Relay) |