Zum Hauptinhalt springen
Entwickler & API

Blender MCP mit innoGPT verbinden

Mit dem Blender MCP Server arbeitet innoGPT direkt mit Ihrer lokalen Blender Installation. So kann innoGPT zum Beispiel Objekte anlegen, Szenen verändern oder Informationen aus der aktuellen Datei auslesen. Der Server läuft lokal auf Ihrem Rechner. Sie binden ihn in der innoGPT Desktop App unter Gerät ein, danach startet innoGPT den Server selbst. Ein Terminal oder manuelles Starten ist nicht nötig.

Grundlage dieser Anleitung sind die offizielle Setup Dokumentation des Blender Projekts und die Projektseite der Blender Foundation.

Empfehlung zum KI Modell: Nutzen Sie für die Arbeit mit Blender ein leistungsstarkes Modell wie Claude Opus. Das Modell muss Blender Python Code schreiben und mehrere Werkzeugaufrufe nacheinander planen. Kleinere Modelle liefern dabei deutlich häufiger fehlerhafte oder unvollständige Ergebnisse.


Voraussetzungen

  • Blender 5.1 oder neuer ist installiert (Download).

  • innoGPT Desktop App ist installiert und Sie sind angemeldet.

  • uv ist installiert. uv ist ein Python Paketmanager, mit dem innoGPT den MCP Server startet. Installation laut uv Dokumentation:

    • Windows (PowerShell): powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"

    • macOS / Linux (Terminal): curl -LsSf https://astral.sh/uv/install.sh | sh

Nach der Installation von uv starten Sie die innoGPT Desktop App einmal neu, damit der Befehl gefunden wird.


Schritt 1: Blender Add-on installieren

Blender selbst kann keine Verbindung zu KI Modellen herstellen. Dafür brauchen Sie ein eigenes Add-on, das auf der Projektseite der Blender Foundation bereitsteht.

Variante A: Drag and Drop (empfohlen)

  1. Öffnen Sie Blender (5.1 oder neuer).

  2. Ziehen Sie den Link „Drag and Drop into Blender“ von der Projektseite in das Blender Fenster. Damit wird das Blender Lab Repository hinzugefügt.

  3. Ziehen Sie den Link ein zweites Mal in Blender. Jetzt wird das Add-on selbst installiert.

Bei dieser Variante meldet Blender automatisch, wenn eine neue Version des Add-ons verfügbar ist.

Variante B: Installation von der Festplatte

  1. Laden Sie das Add-on über „download“ auf der Projektseite herunter.

  2. Installieren Sie die Datei in Blender über die Add-on Einstellungen mit „Install from Disk“.

Danach: Prüfen Sie, ob das Add-on aktiviert ist, und lassen Sie Blender geöffnet. Der MCP Server kann nur mit Blender kommunizieren, solange Blender läuft.


Schritt 2: MCP Server Dateien bereitstellen

innoGPT startet den Server, die Serverdateien müssen dafür aber einmal auf Ihrem Rechner liegen. Git brauchen Sie dafür nicht.

  1. Öffnen Sie das Blender MCP Repository.

  2. Laden Sie den Quellcode als ZIP herunter.

  3. Entpacken Sie das Archiv:

    • Windows: nach C:\blender_mcp

    • macOS / Linux: in Ihren Benutzerordner, also z. B. /Users/IHR-NAME/blender_mcp bzw. /home/IHR-NAME/blender_mcp

Achten Sie darauf, dass sich im Ordner blender_mcp direkt der Unterordner mcp befindet. Beim Entpacken entsteht manchmal ein zusätzlicher Ordner (z. B. blender_mcp-main\blender_mcp). Benennen Sie ihn dann um oder passen Sie den Pfad in Schritt 3 an.


Schritt 3: MCP Server in innoGPT unter „Gerät“ eintragen

  1. Öffnen Sie die innoGPT Desktop App.

  2. Wechseln Sie zu den MCP Servern und wählen Sie Gerät.

  3. Legen Sie einen neuen MCP Server an und fügen Sie die passende Konfiguration als JSON ein:

Windows

{ "mcpServers": { "blender": { "command": "uv", "args": ["--directory", "C:\\blender_mcp\\mcp", "run", "blender-mcp"] } } }

