VidCraft liest ~/.vidcraft/config.yaml. Die Datei entsteht durch /vidcraft:setup aus der Vorlage config/config.example.yaml; mit /vidcraft:configure pflegst du sie interaktiv. Fehlt die Datei, verwendet der MCP-Server eingebaute Standardwerte. Werte aus der Datei überschreiben die Standardwerte Schlüssel für Schlüssel.
paths:
content_root: "~/video-projects"
video_root: "~/video-projects/videos"
assets_root: "~/video-projects/assets"
overrides: "~/video-projects/overrides"
defaults:
language: ["de", "en"]
wpm: 140
platform: "heygen"
heygen:
default_avatar: ""
default_voice: ""
synthesia:
default_avatar: ""
default_voice: ""
brand:
name: ""
primary_color: ""
secondary_color: ""
font: ""
tone: ["professional", "friendly"]
Pfade dürfen ~ und Umgebungsvariablen enthalten.
| Schlüssel | Wirkung |
|---|---|
paths.content_root |
Wurzel aller Projektdateien (Markdown). Projekte liegen unter {content_root}/projects/, Ideen in {content_root}/IDEAS.md. Dateioperationen und die Dokument-Analyse des MCP-Servers sind auf dieses Verzeichnis beschränkt. |
paths.video_root |
Ziel für fertige Videodateien, aufgelöst als {video_root}/projects/{projekt}. |
paths.assets_root |
Ziel für Screenshots und Bilder, aufgelöst als {assets_root}/projects/{projekt}. |
defaults.wpm |
Wörter pro Minute für die Dauer-Schätzung der Pre-Generation-Gates. Standard: 140. |
Die übrigen Schlüssel der Vorlage (
paths.overrides,defaults.language,defaults.platform,heygen.*,synthesia.*,brand.*) werden vom MCP-Server nicht ausgewertet. Sprache und Plattform eines Projekts stehen im Frontmatter der Projekt-README und werden beim Anlegen des Projekts gesetzt (Standard:deundheygen). Der Skillbrand-checkerliest Marken-Tonalität aus Projekt-README und Konfiguration.
Jedes Projekt ist ein Verzeichnis unter {content_root}/projects/. Der Slug entsteht aus dem Titel.
{projekt-slug}/
├── README.md # Projekt-Metadaten (YAML-Frontmatter)
├── episodes/
│ └── 01-episode-slug/
│ ├── README.md # Episode-Metadaten
│ ├── scenes/
│ │ ├── 01-intro.md
│ │ └── 02-schritt.md
│ └── assets/
├── assets/ # projektweite Assets
└── research/ # Quellen, Recherche
Weitere Dateien entstehen durch einzelne Skills, zum Beispiel brief.md, research/RESEARCH.md, research/AUDIENCE.md, episodes/.../assets/ASSETS.md, episodes/.../shot-list.md, promo/*.md und RELEASE.md. Siehe Skills.
Episoden-Verzeichnisse und Szenen-Dateien werden mit zweistelliger Nummer vor dem Slug angelegt.
Der Status steckt im YAML-Frontmatter der Markdown-Dateien. Der MCP-Server liest daraus den Projektzustand.
| Ebene | Felder |
|---|---|
Projekt (README.md) |
title, slug, video_type, status, platform, language, target_audience, description, created, updated |
Episode (episodes/*/README.md) |
title, number, slug, status, duration_target, platform, avatar, description |
Szene (scenes/*.md) |
title, number, status, visual_type, duration |
Szenen-Inhalte stehen in den Abschnitten ## Narration, ## On-Screen Text, ## Visual Direction und ## Assets. Status-Werte erklärt die Seite Workflow.
Aus den Markdown-Dateien baut der Server einen Cache unter ~/.vidcraft/cache/state.json. Die Abfrage-Tools lesen daraus. Neu angelegte oder von Hand geänderte Dateien erscheinen dort erst nach einem Neuaufbau: /vidcraft:session-start oder das Tool rebuild_state. Die Markdown-Dateien bleiben die maßgebliche Quelle. Mehr dazu unter Technik.