„Blender MCP“ meint meistens MCP for Blender, ein Open-Source-Projekt von Siddharth Ahuja, mit dem ein KI-Agent ein laufendes Blender steuern kann. Bis November 2026 hieß es blender-mcp, und die meisten Tutorials nutzen noch diesen Namen. Ist es verbunden, können Claude Code, Codex, Cursor oder Claude Desktop per Chat-Prompt Objekte erstellen und bearbeiten, Materialien zuweisen, den Viewport ansehen und Dateien exportieren.

Diese Anleitung erklärt, was es ist und wie du es in Claude Code und Codex installierst. Dazu gibt es ein vollständiges Beispiel: Ein Agent baut in Blender ein Low-Poly-Spielobjekt, exportiert es als GLB, die Datei wird mit glTF-Transform komprimiert, und three.js lädt sie in einem Browserspiel. Wir haben jeden Befehl am 21. November 2026 mit der README des Projekts und den offiziellen Docs abgeglichen. Die Installation und das Beispiel haben wir selbst nicht ausgeführt. Die unten beschriebenen Ergebnisse sind also das, was laut Dokumentation passieren sollte.

Was Blender MCP ist

MCP (Model Context Protocol) ist ein Standard, der einem KI-Agenten Werkzeuge gibt, mit denen er ein anderes Programm steuert. MCP for Blender besteht aus zwei Teilen:

  • Ein Blender-Add-on, das in Blender einen Socket-Server öffnet (standardmäßig Port 9876) und die empfangenen Befehle ausführt.
  • Ein MCP-Server (das Python-Paket mcp-for-blender), den dein Agent im Hintergrund startet. Er reicht die Tool-Aufrufe des Agenten an das Add-on weiter.

Der Agent arbeitet meist so, dass er Blender-Python schreibt und in deiner geöffneten Blender-Datei ausführt. Die README listet neun Tools. Am häufigsten siehst du execute_blender_code (Python in Blender ausführen), look (Viewport-, Kamera- oder Mehrwinkelansichten, damit der Agent seine Arbeit selbst prüfen kann), get_scene_info (eine Zusammenfassung der Szene) sowie search_assets / import_asset (Modelle, Texturen und HDRIs von Poly Haven, Sketchfab und Poly Pizza holen). Dazu kommt generate_3d, das mit Meshy, Tripo, Hunyuan3D oder Hyper3D Rodin ein Modell erzeugt.

Es stammt nicht von Blender. Die README beginnt mit „This is a third-party integration and not made by Blender“, und die GitHub-Beschreibung sagt „Not affiliated with the official Blender Foundation.“ Es steht unter der MIT-Lizenz und hatte am 21. November 2026 35.153 GitHub-Sterne.

Blender hat aber einen eigenen MCP-Server. Blender Lab, Teil des Blender-Projekts, veröffentlicht einen kleineren unter projects.blender.org/lab/blender_mcp, dokumentiert auf blender.org/lab/mcp-server. Seine Readme nennt ihn „deliberately small“. Er konzentriert sich auf die Python-API-Dokumentation von Blender, Zusammenfassungen von Szenen und Dateien, Screenshots und das Ausführen von Code. Er braucht Blender 5.1 oder neuer, steht unter GPL-3.0 und war im September 2026 bei Version 1.0.3. Im Connector-Verzeichnis von Claude ist er außerdem als „Blender“ von Blender Lab gelistet. Mehr dazu unter Alternativen.

Was du brauchst

  • Blender 3.0 oder neuer für MCP for Blender (das Add-on gibt 3.0 als Minimum an).
  • Python 3.10 oder neuer und uv, das Tool, das den Server mit uvx startet. Der Einzeiler-Installer unten installiert uv für dich.
  • Einen MCP-fähigen Agenten: Claude Code, Codex, Cursor, Claude Desktop, VS Code, OpenCode, Windsurf oder Antigravity, laut README.
  • Für den Spiele-Teil: Node.js (für glTF-Transform) und ein three.js-Projekt.