macOS / Linux

{ "mcpServers": { "blender": { "command": "uv", "args": ["--directory", "/Users/IHR-NAME/blender_mcp/mcp", "run", "blender-mcp"] } } }

Wichtig:

  • Ersetzen Sie IHR-NAME durch Ihren Benutzernamen. Unter Linux lautet der Pfad /home/IHR-NAME/blender_mcp/mcp.

  • Verwenden Sie unter macOS und Linux den vollständigen Pfad statt $HOME, da Variablen nicht überall aufgelöst werden.

  • Unter Windows müssen die Backslashes im Pfad doppelt geschrieben werden (C:\\blender_mcp\\mcp).

  • Wenn Sie die Dateien an einem anderen Ort entpackt haben, passen Sie den Pfad entsprechend an.

  1. Speichern und aktivieren Sie den Server. innoGPT startet ihn ab jetzt automatisch.


Schritt 4: Verbindung testen

  1. Stellen Sie sicher, dass Blender mit aktivem Add-on geöffnet ist.

  2. Starten Sie in innoGPT einen neuen Chat, wählen Sie ein starkes Modell wie Claude Opus und aktivieren Sie den Blender MCP Server.

  3. Testen Sie die Verbindung mit einer einfachen Anfrage, zum Beispiel:

    • „Welche Objekte sind in meiner aktuellen Blender Szene?“

    • „Füge einen Würfel an Position 0, 0, 2 hinzu.“

Wenn innoGPT die Szene ausliest bzw. der Würfel in Blender erscheint, ist die Verbindung eingerichtet.

Beispiel Prompts der Blender Foundation

Diese Anwendungsfälle hat die Blender Foundation getestet, unter anderem mit der Demo Datei „Scattering Pebbles“. Wie gut sie funktionieren, hängt stark vom gewählten KI Modell ab, daher die Empfehlung für Modelle wie Claude Opus. Die Prompts sollten vollständig übernommen werden.

Anwendungsfall

Prompt

Szene auf Performance prüfen

Analyze the scene and list the outliers: objects with highest polygon count but smaller size from the camera point of view.

Tippfehler in Namen korrigieren

With the current open Blender file fix the name of all the data-blocks to remove typos. Report back which data-blocks got fixed.

Bessere Namen vorschlagen

With the current open Blender file suggest descriptive names for all data-blocks, and apply if approved.

Material Verwendung abfragen

Which objects are using the following material: pebbles

Objekt mit den meisten Polygonen finden

What is the object with the highest poly-count on this file? Ignore objects which are not linked to any scene.

Geometry Nodes dokumentieren

With the current open Blender file explain what the main geometry nodes setup is doing. Add inline documentation for it with frame elements. Create a Text data-block with the result of analysis.

Ergebnisse prüfen: Laut Blender Foundation können Analysen unvollständig sein. Im Beispiel der Classroom Szene hat das Modell zunächst einen Solidify Modifier übersehen. Kontrollieren Sie Ergebnisse, bevor Sie Änderungen übernehmen.


Fehlerbehebung

Problem

Mögliche Ursache und Lösung

Server startet nicht, „uv nicht gefunden“

uv ist nicht installiert oder nicht im Systempfad. uv installieren und die Desktop App neu starten. Alternativ den vollständigen Pfad zu uv als Befehl eintragen (Pfad per where uv unter Windows oder which uv unter macOS/Linux ermitteln).

Server startet, aber keine Antwort aus Blender

Blender ist nicht geöffnet oder das Add-on ist nicht aktiviert.

Fehlermeldung zum Verzeichnis

Pfad stimmt nicht. Prüfen, ob der Ordner blender_mcp\mcp am angegebenen Ort existiert (zusätzlichen Ordner nach dem Entpacken beachten).

macOS / Linux: Pfad wird nicht gefunden

$HOME durch den vollständigen Pfad ersetzen.

Add-on lässt sich nicht installieren

Blender Version prüfen, benötigt wird 5.1 oder neuer.


Weitere Informationen


Updates

  • MCP Server: neue Version herunterladen, den alten Ordner blender_mcp ersetzen und den Server in innoGPT neu starten.

  • Add-on: Bei Installation per Drag and Drop meldet Blender Updates automatisch