Kết nối Blender với AI (Claude, GPT) qua MCP

Cài addon MCP for Blender, cài máy chủ bằng uv tool install mcp-for-blender, gộp khối blender vào cấu hình Claude Desktop, mở lại app và bấm Start MCP Server trong Blender. Blender không cần API key.

Lấy API key Xem bảng giá

Trước khi chạy: máy đã cài Blender và đã mở Blender ít nhất một lần.

Cách nhanh nhất: một lệnh

Lệnh tự cài mọi thứ cần thiết, thêm vào Claude Desktop mà không đụng cài đặt khác (có sao lưu .bak) và khởi động lại Claude. Chờ tới dòng chữ xanh XONG. Chạy lại nhiều lần không sao.

# Windows (PowerShell)
irm https://revidapi.com/mcp/blender.ps1 | iex

# macOS (Terminal)
curl -fsSL https://revidapi.com/mcp/blender.sh | bash

Sau đó làm phần việc trong phần mềm (bên dưới) và kiểm tra Settings → Developer có nhãn Running. Các bước thủ công phía dưới dành cho ai muốn tự làm từng bước.

Bước 1 — Cài uv và máy chủ

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

# cả hai hệ
uv tool install mcp-for-blender

Windows: kiểm tra Test-Path "$env:USERPROFILE\.local\bin\mcp-for-blender.exe" phải ra True.

Bước 2 — Cài addon vào Blender

# Windows (PowerShell)
& "$env:USERPROFILE\.local\bin\mcp-for-blender.exe" install-addon

# macOS
~/.local/bin/mcp-for-blender install-addon

Trong Blender: Edit → Preferences → Add-ons, tích bật Interface: MCP for Blender.

Bước 3 — Bật máy chủ trong Blender

Nhấn N trong khung nhìn 3D, chọn tab MCP for Blender, bấm Start MCP Server. Blender lắng nghe cổng 9876. Phải bấm mỗi lần mở Blender.

Bước 4 — Thêm vào Claude Desktop

Windows — PowerShell:

$ten  = "blender"
$lenh = "$env:USERPROFILE\.local\bin\mcp-for-blender.exe"
$doi  = @()
$dirs = @("$env:APPDATA\Claude", "$env:LOCALAPPDATA\Claude-3p")
$dirs += Get-ChildItem "$env:LOCALAPPDATA\Packages" -Directory -Filter "Claude*" -ErrorAction SilentlyContinue | ForEach-Object { "$($_.FullName)\LocalCache\Local\Claude-3p"; "$($_.FullName)\LocalCache\Roaming\Claude" }
$utf8 = New-Object System.Text.UTF8Encoding $false
foreach ($d in $dirs) {
  $f = Join-Path $d "claude_desktop_config.json"
  if (-not (Test-Path $f)) { continue }
  Copy-Item $f "$f.bak" -Force
  $raw = [System.IO.File]::ReadAllText($f)
  if ($raw.Trim()) { $j = $raw | ConvertFrom-Json } else { $j = [pscustomobject]@{} }
  if (-not $j.mcpServers) { $j | Add-Member -NotePropertyName mcpServers -NotePropertyValue ([pscustomobject]@{}) }
  $j.mcpServers | Add-Member -NotePropertyName $ten -NotePropertyValue ([pscustomobject]@{ command = $lenh; args = @($doi) }) -Force
  [System.IO.File]::WriteAllText($f, ($j | ConvertTo-Json -Depth 20), $utf8)
  "Da cap nhat: $f"
}

Rồi thoát hẳn Claude:

Stop-Process -Name claude -Force -ErrorAction SilentlyContinue

macOS — Terminal (rồi Cmd+Q và mở lại Claude):

python3 - <<'EOF'
import json, os, shutil
ten = "blender"
lenh = os.path.expanduser("~/.local/bin/mcp-for-blender")
doi = []
goc = os.path.expanduser("~/Library/Application Support")
tep_ds = [os.path.join(goc, d, "claude_desktop_config.json") for d in ("Claude", "Claude-3p")]
co = [t for t in tep_ds if os.path.exists(t)] or [tep_ds[0]]
for tep in co:
    os.makedirs(os.path.dirname(tep), exist_ok=True)
    if os.path.exists(tep): shutil.copy(tep, tep + ".bak")
    raw = open(tep, encoding="utf-8-sig").read().strip() if os.path.exists(tep) else ""
    j = json.loads(raw) if raw else {}
    j.setdefault("mcpServers", {})[ten] = {"command": lenh, "args": doi}
    open(tep, "w", encoding="utf-8").write(json.dumps(j, indent=2, ensure_ascii=False) + "\n")
    print("Da cap nhat:", tep)
EOF

Mở lại Claude Desktop (Windows: từ menu Start; Mac: từ Launchpad), vào Settings → Developer. Mục Local MCP servers phải hiện tên phần mềm với nhãn Running. Bấm View logs nếu thấy Failed.

Dùng RevidAPI Code thay cho Claude Desktop thì vào Cài đặt → Phần mềm kết nối (MCP) → Thêm → Blender và bật ô Phần mềm.

Thử ngay

"Tạo một cảnh căn phòng đơn giản có bàn, ghế và đèn."
"Đổi vật liệu của khối cầu thành kim loại xước, màu đồng."
"Đặt camera nhìn xuống bàn và render ra ảnh."

Dựng cảnh cần nhiều lượt gọi công cụ; dùng claude-sonnet-5 hằng ngày, claude-opus-5-5 khi cảnh phức tạp.

Sửa lỗi riêng của Blender

Triệu chứng	Cách xử lý
`Could not connect to Blender addon on port 9876` hoặc `WinError 10061`	Blender chưa mở hoặc chưa bấm Start MCP Server.
Không thấy tab MCP for Blender	Addon chưa bật: Edit → Preferences → Add-ons.
Cổng 9876 bị chiếm	Đang mở hai Blender hoặc phần mềm khác dùng cổng này. Đóng bớt.
Failed / Server disconnected, `os error 32`, No servers added	Xem bảng lỗi trong hướng dẫn chung.