SyntheticSynthetic/Docs
ProdukteNeuigkeiten
Dashboard →

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

Blender5.1 oder 5.2 LTS
Node.js18 oder höher
OSWindows 10/11 · macOS (Beta: kann Fehler enthalten)
MCP-ClientClaude Desktop, Cursor, Codex oder ein beliebiger MCP-Client
LizenzIhr 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\.

Synthetic Setup kümmert sich auch um Node.js: Falls Node.js auf Ihrem Computer nicht vorhanden ist, wird es für Ihre MCP-Clients hinzugefügt.

3. Das Add-on in Blender aktivieren

Dies muss einmal pro Blender-Version durchgeführt werden:

  1. Öffnen Sie in Blender Bearbeiten → Einstellungen → Add-ons.
  2. Öffnen Sie das Menü oben rechts in der Liste, wählen Sie Von Festplatte installieren… und wählen Sie die Datei synthetic_blender_mcp.py aus dem Ordner von Schritt 2 aus.
  3. Ü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.

Das Add-on ist freie Software unter der GNU GPL Version 3, wie es Blender für Add-ons vorschreibt; der MCP Server ist eine eigene Software von Synthetic und benötigt Ihre Lizenz.

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.

Wichtig: Blender muss geöffnet sein und das Add-on muss aktiviert sein, wann immer Ihr MCP-Client ein Tool ausführt. Andernfalls antworten die Tools, dass Blender nicht verbunden ist.