DaVinci Resolve MCP · Fehlerbehebung
Fehlerbehebung & Limits
Die häufigsten Probleme und deren Lösungen, gefolgt von den ehrlichen Einschränkungen des Produkts. Wenn Ihr Problem hier nicht aufgeführt ist, öffnen Sie bitte ein Support-Ticket.
Die Tools melden, dass DaVinci Resolve nicht verbunden ist
Symptom: Der Client lädt den Server, aber die Tools antworten mit einem Verbindungsfehler.
Lösung: Öffnen Sie DaVinci Resolve mit einem Projekt und laden Sie den Connector: Workspace → Console, wählen Sie Lua aus und fügen Sie die Zeile aus die Installationsanleitung ein. Wiederholen Sie dies bei jedem Neustart von Resolve.
Die Console zeigt einen Fehler an, wenn ich die Zeile einfüge
Symptom: Die Console von Resolve antwortet mit einem Fehler, anstatt zu bestätigen, dass der Connector bereit ist.
Lösung: Prüfen Sie, ob die Console im Lua-Modus (nicht Py) ist und ob Sie den Benutzernamen durch Ihren eigenen ersetzt haben. Die Datei wird erstellt, wenn Ihr MCP-Client den Server zum ersten Mal mit einer gültigen Lizenz startet: Starten Sie den Client, bevor Sie die Zeile einfügen.
Resolve öffnet einen Upgrade-Dialog und reagiert nicht mehr
Symptom: Ein Tool hat eine Funktion angefordert, die nur in DaVinci Resolve Studio verfügbar ist. Die kostenlose Edition öffnet daraufhin ihren Upgrade-Dialog, der jedes Fenster von Resolve blockiert, bis er geschlossen wird.
Lösung: Schließen Sie den Dialog über die Schaltfläche Not Yet: Resolve und die Tools funktionieren wieder. Weisen Sie Ihren KI-Client an, keine Studio-exklusiven Funktionen zu verwenden (siehe die Einschränkungen unten).
Fehler: Ungültige Lizenz
Symptom: Die Tools antworten, dass die Lizenz fehlt oder ungültig ist, oder die Client-Logs melden, dass DAVINCI_RESOLVE_MCP_LICENSE nicht gesetzt ist.
Lösung: Die Lizenz in Ihrer Konfiguration stimmt nicht mit der auf /dashboard/licenses überein. Kopieren Sie diese erneut — achten Sie beim Einfügen in das JSON auf führende oder nachfolgende Leerzeichen — und starten Sie den MCP-Client neu.
Die Tools funktionieren nach einem Update nicht mehr
Symptom: Der Server hat sich aktualisiert und die Tools weisen nun Fehler auf, wenn sie mit Resolve kommunizieren.
Lösung: Ein Update kann einen neuen Connector mit sich bringen. Bitten Sie Ihren KI-Client, resolve_reload_server auszuführen, oder starten Sie DaVinci Resolve neu und fügen Sie die Zeile erneut ein.
Auf einem Mac fragt „Verbinden“ nach einer Berechtigung oder verbindet nicht
Symptom: Das Fenster Synthetic DaVinci Resolve MCP meldet, dass macOS Ihre Erlaubnis braucht oder dass das Menü Workspace bzw. die Console nicht gefunden wurde.
Lösung: Schalten Sie „Synthetic DaVinci Resolve MCP“ unter Systemeinstellungen → Datenschutz & Sicherheit → Bedienungshilfen ein und klicken Sie erneut auf Verbinden. Wenn Resolve auf eine andere Sprache als Englisch eingestellt ist, findet Verbinden das Menü eventuell nicht: Verwenden Sie Manuelle Verbindung (Workspace → Console, Lua-Modus, Zeile aus die Installationsanleitung einfügen), das nicht von der Sprache abhängt.
Das Fenster meldet, dass Node.js nicht gefunden wurde
Symptom: Das Synthetic DaVinci Resolve MCP-Fenster öffnet sich mit einer Meldung zu Node.js anstelle des Verbindungsstatus.
Lösung: Installieren Sie Node.js (LTS) von nodejs.org und öffnen Sie das Fenster erneut. Der MCP-Server selbst benötigt dies ebenfalls.
Einschränkungen
Was DaVinci Resolve MCP nicht kann oder womit es noch nicht getestet wurde. Wir führen dies hier auf, damit Sie vor dem Kauf Bescheid wissen.
- Verifiziert unter Windows mit der kostenlosen Edition von DaVinci Resolve 21.1.1. macOS befindet sich in der Beta: Es wurde nicht vollständig getestet und kann Fehler enthalten. Linux wird nicht unterstützt.
- DaVinci Resolve Studio und Blackmagic Cloud wurden nicht getestet. Funktionen, die nur in Studio verfügbar sind (z. B. Sprachisolierung, Magic Mask, Transkription und Audioklassifizierung), öffnen in der kostenlosen Edition den Upgrade-Dialog.
- Resolve muss geöffnet sein, ein Projekt muss geladen sein und der Connector muss einmal pro Sitzung über die Console geladen werden.
- Fusion: Makros können nicht innerhalb einer Komposition erstellt werden (installieren Sie diese als Dateien über die Add-on-Tools), und eine Fusion-Komposition kann nicht eigenständig gerendert werden: Nutzen Sie hierfür die Render-Warteschlange.
- Workflow Integration und Codec-Plug-ins können nicht über die Add-on-Tools installiert werden.
- Resolve verwendet keine permanenten IDs für Clips: Tools finden einen Clip über seine Spur und Position. Wenn Sie Clips verschieben, sollte Ihr KI-Client die Timeline erneut auslesen.
- Verwenden Sie auf einem Mac DaVinci Resolve, das von der Blackmagic Design Website heruntergeladen wurde: Die Version aus dem Mac App Store läuft in einer Sandbox, die es dem Connector eventuell nicht erlaubt, seine lokale Verbindung zu öffnen.
Wenn nichts davon hilft
Eröffnen Sie ein Ticket unter Ihr Support-Dashboard mit: (1) Ihrer DaVinci Resolve Version, (2) Ihrem MCP-Client und dessen Version, (3) den Logs des Clients beim Startversuch des Servers und (4) dem von Ihnen eingefügten Config-Snippet (ohne den Lizenzschlüssel). Sie können auch in unserem Discord fragen.