„Blender MCP” zwykle oznacza MCP for Blender, projekt open source Siddharta Ahuji, dzięki któremu agent AI może sterować uruchomionym Blenderem. Do listopada 2026 nazywał się blender-mcp i większość poradników nadal używa tej nazwy. Po podłączeniu Claude Code, Codex, Cursor lub Claude Desktop mogą na podstawie promptu z czatu tworzyć i edytować obiekty, nakładać materiały, oglądać viewport i eksportować pliki.

Ten przewodnik wyjaśnia, czym to jest i jak zainstalować to w Claude Code i Codex. Jest też pełny przykład: agent buduje w Blenderze niskopoligonowy przedmiot do gry, eksportuje go jako GLB, plik jest kompresowany przez glTF-Transform, a three.js wczytuje go w grze przeglądarkowej. Każde polecenie sprawdziliśmy 21 listopada 2026 w README projektu i w oficjalnej dokumentacji. Instalacji ani przykładu nie uruchomiliśmy sami, więc opisane niżej wyniki to to, co według dokumentacji powinno się stać.

Czym jest Blender MCP

MCP (Model Context Protocol) to standard, który daje agentowi AI narzędzia działające na innym programie. MCP for Blender ma dwie części:

  • Dodatek do Blendera, który otwiera w Blenderze serwer gniazd (domyślnie port 9876) i wykonuje otrzymywane polecenia.
  • Serwer MCP (pakiet Pythona mcp-for-blender), który agent uruchamia w tle. Przekazuje wywołania narzędzi agenta do dodatku.

Agent pracuje głównie tak, że pisze Pythona dla Blendera i uruchamia go w twoim otwartym pliku. README wymienia dziewięć narzędzi. Najczęściej zobaczysz execute_blender_code (uruchamia Pythona w Blenderze), look (widoki viewportu, kamery lub z kilku kątów, żeby agent mógł sprawdzić własną pracę), get_scene_info (podsumowanie sceny) oraz search_assets / import_asset (pobierają modele, tekstury i HDRI z Poly Haven, Sketchfab i Poly Pizza). Jest też generate_3d, które tworzy model przez Meshy, Tripo, Hunyuan3D lub Hyper3D Rodin.

Nie jest zrobiony przez Blendera. README zaczyna się od „This is a third-party integration and not made by Blender”, a opis na GitHubie mówi „Not affiliated with the official Blender Foundation.” Ma licencję MIT i 21 listopada 2026 miał 35 153 gwiazdki na GitHubie.

Blender ma jednak własny serwer MCP. Blender Lab, część projektu Blender, publikuje mniejszy pod adresem projects.blender.org/lab/blender_mcp, opisany na blender.org/lab/mcp-server. Jego readme nazywa go „deliberately small”. Skupia się na dokumentacji API Pythona w Blenderze, podsumowaniach scen i plików, zrzutach ekranu i uruchamianiu kodu. Wymaga Blendera 5.1 lub nowszego, ma licencję GPL-3.0 i we wrześniu 2026 był w wersji v1.0.3. Jest też na liście w katalogu konektorów Claude'a jako „Blender”, autorstwa Blender Lab. Opisujemy go w sekcji Alternatywy.

Czego potrzebujesz

  • Blendera 3.0 lub nowszego dla MCP for Blender (dodatek deklaruje 3.0 jako minimum).
  • Pythona 3.10 lub nowszego i uv, narzędzia, które uruchamia serwer przez uvx. Jednoliniowy instalator poniżej zainstaluje uv za ciebie.
  • Agenta z obsługą MCP: Claude Code, Codex, Cursor, Claude Desktop, VS Code, OpenCode, Windsurf lub Antigravity, według README.
  • Do części o grze: Node.js (dla glTF-Transform) i projekt three.js.

Szybka instalacja (wszystkie klienty naraz)

Zalecana w README ścieżka to jedno polecenie, które instaluje uv, znajduje agentów na twoim komputerze, pozwala wybrać, których skonfigurować, oraz instaluje i włącza dodatek do Blendera. Dodaje tylko wpis blender do każdego pliku konfiguracji i zapisuje kopię .bak każdego zmienionego pliku.

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