Die Schnellinstallation (alle Clients auf einmal)

Der von der README empfohlene Weg ist ein einziger Befehl. Er installiert uv, findet die Agenten auf deinem Rechner, lässt dich wählen, welche eingerichtet werden, und installiert und aktiviert das Blender-Add-on. Er fügt in jeder Konfigurationsdatei nur einen Eintrag blender hinzu und legt von jeder geänderten Datei eine .bak-Kopie an.

macOS / Linux:

curl -LsSf https://www.mcp-for-blender.com/install.sh | sh

Windows (PowerShell):

irm https://www.mcp-for-blender.com/install.ps1 | iex

Wenn du uv schon hast:

uvx mcp-for-blender setup

Ein Skript aus dem Internet direkt in die Shell zu leiten, führt es mit den Rechten deines Benutzers aus. Wenn du das nicht willst, nimm die manuellen Schritte unten, die dasselbe Stück für Stück erledigen. In beiden Fällen musst du deinen Agenten danach komplett beenden und neu öffnen.

Blender MCP in Claude Code installieren

  1. Installiere uv. Die README nennt brew install uv für macOS, curl -LsSf https://astral.sh/uv/install.sh | sh für Linux und winget install --id=astral-sh.uv -e für Windows. Sie warnt vor pip install uv, weil dabei eventuell der Befehl uvx nicht angelegt wird.
  2. Registriere den Server in Claude Code. Das ist der Befehl aus der README:
claude mcp add blender uvx mcp-for-blender
  1. Prüfe ihn. Die MCP-Docs von Claude Code nennen claude mcp list (zeigt einen Status wie „✔ Connected“) und claude mcp get blender, und das Panel /mcp in einer Sitzung zeigt dasselbe.

Standardmäßig speichert claude mcp add den Server nur für das aktuelle Projekt. Mit --scope user gilt er in jedem Projekt. Die allgemeine Form in den Docs setzt den Server-Befehl hinter --: claude mcp add [options] <name> -- <command> [args...]. Das -- brauchst du, sobald du Optionen wie --scope oder --env angibst.

Um die anonyme Nutzungstelemetrie des Projekts abzuschalten, setzt du laut README für den Server die Umgebungsvariable DISABLE_TELEMETRY=true. In Claude Code übergibst du sie mit --env vor dem --.

Blender MCP in Codex installieren

Die Codex-CLI, die Codex-Desktop-App und die IDE-Erweiterung teilen sich eine Konfigurationsdatei, ~/.codex/config.toml. Eine Einrichtung deckt also alle drei ab.

Normaler MCP-Server. Der Befehl aus der README:

codex mcp add blender -- uvx mcp-for-blender

Oder trage ihn von Hand in ~/.codex/config.toml ein:

[mcp_servers.blender]
command = "uvx"
args = ["mcp-for-blender"]

Führe codex mcp list aus und prüfe, dass blender als aktiviert angezeigt wird. Die Tools erscheinen beim nächsten Start von Codex, und /mcp in der Codex-Terminaloberfläche listet die aktiven Server. Die MCP-Docs von OpenAI zu Codex beschreiben außerdem eine env-Tabelle für Umgebungsvariablen, startup_timeout_sec (Standard 10) und tool_timeout_sec (Standard 60). In der Desktop-App gehst du auf Settings → MCP servers → Add server, nennst ihn blender, wählst STDIO und gibst uvx mcp-for-blender ein.

Codex-Plugin. Die README empfiehlt diesen Weg für Codex. Er bringt einen Live-Blender-Viewport in den Chat, Vorschaubilder zur Auswahl für Poly Haven, Sketchfab und Poly Pizza sowie @-Erwähnungen für Szenenobjekte. Es steht noch nicht im Plugin-Verzeichnis von Codex, du fügst es also aus dem Repo hinzu:

git clone https://github.com/ahujasid/blender-mcp.git
codex plugin marketplace add ./blender-mcp/integrations/codex

