Blog · Coding-Agenten

Blender MCP: Installation in Claude Code und Codex

Blender MCP ist ein MCP-Server samt Blender-Add-on, mit dem ein KI-Agent wie Claude Code oder Codex eine laufende Blender-Instanz steuern kann, meist indem er Blender-Python schreibt und in deiner geöffneten Datei ausführt. Gemeint ist damit in der Regel mcp-for-blender, ein Community-Projekt von Siddharth Ahuja (früher blender-mcp); Blender Lab, Teil des Blender-Projekts, veröffentlicht außerdem einen kleineren offiziellen Server. Dieser Leitfaden erklärt, worin sich die beiden unterscheiden, nennt die Installationsbefehle für Claude Code und Codex, zeigt an einem kurzen Beispiel, wie ein Agent ein Low-Poly-Requisit baut und ein GLB exportiert, und behandelt, was du absichern solltest, bevor du ihn laufen lässt. Aktualisiert am 21. November 2026.

Was Blender MCP ist

MCP (Model Context Protocol) gibt einem Agenten Tools, die auf ein anderes Programm wirken. Beide Blender-MCP-Projekte bestehen aus denselben zwei Teilen: einem Add-on, das einen kleinen Server in Blender betreibt, und einem MCP-Server, den dein Agent startet und der seine Tool-Aufrufe als JSON über einen TCP-Socket an das Add-on weiterreicht.

Das Projekt, das die meisten meinen, ist mcp-for-blender. Sein README beginnt mit dem Hinweis, dass es eine Drittanbieter-Integration ist und nicht von Blender stammt. Es steht unter der MIT-Lizenz, hatte am 21. November 2026 35.153 GitHub-Sterne, und sein PyPI-Paket wurde von blender-mcp in mcp-for-blender umbenannt (Version 2.3.1 am 18. November); uvx blender-mcp startet den Server weiterhin, ältere Konfigurationen funktionieren also weiter.

Das blender_mcp von Blender Lab ist das offizielle. Sein Readme nennt es einen schlanken Server, bewusst klein, gedacht für eine Schnittstelle in natürlicher Sprache zu Blenders Python-API, besseren Zugriff auf die Dokumentation und das Erkunden komplexer Szenen. Er ist im Connector-Verzeichnis von Claude als Blender, erstellt von Blender Lab, von Anthropic verifiziert, aufgeführt.

mcp-for-blender gegen Blender Labs blender_mcp

Angaben aus den Repositories auf GitHub und projects.blender.org vom 21. November 2026.

mcp-for-blender (Community)blender_mcp (Blender Lab)
Entwickelt vonSiddharth Ahuja; ohne Verbindung zur Blender FoundationBlender Lab, Teil des Blender-Projekts
LizenzMITGPL-3.0
Blender-Version3.0 oder neuer5.1 oder neuer
Sterne35.153 auf GitHub39 auf projects.blender.org
ToolsNeun, darunter execute_blender_code, look (Viewport- und Kameraansichten), get_scene_info, Asset-Suche und -Import (Poly Haven, Sketchfab, Poly Pizza) und generate_3d (Tripo, Hunyuan3D, Hyper3D Rodin, Meshy)execute_blender_code, execute_blender_code_for_cli (Blender im Hintergrund), Zusammenfassungen von Blend-Dateien und Objekten, get_python_api_docs, Screenshots; bringt Auszüge aus Python-API und Handbuch mit
InstallationEin-Befehl-Installer oder uvx mcp-for-blender; eingebaute Einrichtung für Claude Code, Codex, Cursor und weitereRepo per git clone holen und mit uv starten; Add-on in Blender hinzufügen
Am besten fürSzenen aufbauen und ausstatten, Assets einbinden, Modelle generierenDateien untersuchen und Fragen zu Blenders API stellen, auf aktuellem Blender

Schnellinstallation: alle deine Agenten auf einmal