Jeśli masz już uv:

uvx mcp-for-blender setup

Przekazanie skryptu z internetu prosto do powłoki uruchamia go z uprawnieniami twojego użytkownika. Jeśli wolisz tego uniknąć, użyj ręcznych kroków poniżej, które robią to samo po kawałku. W obu przypadkach po wszystkim całkowicie zamknij i otwórz ponownie agenta.

Instalacja Blender MCP w Claude Code

  1. Zainstaluj uv. README podaje brew install uv na macOS, curl -LsSf https://astral.sh/uv/install.sh | sh na Linuksie i winget install --id=astral-sh.uv -e na Windowsie. Ostrzega przed pip install uv, które może nie utworzyć polecenia uvx.
  2. Zarejestruj serwer w Claude Code. To polecenie z README:
claude mcp add blender uvx mcp-for-blender
  1. Sprawdź go. Dokumentacja MCP w Claude Code podaje claude mcp list (pokazuje status w rodzaju „✔ Connected”) i claude mcp get blender, a panel /mcp w sesji pokazuje to samo.

Domyślnie claude mcp add zapisuje serwer tylko dla bieżącego projektu. Dodaj --scope user, żeby działał w każdym projekcie. Ogólna forma z dokumentacji stawia polecenie serwera po --: claude mcp add [options] <name> -- <command> [args...]. -- jest potrzebne, jeśli dodajesz opcje takie jak --scope lub --env.

Żeby wyłączyć anonimową telemetrię użycia projektu, README każe ustawić dla serwera zmienną środowiskową DISABLE_TELEMETRY=true. W Claude Code przekazujesz ją przez --env przed --.

Instalacja Blender MCP w Codex

CLI Codexa, aplikacja desktopowa Codex i rozszerzenie do IDE korzystają z jednego pliku konfiguracji, ~/.codex/config.toml, więc jedna konfiguracja obejmuje wszystkie trzy.

Zwykły serwer MCP. Polecenie z README:

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

Albo dodaj go ręcznie do ~/.codex/config.toml:

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

Uruchom codex mcp list i sprawdź, czy blender jest włączony. Narzędzia pojawią się przy następnym uruchomieniu Codexa, a /mcp w terminalowym interfejsie Codexa pokazuje aktywne serwery. Dokumentacja MCP w Codex od OpenAI opisuje też tabelę env dla zmiennych środowiskowych, startup_timeout_sec (domyślnie 10) i tool_timeout_sec (domyślnie 60). W aplikacji desktopowej wejdź w Settings → MCP servers → Add server, nazwij go blender, wybierz STDIO i wpisz uvx mcp-for-blender.

Wtyczka Codex. README poleca tę drogę dla Codexa. Dodaje żywy viewport Blendera w czacie, miniatury do wyboru z Poly Haven, Sketchfab i Poly Pizza oraz wzmianki @ dla obiektów sceny. Nie ma jej jeszcze w katalogu wtyczek Codexa, więc dodajesz ją z repozytorium:

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

Potem uruchom Codex ponownie, zainstaluj MCP for Blender z katalogu wtyczek i poproś Codexa, żeby go użył.

Cursor i inne klienty

W Cursorze otwórz Settings → MCP i dodaj serwer globalny albo utwórz w projekcie .cursor/mcp.json z taką zawartością:

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

Na Windowsie README używa "command": "cmd" z "args": ["/c", "uvx", "mcp-for-blender"]. README ma też przyciski instalacji jednym kliknięciem dla Cursora i VS Code oraz bloki konfiguracji dla Claude Desktop, OpenCode i Antigravity. Każe uruchamiać naraz tylko jedną kopię serwera, na przykład Cursor albo Claude Desktop, ale nie oba.

Podłączanie dodatku do Blendera

