Hilfe

Fehlerbehebung

Häufige Probleme, ihre Ursachen und Lösungen Schritt für Schritt.

Kommen Sie nicht weiter? Eröffnen Sie ein Support-Ticket in Ihrem Dashboard mit einer Beschreibung des Problems und der angezeigten Fehlermeldung — wir antworten schnell. Sie können auch in unserem Discord fragen.

MCP nicht verbunden

Claude meldet, dass die After Effects-Tools nicht verfügbar sind, oder "MCP not connected".

Format des Lizenzschlüssels prüfen

Der Schlüssel ist eine UUID im Format XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX — ohne Leerzeichen davor oder danach. Kopieren Sie ihn direkt aus Ihrem Dashboard.

MCP-Client neu starten

Schließen Sie Claude Desktop (oder Cursor / Windsurf) vollständig und öffnen Sie es erneut. Die Lizenz wird beim Start validiert.

Prüfen, ob Node.js installiert ist

Führen Sie node --version in einem Terminal aus — Sie benötigen v18 oder neuer. Falls Node.js fehlt, installieren Sie es von nodejs.org.

Tools laufen, aber in After Effects passiert nichts

Claude bestätigt, dass das Tool erfolgreich ausgeführt wurde, aber in AE erscheinen keine Änderungen.

After Effects muss geöffnet sein

Der MCP kann nicht mit AE kommunizieren, wenn es nicht läuft. Öffnen Sie After Effects, bevor Sie Tools aufrufen.

Keine blockierenden Dialoge

Zeigt AE einen modalen Dialog an (Speicherabfrage, Warnung usw.), kann es keine Skripte ausführen. Schließen Sie alle offenen Dialoge und versuchen Sie es erneut.

Aktives Projekt erforderlich

Viele Tools erfordern ein geöffnetes Projekt. Ist keines geöffnet, erstellen Sie zuerst ein neues in AE oder bitten Sie Claude, eines zu erstellen.

After Effects nicht gefunden

Fehlermeldung wie "Could not find After Effects" oder "AfterFX.exe not found".

AE_AFTERFX_PATH manuell setzen

Fügen Sie die Umgebungsvariable hinzu, die auf Ihre AE-Programmdatei zeigt. Beispiele finden Sie auf der Seite zur Konfiguration.

Beispiel

claude_desktop_config.json

"AE_AFTERFX_PATH": "C:\\Program Files\\Adobe\\Adobe After Effects 2025\\Support Files\\AfterFX.exe"

Lizenz ungültig oder abgelehnt

Server-Logs oder Claude melden "invalid license key" oder "license validation failed".

Aus dem Dashboard kopieren

Holen Sie sich Ihren exakten Schlüssel unter synthetic.com.ar/dashboard/licenses — tippen Sie ihn nicht ab.

Format prüfen

UUID-Format: XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX. Keine Anführungszeichen im Wert, keine zusätzlichen Leerzeichen.

Gerätelimit prüfen

Wenn Sie das Gerätelimit Ihres Plans erreicht haben (1 beim Monatsplan, 2 beim Jahresplan), deaktivieren Sie zuerst ein altes Gerät im Dashboard.

Zeitüberschreitung beim Skript

Ein Tool-Aufruf gibt einen Timeout-Fehler zurück, besonders bei aufwendigen Vorgängen wie Renderings mit vielen Ebenen.

AE_MCP_TIMEOUT erhöhen

Setzen Sie AE_MCP_TIMEOUT auf einen höheren Wert in Millisekunden. Der Standardwert ist 30000 (30 Sekunden). Versuchen Sie es bei komplexen Skripten mit 60000 oder 120000.

Konfigurationsbeispiel

claude_desktop_config.json

"env": {
  "AE_MCP_LICENSE": "XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX",
  "AE_MCP_TIMEOUT": "60000"
}

Expression-Fehler nach dem Baken

Nach dem Aufruf von bake_expression zeigt die Eigenschaft Fehler oder falsche Werte.

Expression-Syntax vor dem Baken prüfen

Prüfen Sie eine Eigenschaft mit list_expression_errors auf Fehler, bevor Sie baken. Das Baken einer fehlerhaften Expression erzeugt falsche Werte.

Im richtigen Zeitbereich baken

Beim Baken wird die Expression an jedem Frame im Arbeitsbereich der Komposition abgetastet. Stellen Sie vor dem Baken sicher, dass der Arbeitsbereich den gewünschten Bereich abdeckt.

Rückgängig ist möglich

Hat das Baken schlechte Ergebnisse erzeugt, stellen Sie die Expression sofort mit undo wieder her.

Debug-Logs abrufen

Setzen Sie AE_MCP_LOG_LEVEL in Ihrer Konfiguration auf debug, um ausführliche Ausgaben des MCP-Servers zu sehen. So sehen Sie genau, welche Skripte an AE gesendet werden und welche Antworten zurückkommen — nützlich, um unerwartetes Verhalten zu diagnostizieren.

claude_desktop_config.json

"env": {
  "AE_MCP_LICENSE": "XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX",
  "AE_MCP_LOG_LEVEL": "debug"
}

FAQ Tool-Referenz