Der empfohlene Weg im README von mcp-for-blender ist ein einziger Befehl. Er installiert bei Bedarf uv, findet die MCP-Clients auf deinem Rechner (Claude Desktop, Claude Code, Codex, Cursor, VS Code, Windsurf, OpenCode, Antigravity), lässt dich auswählen, welche eingerichtet werden sollen, und installiert und aktiviert dann das Blender-Add-on. Er fügt jeder Konfiguration nur einen blender-Eintrag hinzu und legt von jeder geänderten Datei eine .bak an. Beende danach deinen Agenten vollständig und starte ihn neu.

Die folgenden Befehle sind aus dem README kopiert; wir haben sie nicht ausgeführt. Ein Skript in die Shell zu pipen führt es mit deinen Rechten aus. Wenn du jeden Schritt sehen möchtest, nimm stattdessen die manuelle Einrichtung in den nächsten zwei Abschnitten.

  • 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
  • Mit bereits installiertem uv: uvx mcp-for-blender setup
  • Du brauchst Blender 3.0 oder neuer, Python 3.10 oder neuer und uv.

Blender MCP in Claude Code installieren

Manuelle Einrichtung von mcp-for-blender. Die Befehle sind aus dem Projekt-README und der Claude-Code-MCP-Dokumentation kopiert; wir haben sie nicht ausgeführt.

  1. uv installieren

    uv liefert den Befehl uvx, der den Server startet. Das README rät von pip install uv ab; nimm den offiziellen Installer.

    # macOS
    brew install uv
    
    # Linux
    curl -LsSf https://astral.sh/uv/install.sh | sh
    
    # Windows
    winget install --id=astral-sh.uv -e
  2. Server registrieren

    Das speichert den Server für das aktuelle Projekt. Mit --scope user gilt er überall; Optionen dieser Art stehen vor einem --, das sie vom Server-Befehl trennt. So macht es auch die Claude-Code-Dokumentation. In einer Session zeigt /mcp denselben Status an.

    # der Befehl aus dem README
    claude mcp add blender uvx mcp-for-blender
    
    # prüfen: der Server sollte als verbunden angezeigt werden
    claude mcp list
    claude mcp get blender
  3. Optional: Telemetrie ausschalten

    Laut README setzt du DISABLE_TELEMETRY=true in der Umgebung des Servers, um die Telemetrie komplett abzuschalten. claude mcp add von Claude Code nimmt Umgebungsvariablen mit --env entgegen; die genaue Form steht in der Claude-Code-MCP-Dokumentation.

  4. Blender-Add-on installieren und aktivieren

    Öffne dann in Blender Edit → Preferences → Add-ons und aktiviere „Interface: MCP for Blender“. Drücke N im 3D-Viewport und öffne den Tab MCP for Blender; der Server startet mit Blender, und falls er nicht läuft, klicke auf Start MCP Server.

    # kopiert das Add-on als blender_mcp.py in Blenders Add-on-Ordner (legt eine .bak an)
    uvx mcp-for-blender install-addon
    
    # listet die gefundenen Add-on-Ordner auf
    uvx mcp-for-blender addon-paths

Blender MCP in Codex installieren

Codex CLI, Desktop-App und IDE-Erweiterung teilen sich ~/.codex/config.toml, eine Einrichtung deckt also alle drei ab. Die Befehle sind aus dem README und der Codex-MCP-Dokumentation von OpenAI kopiert; wir haben sie nicht ausgeführt. Installiere uv und das Blender-Add-on wie in den Claude-Code-Schritten.

  1. Server mit der CLI hinzufügen

    Codex zeigt die Tools beim nächsten Start an; /mcp in der Codex-Terminaloberfläche listet die aktiven Server auf. In der Desktop-App ist es Settings → MCP servers → Add server, Name blender, STDIO, Befehl uvx mcp-for-blender.

    # der Befehl aus dem README
    codex mcp add blender -- uvx mcp-for-blender
    
    # prüfen: blender sollte als aktiviert angezeigt werden
    codex mcp list
  2. Oder config.toml bearbeiten

    Die Tabelle [mcp_servers.blender] stammt aus dem README. Die Zeile env folgt der Codex-Dokumentation, die env, startup_timeout_sec (Standard 10) und tool_timeout_sec (Standard 60) als Tabellenschlüssel aufführt; erhöhe tool_timeout_sec, wenn lange Blender-Vorgänge in ein Timeout laufen.

    # oder von Hand in ~/.codex/config.toml (gemeinsam genutzt von Codex CLI, Desktop-App und IDE-Erweiterung)
    [mcp_servers.blender]
    command = "uvx"
    args = ["mcp-for-blender"]
  3. Optional: das Codex-Plugin

    Das README empfiehlt es für Codex: Es zeigt einen Live-Blender-Viewport im Chat, Vorschaubild-Auswahl für Assets und @-Erwähnungen für Szenenobjekte. Es ist noch nicht im Codex-Plugin-Verzeichnis, 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
    # danach Codex neu starten und „MCP for Blender“ aus dem Plugin-Verzeichnis installieren

