Blender MCP · Installation
Installation von Blender MCP
Blender MCP ist ein Server, der auf Ihrem Computer läuft und von Ihrem MCP-Client (Claude Desktop, Cursor, Claude Code, Codex) gestartet wird. Sie installieren ihn mit dem Synthetic Setup. Er kommuniziert mit Blender über das Synthetic Blender MCP Add-on, das Sie einmalig in Blender aktivieren. Verifiziert unter Windows.
Voraussetzungen
| Blender | 5.1 oder 5.2 LTS |
| Node.js | 18 oder höher |
| OS | Windows 10/11 · macOS (Beta: kann Fehler enthalten) |
| MCP-Client | Claude Desktop, Cursor, Codex oder ein beliebiger MCP-Client |
| Lizenz | Ihr Blender MCP Lizenzschlüssel (siehe /dashboard/licenses) |
1. Mit Synthetic Setup installieren
Laden Sie das Synthetic Setup von /dashboard/downloads herunter und führen Sie es aus. Es findet Ihre MCP-Clients (Claude Desktop, Cursor, Claude Code, Codex) und fügt Blender MCP mit Ihrer bereits geladenen Lizenz zu jedem einzelnen hinzu.
Möchten Sie die Konfiguration Ihres Clients lieber manuell bearbeiten? Unter Einrichtungsleitfaden für MCP-Clients finden Sie den exakten Eintrag.
2. Starten Sie Ihren MCP-Client neu
Beenden Sie Ihren MCP-Client und öffnen Sie ihn erneut: Server werden beim Start geladen. Beim ersten Mal wird der Server in wenigen Sekunden heruntergeladen und hinterlässt nach der Lizenzprüfung das Blender-Add-on auf Ihrem Computer in C:\Users\YOUR_USER\.synthetic\mcp\blender-mcp\<version>\blender-addon\.
3. Das Add-on in Blender aktivieren
Dies muss einmal pro Blender-Version durchgeführt werden:
- Öffnen Sie in Blender Bearbeiten → Einstellungen → Add-ons.
- Öffnen Sie das Menü oben rechts in der Liste, wählen Sie Von Festplatte installieren… und wählen Sie die Datei
synthetic_blender_mcp.pyaus dem Ordner von Schritt 2 aus. - Überprüfen Sie, ob „Synthetic Blender MCP“ in der Liste aktiviert ist.
Das Add-on startet bei jedem Blender-Start automatisch. Den Status finden Sie in der Seitenleiste des 3D-Viewports (N drücken) → Tab Synthetic MCP.
4. Ausprobieren
Fragen Sie Ihren MCP-Client bei geöffnetem Blender etwas Einfaches:
Welche Version von Blender ist geöffnet und welche Objekte befinden sich in der Szene?Wenn die Antwort Ihre Blender-Version und Ihre Objekte enthält, funktioniert alles. Probieren Sie dann etwas Größeres aus: Erstellen Sie eine kleine Szene, beleuchten Sie diese und rendern Sie sie.