Starte Codex dann neu, installiere MCP for Blender aus dem Plugin-Verzeichnis und bitte Codex, es zu benutzen.

Cursor und andere

In Cursor öffnest du Settings → MCP und fügst einen globalen Server hinzu, oder du legst in deinem Projekt .cursor/mcp.json an, mit diesem Inhalt:

{
    "mcpServers": {
        "blender": {
            "command": "uvx",
            "args": [
                "mcp-for-blender"
            ]
        }
    }
}

Unter Windows nutzt die README "command": "cmd" mit "args": ["/c", "uvx", "mcp-for-blender"]. Die README hat außerdem Ein-Klick-Installationsbuttons für Cursor und VS Code sowie Konfigurationsblöcke für Claude Desktop, OpenCode und Antigravity. Sie sagt, dass immer nur eine Kopie des Servers laufen soll, zum Beispiel Cursor oder Claude Desktop, aber nicht beide.

Das Blender-Add-on verbinden

Der Schnellinstaller erledigt das für dich. Von Hand geht es so:

  1. Führe uvx mcp-for-blender install-addon aus. Es kopiert das Add-on als blender_mcp.py in deinen Blender-Add-on-Ordner.
  2. Öffne in Blender Edit → Preferences → Add-ons und aktiviere Interface: MCP for Blender. Wenn es nicht erscheint, starte Blender neu oder klicke auf Install… und wähle die kopierte Datei. Du kannst auch addon.py aus dem Repo herunterladen und installieren.
  3. Drücke im 3D-Viewport N, um die Seitenleiste zu öffnen, und such den Tab MCP for Blender. Das Add-on startet seinen Server, wenn Blender öffnet. Läuft er nicht, klicke auf Start MCP Server.

Im Tab des Add-ons schaltest du optionale Funktionen ein, etwa Poly Haven, Poly Pizza (braucht einen kostenlosen API-Schlüssel) und die 3D-Generatoren.

Wenn sich dein Agent nicht verbinden kann: Achte darauf, dass Blender mit laufendem Add-on offen ist, und starte uvx mcp-for-blender nicht selbst in einem Terminal (das steht in der Troubleshooting-Tabelle der README). Apps, die aus dem Dock oder dem Startmenü starten, finden uvx womöglich nicht und scheitern mit spawn uvx ENOENT. Das behebst du, indem du als Befehl den vollen Pfad aus which uvx (macOS/Linux) oder where uvx (Windows) einträgst. Hilft das nicht, starte Agent und Blender neu.

Ein vollständiges Beispiel: ein Low-Poly-Spielobjekt vom Prompt bis three.js

Ziel: eine Schatztruhe für ein Browserspiel, klein genug für schnelles Laden, in einem Format, das three.js direkt liest. Wir haben diesen Ablauf nach den Docs geschrieben und nicht komplett durchgespielt, Dateigrößen und genaue Ergebnisse werden also abweichen.

1. Speichere zuerst deine Blender-Datei

Öffne eine neue Blender-Datei und speichere sie (zum Beispiel als chest.blend), bevor der Agent loslegt. Der Agent ändert deine Datei direkt, und die eigene Warnung der README lautet, immer zuerst die Arbeit zu speichern.

2. Gib dem Agenten den Prompt

In Claude Code oder Codex, mit offenem und verbundenem Blender:

Use the Blender MCP tools. In the current scene, build a low-poly treasure chest
for a browser game:
- About 1 m wide, 0.6 m deep, 0.7 m tall, sitting on the ground at z = 0,
  origin at the bottom centre.
- A box body and a curved lid made from a half-cylinder with 8 segments,
  plus metal bands and a lock plate. Keep it under 1,500 triangles.
- Flat-shaded materials using Principled BSDF base colours only
  (dark wood, brass), no image textures.
- Apply all modifiers and transforms, join everything into one object named "Chest".
- Check it with the look tool from several angles and fix anything that
  overlaps or floats.