Szybki instalator robi to za ciebie. Ręcznie:

  1. Uruchom uvx mcp-for-blender install-addon. Kopiuje dodatek do folderu dodatków Blendera jako blender_mcp.py.
  2. W Blenderze otwórz Edit → Preferences → Add-ons i włącz Interface: MCP for Blender. Jeśli go nie widać, uruchom Blendera ponownie albo kliknij Install… i wskaż skopiowany plik. Możesz też pobrać addon.py z repozytorium i zainstalować go.
  3. W widoku 3D naciśnij N, żeby otworzyć panel boczny, i znajdź kartę MCP for Blender. Dodatek uruchamia swój serwer przy starcie Blendera. Jeśli nie działa, kliknij Start MCP Server.

W karcie dodatku włączasz funkcje opcjonalne, takie jak Poly Haven, Poly Pizza (wymaga darmowego klucza API) i generatory 3D.

Jeśli agent nie może się połączyć: upewnij się, że Blender jest otwarty z działającym dodatkiem, i nie uruchamiaj samodzielnie uvx mcp-for-blender w terminalu (tak mówi tabela rozwiązywania problemów w README). Aplikacje uruchamiane z Docka lub menu Start mogą nie znaleźć uvx i kończą się błędem spawn uvx ENOENT. Napraw to, podając jako polecenie pełną ścieżkę z which uvx (macOS/Linux) lub where uvx (Windows). Jeśli to nie pomoże, uruchom ponownie agenta i Blendera.

Pełny przykład: niskopoligonowy przedmiot do gry, od promptu do three.js

Cel: skrzynia ze skarbem do gry przeglądarkowej, na tyle mała, żeby ładowała się szybko, w formacie, który three.js czyta bezpośrednio. Ten przebieg napisaliśmy na podstawie dokumentacji i nie przeszliśmy go w całości, więc rozmiary plików i dokładne wyniki będą się różnić.

1. Najpierw zapisz plik Blendera

Otwórz nowy plik Blendera i zapisz go (na przykład jako chest.blend), zanim agent zacznie. Agent zmienia twój plik bezpośrednio, a własne ostrzeżenie README mówi, żeby zawsze najpierw zapisać pracę.

2. Wydaj agentowi prompt

W Claude Code lub Codex, przy otwartym i podłączonym Blenderze:

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.

Kilka wyborów w tym prompcie ma znaczenie dla gier. Zwykłe kolory bazowe eksportują się czysto, bo eksporter glTF bierze kolor bazowy z węzła Principled BSDF, według podręcznika Blendera o glTF. Jeden połączony obiekt to jeden mesh w three.js. Początek układu na dole sprawia, że skrzynia stoi na podłodze, gdy ustawisz jej pozycję na y = 0. Limit trójkątów powstrzymuje agenta przed dodawaniem subdivision.

3. Krok eksportu

Agent pisze Pythona dla Blendera. Eksport zwykle kończy się wywołaniem takim jak to, które używa parametrów opisanych w API export_scene Blendera:

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
)

Przeczytaj ten skrypt, zanim go zatwierdzisz, tak jak każdy skrypt, który uruchamia agent. Sprawdź, czy ścieżka wskazuje wnętrze twojego projektu i czy nic nie usuwa ani nie nadpisuje ważnych plików.

4. Kompresja GLB w glTF-Transform

glTF-Transform to narzędzie wiersza poleceń do optymalizacji plików glTF. Zainstaluj je i uruchom optimize. To polecenia z jego README:

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

Dla naszej skrzyni:

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

Domyślnie optimize kompresuje geometrię przez meshopt (--compress meshopt), ogranicza tekstury do 2048 px i spłaszcza graf sceny. Nasza skrzynia nie ma tekstur obrazkowych, więc --texture-compress webp nie ma tu nic do roboty, ale zostaw to dla przedmiotów, które je mają. Żeby skompresować tylko geometrię, glTF-Transform ma też gltf-transform meshopt input.glb output.glb --level medium.

5. Wczytanie w three.js

Plik skompresowany meshoptem wymaga dekodera meshopt. Bez niego GLTFLoader zgłasza „setMeshoptDecoder must be called before loading compressed files”. Poniższe importy pochodzą z własnych przykładów 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 pracuje w metrach i większość scen three.js też, więc skrzynia powinna się wczytać z szerokością około 1 m. Jeśli leży na boku, eksport prawdopodobnie poszedł bez export_yup. Jeśli jest czarna, scena potrzebuje świateł: dodaj HemisphereLight lub mapę otoczenia.