Stattdessen den offiziellen Server von Blender Lab installieren

Das Setup-Wiki von Blender Lab lässt dich sein Add-on in Blender 5.1 oder neuer installieren, den Server in deinen Home-Ordner klonen und deinen MCP-Client per uv darauf zeigen. Das sind der Clone-Befehl und die Konfiguration aus dem Wiki, wie festgehalten; wir haben sie nicht ausgeführt. Wenn du Claude nutzt, ist der Server auch im Connector-Verzeichnis von Claude aufgeführt, das vermerkt, dass das Add-on erforderlich ist.

git clone https://projects.blender.org/lab/blender_mcp.git, dann {"mcpServers": {"blender": {"command": "uv", "args": ["--directory", "$HOME/blender_mcp/mcp", "run", "blender-mcp"]}}}

Registriere nicht beide Projekte unter demselben Namen blender. Das README von mcp-for-blender sagt außerdem, dass immer nur eine Instanz seines Servers laufen soll, zum Beispiel in Cursor oder Claude Desktop, aber nicht in beiden.

Beispiel: Ein Agent baut ein Low-Poly-Requisit und exportiert ein GLB

Bei geöffnetem Blender und laufendem Add-on modelliert der Agent über execute_blender_code und prüft seine Arbeit mit look. Wir haben das nach der Dokumentation geschrieben und nicht durchgängig ausgeführt, die Ergebnisse können also abweichen. Wie du das GLB mit glTF-Transform komprimierst und in three.js lädst, steht im vollständigen Blender-MCP-Leitfaden auf vibegamer.io.

  1. Deine .blend-Datei speichern

    Der Agent bearbeitet deine geöffnete Datei direkt. Die Warnung im README lautet: Speichere deine Arbeit immer, bevor du execute_blender_code benutzt.

  2. Den Agenten anweisen

    Gib Maße, ein Dreiecksbudget und den Exportpfad an. Einfache Grundfarben werden sauber exportiert, weil Blenders glTF-Exporter die Grundfarbe aus dem Principled-BSDF-Knoten liest. Das README merkt außerdem an, dass komplexe Vorgänge eventuell in kleinere Schritte zerlegt werden müssen.

    Nutze die Blender-MCP-Tools. Baue eine Low-Poly-Holzkiste für ein Browserspiel:
    - 1-m-Würfel, steht auf dem Boden bei z = 0, Ursprung in der Mitte der Unterseite.
    - Abgeschrägte Bretter und Eckverstärkungen, unter 800 Dreiecken.
    - Nur Principled-BSDF-Grundfarben (Holz, dunkles Metall), keine Bildtexturen.
    - Wende die Modifikatoren an, verbinde alles zu einem Objekt namens "Crate".
    - Prüfe es mit dem look-Tool aus mehreren Winkeln und behebe alles, was schwebt.
    - Wähle nur "Crate" aus und exportiere es als GLB nach ./public/models/crate.glb.
    Zeig mir jedes Skript, bevor du es ausführst.
  3. Das Export-Skript lesen, bevor es läuft

    Der Export endet meist mit einem Aufruf wie diesem, mit Parametern aus Blenders export_scene-API. GLB packt Mesh, Materialien und Texturen in eine Datei. Prüfe, dass der Pfad innerhalb deines Projekts liegt.

    import bpy
    
    bpy.ops.export_scene.gltf(
        filepath="/path/to/your-game/public/models/crate.glb",
        export_format='GLB',  # eine Binärdatei mit Mesh, Materialien und Bildern
        use_selection=True,   # nur die ausgewählte "Crate"
        export_apply=True,    # Modifikatoren beim Export anwenden
        export_yup=True,      # +Y oben
    )

