Blender MCP · Fehlerbehebung
Fehlerbehebung & Grenzen
Die häufigsten Probleme und deren Lösungen, gefolgt von den ehrlichen Grenzen des Produkts. Wenn Ihr Problem hier nicht aufgeführt ist, öffnen Sie bitte ein Support-Ticket.
Die Tools melden, dass Blender nicht verbunden ist
Symptom: Der Client lädt den Server, aber die Tools antworten, dass Blender nicht reagiert.
Lösung: Öffnen Sie Blender und prüfen Sie, ob das Synthetic Blender MCP Add-on aktiviert ist (Bearbeiten → Benutzereinstellungen → Add-ons). Falls es nicht in der Liste aufgeführt ist, installieren Sie es wie in die Installationsanleitung beschrieben.
Blender reagiert zeitweise nicht
Symptom: Das Fenster von Blender friert ein, während ein Tool ausgeführt wird, zum Beispiel während eines Renders oder einer Simulation.
Lösung: Dies ist zu erwarten: Die Tools laufen im Haupt-Thread von Blender, sodass ein langer Render-Vorgang das Fenster blockiert, bis er abgeschlossen ist. Bitte warten Sie; falls ein Tool in der Zwischenzeit in einen Timeout gelaufen ist, bitten Sie Ihren AI-Client, die Szene zu prüfen, bevor Sie es erneut versuchen.
Fehler: Ungültige Lizenz
Symptom: Die Tools antworten, dass die Lizenz fehlt oder ungültig ist, oder in den Client-Logs steht, dass BLENDER_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 abschließende 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 funktionieren nun nicht mehr, wenn sie mit Blender kommunizieren.
Lösung: Ein Update kann eine neue Version des Add-ons mit sich bringen. Installieren Sie es erneut über die Blender-Einstellungen (siehe die Installationsanleitung) und starten Sie Blender neu.
Der Client meldet, dass Node.js nicht gefunden wurde
Symptom: Ihr MCP-Client kann den Server nicht starten und in den Logs wird node erwähnt.
Lösung: Führen Sie Synthetic Setup erneut aus (dies installiert Node.js für Ihre MCP-Clients, falls es fehlt) oder installieren Sie Node.js (LTS) von nodejs.org und starten Sie den Client neu.
Einschränkungen
Was Blender MCP nicht kann oder womit es nicht getestet wurde. Wir sagen es hier, damit Sie es vor der Installation wissen.
- Getestet unter Windows mit Blender 5.1.2 und 5.2.2 LTS. macOS befindet sich in der Beta: Es wurde nicht vollständig getestet und kann Fehler enthalten. Linux und andere Blender-Versionen wurden noch nicht getestet.
- Blender muss geöffnet und das Add-on aktiviert sein, wann immer Ihr AI-Client ein Tool ausführt. Bitte arbeiten Sie mit jeweils nur einem geöffneten Blender-Fenster.
- Die Tools laufen im Haupt-Thread von Blender: Während eines langen Render- oder Simulationsvorgangs reagiert Blender nicht, bis dieser abgeschlossen ist. Wenn ein Tool in einen Timeout läuft, kann die von Blender bereits gestartete Arbeit dennoch beendet werden.
- Der Download-Service von Poly Haven ist für die nicht-kommerzielle Nutzung gedacht, es sei denn, Sie verfügen über deren kostenlose kommerzielle Lizenz. Für ambientCG-Assets (CC0) und Dateien, die Sie von Ihrer eigenen Festplatte laden, gibt es keine solche Einschränkung.
- Die Tools, die Python oder beliebige Operatoren innerhalb von Blender ausführen, können alles tun, was Blender kann, einschließlich des Löschens von Daten. Speichern Sie Ihre Arbeit regelmäßig und lassen Sie sich von Ihrem AI-Client fragen, bevor irreversible Änderungen vorgenommen werden.
- Das Add-on ist freie Software (GNU GPL Version 3), wie es Blender für Add-ons vorschreibt. Der MCP Server ist eine eigene Software von Synthetic und benötigt Ihren kostenlosen Lizenzschlüssel.
Wenn nichts davon hilft
Eröffnen Sie ein Ticket unter Ihr Support-Dashboard mit: (1) Ihrer Blender-Version, (2) Ihrem MCP-Client und dessen Version, (3) den Logs des Clients beim Startversuch des Servers und (4) dem kopierten Konfigurations-Snippet (ohne den Lizenzschlüssel). Sie können auch in unserem Discord fragen.