- Then select only "Chest" and export it as a GLB to ./public/models/chest.glb.
Show me each script before you run it.

Ein paar Entscheidungen in diesem Prompt sind für Spiele wichtig. Einfache Grundfarben exportieren sauber, weil der glTF-Exporter die Grundfarbe aus dem Principled-BSDF-Node übernimmt, laut Blenders glTF-Handbuch. Ein zusammengefügtes Objekt ergibt in three.js ein einziges Mesh. Liegt der Ursprung unten, steht die Truhe auf dem Boden, wenn du ihre Position auf y = 0 setzt. Ein Dreiecksbudget hindert den Agenten daran, Unterteilung hinzuzufügen.

3. Der Export-Schritt

Der Agent schreibt das Blender-Python. Der Export endet meist mit einem Aufruf wie diesem, der die Parameter aus Blenders export_scene-API nutzt:

import bpy

bpy.ops.export_scene.gltf(
    filepath="/path/to/your-game/public/models/chest.glb",
    export_format='GLB',   # single binary file: mesh, materials and images packed together
    use_selection=True,    # only the selected "Chest" object
    export_apply=True,     # apply modifiers on export
    export_yup=True,       # glTF's +Y up convention, which three.js also uses
)

Lies dieses Skript, bevor du es freigibst, wie jedes Skript, das der Agent ausführt. Prüfe, dass der Pfad in dein Projekt zeigt und nichts Dateien löscht oder überschreibt, die dir wichtig sind.

4. Die GLB mit glTF-Transform komprimieren

glTF-Transform ist ein Kommandozeilenwerkzeug zum Optimieren von glTF-Dateien. Installiere es und führe optimize aus. Das sind die Befehle aus seiner README:

npm install --global @gltf-transform/cli
gltf-transform optimize input.glb output.glb --texture-compress webp

Für unsere Truhe:

gltf-transform optimize public/models/chest.glb public/models/chest.opt.glb --texture-compress webp

Standardmäßig komprimiert optimize die Geometrie mit meshopt (--compress meshopt), begrenzt Texturen auf 2048 px und flacht den Szenengraphen ab. Unsere Truhe hat keine Bildtexturen, --texture-compress webp hat hier also nichts zu tun, aber lass es für Objekte mit Texturen drin. Um nur die Geometrie zu komprimieren, gibt es in glTF-Transform auch gltf-transform meshopt input.glb output.glb --level medium.

5. In three.js laden

Eine mit meshopt komprimierte Datei braucht den Meshopt-Decoder. Ohne ihn wirft GLTFLoader „setMeshoptDecoder must be called before loading compressed files“. Die Imports unten sind die aus den eigenen Beispielen von three.js:

import { GLTFLoader } from 'three/addons/loaders/GLTFLoader.js';
import { MeshoptDecoder } from 'three/addons/libs/meshopt_decoder.module.js';

const loader = new GLTFLoader();
loader.setMeshoptDecoder(MeshoptDecoder);

const gltf = await loader.loadAsync('/models/chest.opt.glb');
const chest = gltf.scene;
chest.position.set(0, 0, -3); // origin is at the bottom, so y = 0 puts it on the floor
scene.add(chest);

Blender rechnet in Metern, und die meisten three.js-Szenen auch, die Truhe sollte also etwa 1 m breit geladen werden. Liegt sie auf der Seite, lief der Export wahrscheinlich ohne export_yup. Ist sie schwarz, braucht deine Szene Licht: Füge ein HemisphereLight oder eine Environment-Map hinzu.

6. Iterieren

Lass Blender offen und bitte um Änderungen, zum Beispiel „Der Deckel soll sich als eigenes Objekt namens Lid um 40 Grad öffnen“ oder „Füge einen Goldhaufen im Inneren hinzu“. Führe dann Export und den optimize-Befehl erneut aus. Bitte den Agenten, das Export-Skript in deinem Projekt zu behalten, damit du jedes Mal dieselben Einstellungen bekommst.