Ist Blender MCP sicher? Was du absichern solltest

Behandle es, als würdest du dem Agenten eine Python-Shell in Blender geben. Diese Punkte stammen aus dem README von mcp-for-blender.

  • Beliebiges Python: execute_blender_code führt jedes Python aus, das der Agent schreibt. Das README nennt das potenziell gefährlich und sagt, du sollst vorher immer deine Arbeit speichern. Lies Skripte, bevor du sie freigibst.
  • Safe Mode: Setze BLENDER_MCP_SAFE_MODE=1, um Skripte vor der Ausführung zu prüfen. Er blockiert direktes Lesen und Schreiben von Dateien, das Starten anderer Programme, Netzwerkzugriff und persistenten Code; Modellieren, Materialien, Rendern, Speichern und Import/Export funktionieren weiter.
  • Keine Socket-Authentifizierung: Der Server des Add-ons (standardmäßig Port 9876) hat weder Authentifizierung noch Verschlüsselung, sodass jeder, der diesen Port erreicht, Python in Blender ausführen kann. Lass BLENDER_HOST auf localhost, außer du bist in einem vertrauenswürdigen Netzwerk.
  • Telemetrie: Standardmäßig sendet es eine anonyme Installations-ID, eine Session-ID, den Tool-Namen, Erfolg, Dauer, Versionen, Betriebssystem und Zeitstempel. Prompts, generierter Code, Screenshots und Szenendaten werden nur gesendet, wenn du dem zustimmst, und zugestimmte Daten können zum Training von KI-Modellen verwendet werden. Setze DISABLE_TELEMETRY=true, um sie ganz abzuschalten.
  • Schlüssel von Drittanbietern: 3D-Generierung und manche Asset-Quellen nutzen API-Schlüssel, die als Umgebungsvariablen übergeben werden (zum Beispiel BLENDERMCP_MESHY_API_KEY). Rund 69 % der Poly-Pizza-Modelle stehen unter CC-BY, die Namensnennung ist also Pflicht, sofern du nicht auf CC0 filterst.

Blender MCP oder ein Blender-Skill?

Ein MCP-Server gibt dem Agenten eine Live-Verbindung zu einem laufenden Blender. Ein Skill gibt ihm schriftliche Anweisungen und Skripte für einen Workflow, etwa EL4CTEO/blender-skills (28 Workflow-Skills für Blender 5.2 LTS+ für Claude Code, Codex und andere). Beides ergänzt sich gut: Der Skill sagt dem Agenten, wie er ein spieltaugliches Asset baut, der MCP-Server lässt ihn das in deiner geöffneten Szene tun.

Wir listen Blender- und Spieleentwicklungs-Skills und MCP-Server unter Skills für die Spieleentwicklung, und vibegamer.io vergleicht sie in game dev agent skills.

Crewmark: ein 3D-Artist auf demselben Board wie deine Coder

Blender MCP ist auf eine Session nach der anderen ausgelegt: Du gibst den Prompt, der Agent modelliert, du prüfst. Wenn du einen Agenten willst, der über Tage hinweg weiter Assets erstellt, während andere den Spielcode schreiben, ist Crewmark eine weitere Option.

