"Blender MCP" genellikle MCP for Blender demektir. Bu, Siddharth Ahuja'nın açık kaynak projesi ve bir yapay zeka ajanının çalışan bir Blender'ı yönetmesini sağlıyor. Kasım 2026'ya kadar adı blender-mcp'ydi ve çoğu rehber hâlâ bu adı kullanıyor. Bağlandığında Claude Code, Codex, Cursor veya Claude Desktop, sohbetteki bir prompt'la nesne oluşturup düzenleyebilir, materyal uygulayabilir, viewport'a bakabilir ve dosya dışa aktarabilir.

Bu rehber ne olduğunu ve Claude Code ile Codex'e nasıl kurulacağını anlatıyor, ardından tam bir örnek veriyor: ajan Blender'da düşük poligonlu bir oyun eşyası yapıyor, onu GLB olarak dışa aktarıyor, dosya glTF-Transform ile sıkıştırılıyor ve three.js bir tarayıcı oyununda yüklüyor. Her komutu 21 Kasım 2026'da projenin README'si ve resmi dokümanlarla karşılaştırdık. Kurulumu ve örneği kendimiz çalıştırmadık, bu yüzden aşağıda anlatılan çıktılar dokümanlara göre olması gerekenlerdir.

Blender MCP nedir

MCP (Model Context Protocol), bir yapay zeka ajanına başka bir programı yönetecek araçlar vermenin standart yoludur. MCP for Blender iki parçadan oluşur:

  • Bir Blender eklentisi. Blender'ın içinde bir soket sunucusu açar (varsayılan port 9876) ve aldığı komutları çalıştırır.
  • Bir MCP sunucusu (Python paketi mcp-for-blender). Ajanın arka planda başlattığı sunucu, ajanın araç çağrılarını eklentiye iletir.