Grenzen und Sicherheit

  • Es führt beliebiges Python in Blender aus. Die Warnung der README: „The execute_blender_code tool allows running arbitrary Python code in Blender, which can be powerful but potentially dangerous.“ Python in Blender kann jede Datei lesen und schreiben, auf die dein Benutzerkonto Zugriff hat. Bitte den Agenten, Skripte vor dem Ausführen zu zeigen, und lies sie.
  • Speichere deine Datei vor jeder Sitzung. Dieselbe Warnung endet mit: „ALWAYS save your work before using it.“ Speichere Versionen unterwegs (File → Save Incremental).
  • Schalte den Safe Mode ein, wenn du keinen Datei- oder Netzwerkzugriff brauchst. Setze BLENDER_MCP_SAFE_MODE=1 für den Server. Jedes Skript wird dann vor dem Ausführen geprüft, und Code, der direkt Dateien liest oder schreibt, andere Programme startet, das Netzwerk nutzt oder nach Ende des Skripts weiterläuft, wird blockiert. Modellieren, Materialien, Rendern, Speichern sowie Import und Export funktionieren weiter.
  • Halte es auf localhost. Der Socket des Add-ons hat weder Authentifizierung noch Verschlüsselung. Wer diesen Port erreicht, kann Python in deinem Blender ausführen. Mach ihn nicht in einem Netzwerk zugänglich, dem du nicht traust.
  • Zerlege große Aufgaben in Schritte. Die README sagt, komplexe Operationen brauchen eventuell kleinere Schritte, und Timeouts löst man durch eine einfachere Anfrage. Downloads von Poly Haven laufen im Hauptthread von Blender, Blender friert also ein, bis sie fertig sind.
  • Prüfe die Lizenzen der Assets. Poly Haven ist CC0. Etwa 69 % von Poly Pizza sind CC-BY, was eine Namensnennung verlangt. Das Add-on schreibt die Nennung auf importierte Objekte, oder du suchst mit licence="CC0".
  • Telemetrie. Standardmäßig sendet der Server einen anonymen Nutzungsdatensatz: Installations-ID, Sitzungs-ID, Tool-Name, Erfolg, Dauer, Versionen, Betriebssystem und Zeitstempel. Deine Prompts, dein Code, Screenshots und Szenendaten werden nur erfasst, wenn du zustimmst. DISABLE_TELEMETRY=true schaltet alles ab.

Alternativen zu Blender MCP

  • Blender Labs Blender MCP: der Server von Blender selbst. Er ist kleiner und baut auf Python-API-Docs, Zusammenfassungen von Szenen und Dateien, Screenshots und dem Ausführen von Code auf, einschließlich eines Hintergrundmodus für .blend-Dateien. Er braucht Blender 5.1+ und steht unter GPL-3.0. Sein Wiki richtet ihn ein, indem du das Repo klonst und ihn mit uv --directory .../blender_mcp/mcp run blender-mcp startest. Nimm ihn, wenn du das offizielle Projekt willst und keine Asset-Suche oder KI-Modellgenerierung brauchst.
  • Blender Agent Skills: 28 Skills für Blender 5.2 LTS+ (Modellieren, UVs, Baking, Rigging, Animation, Optimierung, Export) für Claude Code, Codex, OpenCode, Gemini CLI, Copilot und Cursor. MIT. Skills bringen dem Agenten bei, wie die Arbeit geht. Ein MCP-Server gibt ihm die Kontrolle über Blender. Du kannst beides nutzen.
  • blender-game-skills: Claude-Code-Skills, die aus Konzeptzeichnungen geriggte, spielfertige 3D-Assets machen. MIT.
  • Fertige Modelle. Für gängige Objekte ist ein kostenloses Modell oft schneller als ein generiertes. Siehe Low-Poly-GLBs von Polyfork.

Unsere Liste mit Agent-Skills und MCP-Servern für Spieleentwicklung deckt die Entsprechungen für Godot, Unity, Unreal und three.js ab.