6. Poprawki

Zostaw Blendera otwartego i proś o zmiany, na przykład „zrób, żeby wieko otwierało się o 40 stopni jako osobny obiekt o nazwie Lid” albo „dodaj stos złota w środku”. Potem uruchom eksport i polecenie optimize jeszcze raz. Poproś agenta, żeby zachował skrypt eksportu w twoim projekcie, dzięki czemu za każdym razem dostaniesz te same ustawienia.

Ograniczenia i bezpieczeństwo

  • Uruchamia dowolnego Pythona w Blenderze. Ostrzeżenie z README: „The execute_blender_code tool allows running arbitrary Python code in Blender, which can be powerful but potentially dangerous.” Python w Blenderze może czytać i zapisywać każdy plik, do którego ma dostęp twoje konto. Poproś agenta, żeby pokazywał skrypty przed uruchomieniem, i je czytaj.
  • Zapisz plik przed każdą sesją. To samo ostrzeżenie kończy się słowami: „ALWAYS save your work before using it.” Zapisuj wersje po drodze (File → Save Incremental).
  • Włącz tryb bezpieczny, jeśli nie potrzebujesz dostępu do plików ani sieci. Ustaw dla serwera BLENDER_MCP_SAFE_MODE=1. Każdy skrypt jest wtedy sprawdzany przed uruchomieniem, a kod, który bezpośrednio czyta lub zapisuje pliki, uruchamia inne programy, korzysta z sieci albo działa dalej po zakończeniu skryptu, jest blokowany. Modelowanie, materiały, renderowanie, zapisywanie oraz import i eksport nadal działają.
  • Trzymaj to na localhost. Gniazdo dodatku nie ma uwierzytelniania ani szyfrowania. Każdy, kto dosięgnie tego portu, może uruchomić Pythona w twoim Blenderze. Nie wystawiaj go do sieci, której nie ufasz.
  • Dziel duże zadania na kroki. README mówi, że złożone operacje mogą wymagać mniejszych kroków, a limity czasu rozwiązuje się przez uproszczenie prośby. Pobieranie z Poly Haven działa w głównym wątku Blendera, więc Blender zamarza do końca pobierania.
  • Sprawdzaj licencje assetów. Poly Haven to CC0. Około 69% Poly Pizza to CC-BY, co wymaga podania autora. Dodatek zapisuje linię z autorstwem na zaimportowanych obiektach, albo możesz szukać z licence="CC0".
  • Telemetria. Domyślnie serwer wysyła anonimowy rekord użycia: ID instalacji, ID sesji, nazwę narzędzia, powodzenie, czas trwania, wersje, system i znacznik czasu. Twoje prompty, kod, zrzuty ekranu i dane sceny są zbierane tylko, jeśli się zgodzisz. DISABLE_TELEMETRY=true wyłącza wszystko.

Alternatywy dla Blender MCP

  • Blender MCP od Blender Lab: serwer samego Blendera. Jest mniejszy i zbudowany wokół dokumentacji API Pythona, podsumowań scen i plików, zrzutów ekranu i uruchamiania kodu, w tym trybu w tle dla plików .blend. Wymaga Blendera 5.1+ i ma licencję GPL-3.0. Jego wiki każe sklonować repozytorium i uruchomić go przez uv --directory .../blender_mcp/mcp run blender-mcp. Wybierz go, jeśli chcesz oficjalnego projektu i nie potrzebujesz wyszukiwania assetów ani generowania modeli przez AI.
  • Blender Agent Skills: 28 skilli dla Blendera 5.2 LTS+ (modelowanie, UV, baking, rigging, animacja, optymalizacja, eksport) dla Claude Code, Codex, OpenCode, Gemini CLI, Copilota i Cursora. MIT. Skille uczą agenta, jak wykonać pracę. Serwer MCP daje mu kontrolę nad Blenderem. Możesz używać obu.
  • blender-game-skills: skille Claude Code, które z concept artu robią zrigowane, gotowe do gry assety 3D. MIT.
  • Gotowe modele. Przy typowych przedmiotach darmowy model jest często szybszy niż generowanie własnego. Zobacz niskopoligonowe pliki GLB z Polyfork.