Ajan çoğunlukla Blender Python'ı yazıp açık Blender dosyanda çalıştırarak iş yapar. README dokuz araç listeliyor. En sık göreceklerin execute_blender_code (Blender'da Python çalıştırır), look (ajan kendi işini kontrol edebilsin diye viewport, kamera veya çok açılı görüntüler alır), get_scene_info (sahnenin özeti) ve search_assets / import_asset (Poly Haven, Sketchfab ve Poly Pizza'dan model, doku ve HDRI getirir). Ayrıca Meshy, Tripo, Hunyuan3D veya Hyper3D Rodin ile model üreten generate_3d var.

Blender tarafından yapılmadı. README'nin ilk cümlesi "This is a third-party integration and not made by Blender", GitHub açıklaması da "Not affiliated with the official Blender Foundation." diyor. MIT lisanslı ve 21 Kasım 2026'da 35.153 GitHub yıldızı vardı.

Yine de Blender'ın kendi MCP sunucusu var. Blender projesinin bir parçası olan Blender Lab, daha küçük bir sunucuyu projects.blender.org/lab/blender_mcp adresinde yayımlıyor ve blender.org/lab/mcp-server sayfasında anlatıyor. Readme'si onu "deliberately small" diye tanımlıyor. Blender'ın Python API dokümanlarına, sahne ve dosya özetlerine, ekran görüntülerine ve kod çalıştırmaya odaklanıyor. Blender 5.1 veya üstünü gerektiriyor, GPL-3.0 lisanslı ve Eylül 2026'da v1.0.3 sürümündeydi. Claude'un connector dizininde de Blender Lab tarafından yapılmış "Blender" olarak listeleniyor. Onu Alternatifler bölümünde ele alıyoruz.

Neye ihtiyacın var

  • MCP for Blender için Blender 3.0 veya üstü (eklenti asgari sürüm olarak 3.0'ı belirtiyor).
  • Python 3.10 veya üstü ve sunucuyu uvx ile çalıştıran araç olan uv. Aşağıdaki tek satırlık kurucu uv'yi senin için kurar.
  • MCP destekleyen bir ajan: README'ye göre Claude Code, Codex, Cursor, Claude Desktop, VS Code, OpenCode, Windsurf veya Antigravity.
  • Oyun kısmı için: Node.js (glTF-Transform için) ve bir three.js projesi.

Hızlı kurulum (tüm istemciler tek seferde)

README'nin önerdiği yol tek bir komut. Bu komut uv'yi kuruyor, makinendeki ajanları buluyor, hangilerini kuracağını seçtiriyor ve Blender eklentisini kurup etkinleştiriyor. Her yapılandırma dosyasına yalnızca bir blender girdisi ekliyor ve değiştirdiği her dosyanın bir .bak kopyasını kaydediyor.

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

uv zaten kuruluysa:

uvx mcp-for-blender setup

İnternetteki bir betiği doğrudan kabuğa aktarmak, onu kullanıcının yetkileriyle çalıştırır. Bunu istemiyorsan aşağıdaki manuel adımları kullan, aynı işi parça parça yapıyorlar. Hangisini seçersen seç, sonra ajanını tamamen kapatıp yeniden aç.

Blender MCP'yi Claude Code'a kurma

  1. uv'yi kur. README macOS için brew install uv, Linux için curl -LsSf https://astral.sh/uv/install.sh | sh, Windows için winget install --id=astral-sh.uv -e veriyor. uvx komutunu oluşturmayabileceği için pip install uv konusunda uyarıyor.
  2. Sunucuyu Claude Code'a kaydet. README'deki komut bu:
claude mcp add blender uvx mcp-for-blender
  1. Kontrol et. Claude Code'un MCP dokümanları claude mcp list (örneğin "✔ Connected" gibi bir durum gösterir) ve claude mcp get blender komutlarını veriyor, oturum içindeki /mcp paneli de aynısını gösteriyor.

claude mcp add varsayılan olarak sunucuyu yalnızca mevcut proje için kaydeder. Her projede kullanmak için --scope user ekle. Dokümanlardaki genel biçim sunucu komutunu -- işaretinden sonra yazıyor: claude mcp add [options] <name> -- <command> [args...]. --scope veya --env gibi seçenekler eklersen -- gerekir.

Projenin anonim kullanım telemetrisini kapatmak için README sunucuya DISABLE_TELEMETRY=true ortam değişkenini vermeni söylüyor. Claude Code'da bunu -- işaretinden önce --env ile geçirirsin.

Blender MCP'yi Codex'e kurma

Codex CLI, Codex masaüstü uygulaması ve IDE eklentisi tek bir yapılandırma dosyasını paylaşır: ~/.codex/config.toml. Yani tek bir kurulum üçünü de kapsar.

Düz MCP sunucusu. README'deki komut:

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

Ya da elle ~/.codex/config.toml dosyasına ekle:

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

codex mcp list çalıştır ve blenderın etkin göründüğünü kontrol et. Araçlar Codex'i bir sonraki açışında görünür, Codex terminal arayüzündeki /mcp de etkin sunucuları listeler. OpenAI'ın Codex MCP dokümanları ayrıca ortam değişkenleri için bir env tablosunu, startup_timeout_sec (varsayılan 10) ve tool_timeout_sec (varsayılan 60) ayarlarını anlatıyor. Masaüstü uygulamasında Settings → MCP servers → Add server yolunu izle, adını blender yap, STDIO'yu seç ve uvx mcp-for-blender yaz.

Codex eklentisi. README Codex için bu yolu öneriyor. Sohbetin içine canlı bir Blender viewport'u, Poly Haven, Sketchfab ve Poly Pizza için küçük resimli seçiciler ve sahne nesneleri için @ ile anma ekliyor. Henüz Codex eklenti dizininde yok, o yüzden repodan ekliyorsun:

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

Sonra Codex'i yeniden başlat, eklenti dizininden MCP for Blender'ı kur ve Codex'ten onu kullanmasını iste.

Cursor ve diğerleri

Cursor'da Settings → MCP'yi aç ve genel bir sunucu ekle, ya da projende şu içerikle .cursor/mcp.json oluştur:

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

Windows'ta README "command": "cmd" ve "args": ["/c", "uvx", "mcp-for-blender"] kullanıyor. README'de ayrıca Cursor ve VS Code için tek tıkla kurulum düğmeleri ile Claude Desktop, OpenCode ve Antigravity için yapılandırma blokları var. Sunucunun aynı anda yalnızca bir kopyasını çalıştırmanı söylüyor, örneğin Cursor veya Claude Desktop'tan biri, ikisi birden değil.

Blender eklentisini bağlama

Hızlı kurucu bunu senin için yapar. Elle:

  1. uvx mcp-for-blender install-addon çalıştır. Eklentiyi Blender eklentiler klasörüne blender_mcp.py olarak kopyalar.
  2. Blender'da Edit → Preferences → Add-ons'u aç ve Interface: MCP for Blender'ı etkinleştir. Görünmüyorsa Blender'ı yeniden başlat ya da Install… düğmesine tıklayıp kopyalanan dosyayı seç. Repodan addon.py dosyasını indirip onu da kurabilirsin.
  3. 3D viewport'ta yan paneli açmak için N'ye bas ve MCP for Blender sekmesini bul. Eklenti sunucusunu Blender açıldığında başlatır. Çalışmıyorsa Start MCP Server'a tıkla.

Eklentinin sekmesinde Poly Haven, Poly Pizza (ücretsiz bir API anahtarı gerekir) ve 3D üreticiler gibi isteğe bağlı özellikleri açarsın.

Ajanın bağlanamıyorsa: Blender'ın eklenti çalışır durumda açık olduğundan emin ol ve uvx mcp-for-blender'ı kendin bir terminalde başlatma (README'nin sorun giderme tablosu böyle diyor). Dock'tan veya Başlat menüsünden açılan uygulamalar uvx'i bulamayabilir ve spawn uvx ENOENT hatasıyla başarısız olabilir. Bunu, komut olarak which uvx (macOS/Linux) veya where uvx (Windows) çıktısındaki tam yolu kullanarak çöz. Yine olmazsa hem ajanı hem Blender'ı yeniden başlat.

Uygulamalı örnek: prompt'tan three.js'e düşük poligonlu bir oyun eşyası

Hedef: bir tarayıcı oyunu için hızlı yüklenecek kadar küçük, three.js'in doğrudan okuduğu bir biçimde bir hazine sandığı. Bu akışı dokümanlardan yazdık ve baştan sona çalıştırmadık, bu yüzden dosya boyutları ve kesin sonuçlar değişecektir.

1. Önce Blender dosyanı kaydet

Ajan başlamadan önce yeni bir Blender dosyası aç ve kaydet (örneğin chest.blend). Ajan dosyanı doğrudan değiştirir ve README'nin kendi uyarısı her zaman önce çalışmanı kaydetmek.

2. Ajana prompt ver

Claude Code veya Codex'te, Blender açık ve bağlıyken:

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.

Bu prompt'taki birkaç tercih oyunlar için önemli. Düz temel renkler temiz dışa aktarılır, çünkü glTF dışa aktarıcı temel rengi Principled BSDF düğümünden alır, Blender'ın glTF kılavuzuna göre. Tek bir birleştirilmiş nesne, three.js'te tek bir mesh demek. Orijini altta tutmak, konumunu y = 0 yaptığında sandığın zeminde durması demek. Üçgen bütçesi ajanın subdivision eklemesini engeller.

3. Dışa aktarma adımı

Blender Python'ı ajan yazar. Dışa aktarma genelde Blender'ın export_scene API'sinde belgelenen parametreleri kullanan şuna benzer bir çağrıyla biter:

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
)

Ajanın çalıştırdığı her betikte olduğu gibi bu betiği de onaylamadan önce oku. Yolun projenin içini gösterdiğini ve hiçbir şeyin önemsediğin dosyaları silmediğini veya üzerine yazmadığını kontrol et.

4. GLB'yi glTF-Transform ile sıkıştır

glTF-Transform, glTF dosyalarını optimize etmek için bir komut satırı aracı. Kur ve optimize çalıştır. Bunlar README'sindeki komutlar:

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

Bizim sandık için:

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

optimize varsayılan olarak geometriyi meshopt ile sıkıştırır (--compress meshopt), dokuları 2048 px ile sınırlar ve sahne grafiğini düzleştirir. Sandığımızda görüntü dokusu yok, bu yüzden --texture-compress webp burada hiçbir şey yapmaz, ama dokulu eşyalar için bırak. Yalnızca geometriyi sıkıştırmak için glTF-Transform'da gltf-transform meshopt input.glb output.glb --level medium de var.

5. three.js'te yükle

Meshopt ile sıkıştırılmış bir dosya meshopt çözücüsüne ihtiyaç duyar. Onsuz GLTFLoader "setMeshoptDecoder must be called before loading compressed files" hatasını verir. Aşağıdaki import'lar three.js'in kendi örneklerinde kullandıklarıyla aynı:

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 metreyle çalışır, çoğu three.js sahnesi de öyle, bu yüzden sandık yaklaşık 1 m genişliğinde yüklenmeli. Yan yatmış geliyorsa dışa aktarma büyük olasılıkla export_yup olmadan yapılmıştır. Siyah geliyorsa sahnenin ışığa ihtiyacı var: bir HemisphereLight veya ortam haritası ekle.

6. Yinele

Blender'ı açık tut ve değişiklik iste, örneğin "kapağı Lid adlı ayrı bir nesne olarak 40 derece açılır yap" veya "içine bir altın yığını ekle". Sonra dışa aktarmayı ve optimize komutunu yeniden çalıştır. Ajandan dışa aktarma betiğini projende tutmasını iste, böylece her seferinde aynı ayarları alırsın.

Sınırlar ve güvenlik

  • Blender içinde herhangi bir Python'ı çalıştırır. README'nin uyarısı: "The execute_blender_code tool allows running arbitrary Python code in Blender, which can be powerful but potentially dangerous." Blender'daki Python, kullanıcı hesabının erişebildiği her dosyayı okuyup yazabilir. Ajandan betikleri çalıştırmadan önce göstermesini iste ve oku.
  • Her oturumdan önce dosyanı kaydet. Aynı uyarı şu cümleyle bitiyor: "ALWAYS save your work before using it." İlerledikçe sürümleri kaydet (File → Save Incremental).
  • Dosya veya ağ erişimine ihtiyacın yoksa güvenli modu aç. Sunucu için BLENDER_MCP_SAFE_MODE=1 ayarla. Bu durumda her betik çalışmadan önce denetlenir ve doğrudan dosya okuyan veya yazan, başka programlar çalıştıran, ağı kullanan veya betik bittikten sonra çalışmaya devam eden kod engellenir. Modelleme, materyaller, render, kaydetme ve içe/dışa aktarma çalışmaya devam eder.
  • Localhost'ta tut. Eklentinin soketinde kimlik doğrulama veya şifreleme yok. O porta erişebilen herkes Blender'ında Python çalıştırabilir. Güvenmediğin bir ağa açma.
  • Büyük işleri adımlara böl. README, karmaşık işlemlerin daha küçük adımlar gerektirebileceğini ve zaman aşımlarının isteği basitleştirerek çözüldüğünü söylüyor. Poly Haven indirmeleri Blender'ın ana iş parçacığında çalışır, bu yüzden indirme bitene kadar Blender donar.
  • Asset lisanslarını kontrol et. Poly Haven CC0. Poly Pizza'nın yaklaşık %69'u CC-BY, yani atıf gerektiriyor. Eklenti atıf satırını içe aktarılan nesnelere yazar, ya da licence="CC0" ile arama yapabilirsin.
  • Telemetri. Varsayılan olarak sunucu anonim bir kullanım kaydı gönderir: kurulum kimliği, oturum kimliği, araç adı, başarı durumu, süre, sürümler, işletim sistemi ve zaman damgası. Prompt'ların, kodun, ekran görüntülerin ve sahne verin yalnızca kabul edersen toplanır. DISABLE_TELEMETRY=true hepsini kapatır.

Blender MCP alternatifleri

  • Blender Lab'in Blender MCP'si: Blender'ın kendi sunucusu. Daha küçük ve Python API dokümanları, sahne ve dosya özetleri, ekran görüntüleri ve kod çalıştırma etrafında kurulu, .blend dosyaları için bir arka plan modu da var. Blender 5.1+ gerektiriyor ve GPL-3.0 lisanslı. Wiki'si, repoyu klonlayıp uv --directory .../blender_mcp/mcp run blender-mcp ile çalıştırarak kurmayı anlatıyor. Resmi projeyi istiyorsan ve asset araması ya da yapay zeka model üretimine ihtiyacın yoksa bunu seç.
  • Blender Agent Skills: Claude Code, Codex, OpenCode, Gemini CLI, Copilot ve Cursor için Blender 5.2 LTS+ üzerinde 28 skill (modelleme, UV, baking, rigging, animasyon, optimizasyon, dışa aktarma). MIT. Skill'ler ajana işin nasıl yapılacağını öğretir. MCP sunucusu ona Blender'ın kontrolünü verir. İkisini birlikte kullanabilirsin.
  • blender-game-skills: Konsept çizimden rig'lenmiş, oyuna hazır 3D asset'lere giden Claude Code skill'leri. MIT.
  • Hazır modeller. Yaygın eşyalar için ücretsiz bir model çoğu zaman üretmekten hızlıdır. Bkz. Polyfork'un düşük poligonlu GLB'leri.

Oyun geliştirme için ajan skill'leri ve MCP sunucuları listemiz Godot, Unity, Unreal ve three.js karşılıklarını kapsıyor.

SSS

Blender MCP ücretsiz mi?

Evet. MCP for Blender MIT lisanslı ve eklenti ücretsiz. Premium sayfası her özelliğin ücretsiz planda çalıştığını, yalnızca 3D üretimin ücretli olduğunu söylüyor. Meshy, Tripo, Hunyuan3D, Hyper3D Rodin veya World Labs'i kendi API anahtarlarınla kullanabilir ya da anahtarsız kullanmak için Premium alabilirsin (21 Kasım 2026'da ayda 10 $'dan başlıyor). Blender Lab'in sunucusu GPL-3.0 altında ücretsiz. Yapay zeka ajanının aboneliğini veya API kullanımını yine ödersin.

Blender MCP güvenli mi?

Çalıştırmasına izin verdiğin kod kadar güvenli. Ajan Blender içinde Python çalıştırır ve o Python kullanıcının dosya erişimine sahiptir. Çalışmanı kaydet, betikleri onaylamadan önce oku, güvenli modu (BLENDER_MCP_SAFE_MODE=1) kullan ve eklentinin portunu localhost'ta tut. Birinin yeniden yüklediği bir kopyadan değil, resmi repodan veya projenin kendi kurulum betiğinden kur.

Resmi bir Blender MCP sunucusu var mı?

Evet. Blender Lab bir tane projects.blender.org/lab/blender_mcp adresinde yayımlıyor ve Claude'un connector dizini onu Blender Lab tarafından yapılmış "Blender" olarak listeliyor. Daha tanınmış olan MCP for Blender (eski adıyla blender-mcp) Blender Foundation ile bağlantısı olmayan üçüncü taraf bir proje.

Blender MCP Claude Code ile çalışır mı?

Evet. claude mcp add blender uvx mcp-for-blender çalıştır, Blender'ı eklenti etkin halde aç ve claude mcp list ile kontrol et. Claude Desktop ise bunun yerine claude_desktop_config.json içindeki bir JSON bloğuyla kurulur.

Blender MCP Codex ile çalışır mı?

Evet. codex mcp add blender -- uvx mcp-for-blender çalıştır ya da ~/.codex/config.toml dosyasına [mcp_servers.blender] ekle. README ayrıca sohbetin yanında canlı bir Blender viewport'u gösteren bir Codex eklentisi de sunuyor.

Blender MCP ChatGPT ile çalışır mı?

README masaüstü ve kodlama istemcilerini listeliyor (Claude Desktop, Claude Code, Codex, Cursor, VS Code, Windsurf, OpenCode, Antigravity), ChatGPT uygulamasını değil. Bunun için OpenAI'ın ajanı Codex. Sunucu kendi bilgisayarında çalışan bir Blender ile konuşur, bu yüzden yerel bir MCP sunucusu başlatabilen bir istemciye ihtiyacın var.

Blender MCP sekmesi nerede?

Blender'ın 3D viewport'unda yan paneli açmak için N'ye bas. Sekmenin adı MCP for Blender. Yoksa Edit → Preferences → Add-ons içinde Interface: MCP for Blender'ı etkinleştir.

Blender MCP mi, Blender skill'i mi?

Bir MCP sunucusu ajanın canlı bir Blender üzerinde iş yapmasını sağlar: nesne oluşturma, viewport'a bakma, dışa aktarma. Bir skill ise ajana Blender iş akışlarını ve kurallarını öğretir. Bu, ajanın sonra MCP üzerinden mi yoksa Blender'ı komut satırından arayüzsüz mü çalıştırdığına bakmadan işe yarar. Oyun asset'leri için ikisini birlikte kullanmak iyi çalışır. MCP sunucusu inşa eder, Blender Agent Skills gibi bir skill paketi ise UV'leri, optimizasyonu ve dışa aktarma ayarlarını kapsar.

Kaynaklar

21 Kasım 2026'da kontrol edildi: mcp-for-blender README, MCP for Blender Premium, Blender Lab blender_mcp ve kurulum wiki'si, Claude Code MCP dokümanları, Codex MCP dokümanları, Blender export_scene API, Blender glTF 2.0 kılavuzu, glTF-Transform CLI, three.js GLTFLoader.