FAQ

Ist Blender MCP kostenlos?

Ja. MCP for Blender steht unter der MIT-Lizenz, und das Add-on ist kostenlos. Auf der Premium-Seite steht, dass jede Funktion im kostenlosen Tarif läuft und nur die 3D-Generierung kostenpflichtig ist. Du kannst Meshy, Tripo, Hunyuan3D, Hyper3D Rodin oder World Labs mit eigenen API-Schlüsseln nutzen oder Premium kaufen (ab 10 $/Monat am 21. November 2026), um sie ohne Schlüssel zu verwenden. Der Server von Blender Lab ist unter GPL-3.0 kostenlos. Das Abo oder die API-Nutzung deines KI-Agenten bezahlst du weiterhin.

Ist Blender MCP sicher?

Es ist so sicher wie der Code, den du ausführen lässt. Der Agent führt Python in Blender aus, und dieses Python hat den Dateizugriff deines Benutzers. Speichere deine Arbeit, lies Skripte vor der Freigabe, nutze den Safe Mode (BLENDER_MCP_SAFE_MODE=1) und lass den Port des Add-ons auf localhost. Installiere es aus dem offiziellen Repo oder mit dem Installationsskript des Projekts, nicht aus einer Kopie, die jemand neu hochgeladen hat.

Gibt es einen offiziellen Blender-MCP-Server?

Ja. Blender Lab veröffentlicht einen unter projects.blender.org/lab/blender_mcp, und das Connector-Verzeichnis von Claude listet ihn als „Blender“ von Blender Lab. Das bekanntere MCP for Blender (früher blender-mcp) ist ein Drittanbieter-Projekt ohne Verbindung zur Blender Foundation.

Funktioniert Blender MCP mit Claude Code?

Ja. Führe claude mcp add blender uvx mcp-for-blender aus, öffne Blender mit aktiviertem Add-on und prüfe mit claude mcp list. Claude Desktop richtest du stattdessen mit einem JSON-Block in claude_desktop_config.json ein.

Funktioniert Blender MCP mit Codex?

Ja. Führe codex mcp add blender -- uvx mcp-for-blender aus oder füge [mcp_servers.blender] in ~/.codex/config.toml ein. Die README bietet außerdem ein Codex-Plugin, das neben dem Chat einen Live-Blender-Viewport zeigt.

Funktioniert Blender MCP mit ChatGPT?

Die README nennt Desktop- und Coding-Clients (Claude Desktop, Claude Code, Codex, Cursor, VS Code, Windsurf, OpenCode, Antigravity), nicht die ChatGPT-App. Codex ist dafür der Agent von OpenAI. Der Server spricht mit einem Blender auf deinem eigenen Rechner, du brauchst also einen Client, der einen lokalen MCP-Server starten kann.

Wo ist der Blender-MCP-Tab?

Drücke im 3D-Viewport von Blender N, um die Seitenleiste zu öffnen. Der Tab heißt MCP for Blender. Fehlt er, aktiviere Interface: MCP for Blender unter Edit → Preferences → Add-ons.

Blender MCP oder ein Blender-Skill?

Ein MCP-Server lässt den Agenten auf ein laufendes Blender einwirken: Objekte erstellen, den Viewport ansehen, exportieren. Ein Skill bringt dem Agenten Blender-Abläufe und Konventionen bei, was hilft, egal ob er danach über MCP arbeitet oder Blender headless von der Kommandozeile startet. Für Spiel-Assets funktioniert beides zusammen gut. Der MCP-Server baut, und ein Skill-Paket wie Blender Agent Skills deckt UVs, Optimierung und Export-Einstellungen ab.

Quellen

Geprüft am 21. November 2026: mcp-for-blender README, MCP for Blender Premium, Blender Lab blender_mcp und sein Setup-Wiki, Claude Code MCP docs, Codex MCP docs, Blender export_scene API, Blender glTF 2.0 manual, glTF-Transform CLI, three.js GLTFLoader.