Nasza lista skilli agentów i serwerów MCP do tworzenia gier obejmuje odpowiedniki dla Godota, Unity, Unreala i three.js.

FAQ

Czy Blender MCP jest darmowy?

Tak. MCP for Blender ma licencję MIT, a dodatek jest darmowy. Jego strona Premium mówi, że każda funkcja działa w planie darmowym, a płatne jest tylko generowanie 3D. Możesz używać Meshy, Tripo, Hunyuan3D, Hyper3D Rodin lub World Labs z własnymi kluczami API albo kupić Premium (od 10 $/miesiąc 21 listopada 2026), żeby używać ich bez kluczy. Serwer Blender Lab jest darmowy na licencji GPL-3.0. Subskrypcję lub użycie API swojego agenta AI nadal opłacasz.

Czy Blender MCP jest bezpieczny?

Jest tak bezpieczny, jak kod, który pozwalasz mu uruchamiać. Agent wykonuje Pythona w Blenderze, a ten Python ma dostęp do plików twojego użytkownika. Zapisuj pracę, czytaj skrypty przed zatwierdzeniem, używaj trybu bezpiecznego (BLENDER_MCP_SAFE_MODE=1) i trzymaj port dodatku na localhost. Instaluj z oficjalnego repozytorium lub ze skryptu instalacyjnego projektu, nie z kopii, którą ktoś wgrał ponownie.

Czy istnieje oficjalny serwer Blender MCP?

Tak. Blender Lab publikuje jeden pod adresem projects.blender.org/lab/blender_mcp, a katalog konektorów Claude'a wymienia go jako „Blender” od Blender Lab. Bardziej znany MCP for Blender (dawniej blender-mcp) to projekt firm trzecich niezwiązany z Blender Foundation.

Czy Blender MCP działa z Claude Code?

Tak. Uruchom claude mcp add blender uvx mcp-for-blender, otwórz Blendera z włączonym dodatkiem i sprawdź przez claude mcp list. Claude Desktop konfiguruje się zamiast tego blokiem JSON w claude_desktop_config.json.

Czy Blender MCP działa z Codex?

Tak. Uruchom codex mcp add blender -- uvx mcp-for-blender albo dodaj [mcp_servers.blender] do ~/.codex/config.toml. README oferuje też wtyczkę Codex, która pokazuje żywy viewport Blendera obok czatu.

Czy Blender MCP działa z ChatGPT?

README wymienia klienty desktopowe i do kodowania (Claude Desktop, Claude Code, Codex, Cursor, VS Code, Windsurf, OpenCode, Antigravity), a nie aplikację ChatGPT. Codex to do tego agent OpenAI. Serwer łączy się z Blenderem działającym na twoim własnym komputerze, więc potrzebujesz klienta, który potrafi uruchomić lokalny serwer MCP.

Gdzie jest karta Blender MCP?

W widoku 3D Blendera naciśnij N, żeby otworzyć panel boczny. Karta nazywa się MCP for Blender. Jeśli jej nie ma, włącz Interface: MCP for Blender w Edit → Preferences → Add-ons.

Blender MCP czy skill do Blendera?

Serwer MCP pozwala agentowi działać na żywym Blenderze: tworzyć obiekty, oglądać viewport, eksportować. Skill uczy agenta przebiegów pracy i konwencji Blendera, co pomaga niezależnie od tego, czy potem pracuje przez MCP, czy uruchamia Blendera bez interfejsu z wiersza poleceń. Przy assetach do gier dobrze działa połączenie obu. Serwer MCP buduje, a pakiet skilli taki jak Blender Agent Skills obejmuje UV, optymalizację i ustawienia eksportu.

Źródła

Sprawdzone 21 listopada 2026: README mcp-for-blender, MCP for Blender Premium, Blender Lab blender_mcp i jego wiki konfiguracji, dokumentacja MCP w Claude Code, dokumentacja MCP w Codex, API export_scene w Blenderze, podręcznik Blendera o glTF 2.0, CLI glTF-Transform, GLTFLoader w three.js.