In Crewmark ist jeder Agent ein KI-Mitarbeiter: eine langlaufende Session mit einer Rolle, die auf deinem eigenen Rechner läuft. Claude-Code- und Codex-Mitarbeiter laufen nativ; andere Agenten, etwa OpenCode, DeepSeek Harness und Gemini, binden sich über ACP (acpx) an. Die Arbeit läuft über ein gemeinsames Issue-Board, auf dem du und die Mitarbeiter Issues zuweisen, kommentieren, einander per @-Erwähnung ansprechen und Status ändern. So bittet ein Coding-Mitarbeiter einen Blender-Mitarbeiter um ein neues Requisit: Er erwähnt ihn per @ im Issue. Mitarbeiter wachen nach Zeitplan (Heartbeats) und immer dann auf, wenn sie erwähnt werden, sodass die Arbeit startet, ohne dass du sie weiterreichen musst.

Es ersetzt Blender MCP nicht; ein Mitarbeiter mit installiertem Server nutzt ihn weiterhin. Es ergänzt die Rollen, das Board und das Aufwecken darum herum.

FAQ

Ist Blender MCP kostenlos?

Ja. mcp-for-blender ist Open Source unter MIT, und laut seiner Website funktioniert im kostenlosen Tarif jede Funktion außer der 3D-Generierung, die einen Premium-Tarif (ab 10 $ im Monat) oder deine eigenen API-Schlüssel eines Anbieters braucht. Der Server von Blender Lab ist kostenlos unter GPL-3.0.

Ist Blender MCP sicher?

Es führt jedes Python, das der Agent schreibt, in Blender aus, und sein Socket-Server hat keine Authentifizierung. Speichere zuerst deine Arbeit, lies Skripte vor der Freigabe, belasse es auf localhost und setze BLENDER_MCP_SAFE_MODE=1, um Dateizugriff, andere Programme und Netzwerkzugriff zu blockieren. Setze DISABLE_TELEMETRY=true, um die Nutzungstelemetrie abzuschalten.

Gibt es einen offiziellen Blender-MCP-Server?

Ja. Blender Lab veröffentlicht blender_mcp auf projects.blender.org (GPL-3.0, Blender 5.1+), und er ist im Connector-Verzeichnis von Claude als von Blender Lab erstellt aufgeführt. Das beliebte mcp-for-blender ist ein Drittanbieter-Projekt ohne Verbindung zur Blender Foundation.

Wie füge ich Blender MCP zu Claude Code hinzu?

Installiere uv, führe claude mcp add blender uvx mcp-for-blender aus, prüfe es mit claude mcp list, und installiere und aktiviere dann das Blender-Add-on mit uvx mcp-for-blender install-addon. Oder nutze den Ein-Befehl-Installer aus dem README, der Claude Code für dich einrichtet.

Wie füge ich Blender MCP zu Codex hinzu?

Führe codex mcp add blender -- uvx mcp-for-blender aus, oder füge ~/.codex/config.toml eine Tabelle [mcp_servers.blender] mit command = "uvx" und args = ["mcp-for-blender"] hinzu. CLI, Desktop-App und IDE-Erweiterung teilen sich diese Datei. Das README bietet außerdem ein Codex-Plugin mit Live-Viewport im Chat.

Soll ich Blender MCP oder einen Blender-Skill nutzen?

Nutze MCP, wenn der Agent auf eine laufende Blender-Szene einwirken soll; nutze einen Skill, wenn du ihm einen erprobten Workflow vorgeben willst. Viele Setups nutzen beides: Der Skill beschreibt den Workflow, der MCP-Server führt ihn aus.

Befehle und Funktionen am 21. November 2026 geprüft anhand des README von mcp-for-blender, des Repositorys und Wikis von Blender Labs blender_mcp, der MCP-Dokumentation von Claude Code und Codex sowie der glTF-Export-Dokumentation von Blender. Die Installationsbefehle haben wir nicht ausgeführt.

Gib deinem Spiel einen 3D-Artist, der mit deinen Codern zusammenarbeitet.

Crewmark gibt jedem Agenten eine Rolle, ein gemeinsames Issue-Board und zeitgesteuertes Aufwecken, damit sie sich Arbeit übergeben, ohne dass du sie zwischen Terminals kopierst.

Crewmark ist Open Source: gib uns einen Stern auf GitHub