블렌더 MCP 설치, 블렌더 몰라도 클로드로 3D 장면 시작하는 법
블렌더 MCP는 클로드가 블렌더 안에서 물체와 재질을 직접 만들게 해 주는 무료 오픈소스 연결 도구입니다. 모델링을 몇 달 배우기 전에 말로 먼저 3D 장면을 시작해 볼 수 있습니다. 이 글은 블렌더 MCP 설치부터 첫 장면 요청, 시작 전에 꼭 지킬 안전 수칙, 막힐 때 확인할 점까지 정리했습니다. 기준은 2026년 11월 저장소(mcp-for-blender) 안내입니다.

블렌더 MCP가 하는 일
블렌더는 무료 3D 제작 프로그램이고, MCP는 AI가 외부 프로그램을 직접 다루게 해 주는 연결 규격입니다. 블렌더 MCP는 두 부분으로 되어 있습니다. 블렌더 안에서 도는 애드온(추가 기능)이 연결 통로를 열고, 클로드 쪽 MCP 서버가 그 통로로 명령을 보냅니다.
요청이 들어가면 클로드가 블렌더용 파이썬 코드를 직접 짜서 실행해 물체와 재질을 배치합니다. 다 만든 뒤에는 look
저장소는 github.com/ahujasid/mcp-for-blender(예전 이름 blender-mcp)이고 MIT 라이선스입니다. 블렌더 재단이 만든 공식 도구가 아니라 개인이 만든 서드파티 연결입니다.
시작 전에 꼭 지킬 것
AI가 블렌더 안에서 임의의 파이썬 코드를 직접 실행합니다. 저장소 README도 쓰기 전에 항상 작업을 저장하라고 경고합니다.
- 블렌더에서 작업 중인 파일이 있으면 먼저 저장하고, 중요한 파일은 복사본을 따로 둡니다.
- 애드온의 연결 통로에는 인증과 암호화가 없습니다. 믿을 수 있는 네트워크가 아니라면 내 컴퓨터 안(localhost)에서만 쓰도록 둡니다.
- README에는 실행 전에 스크립트를 점검하는 안전 모드(환경 변수
BLENDER_MCP_SAFE_MODE=1)가 있습니다. 처음 써 보는 사람은 켜 두는 편이 마음 편합니다. - 서버는 한 번에 한 곳에서만 띄웁니다. 클로드 데스크톱과 클로드 코드를 동시에 연결하면 충돌할 수 있습니다.
준비물
- 블렌더 3.0 이상(blender.org에서 무료로 받습니다)
- 파이썬 3.10 이상
- uv(파이썬 도구를 받아 바로 실행하는 프로그램).
pip install uv가 아니라 공식 설치 방법으로 설치하라고 안내돼 있습니다. - 클로드 데스크톱 앱 또는 클로드 코드
- 도구 자체는 무료입니다. AI로 3D 모델을 생성해 주는 기능(Hyper3D Rodin, Meshy, Tripo 등)은 해당 서비스의 키나 유료 요금이 따로 필요합니다.
설치하고 연결하기
- 블렌더가 설치돼 있는지 확인하고 한 번 실행해 봅니다. 확인: 블렌더 기본 화면이 열립니다. 확인했다면 닫아도 됩니다.
- uv를 설치합니다. 윈도우는 PowerShell에서 아래 명령을 실행한 뒤 터미널을 새로 엽니다. 맥은
brew install uv를 씁니다. 확인: 새 터미널에서 uv --version을 실행하면 버전이 나옵니다.
winget install --id=astral-sh.uv -e
- 한 줄 설정 명령을 실행합니다. 확인: 내 컴퓨터에 있는 AI 앱 목록이 나오고, 설정할 앱을 고르면 블렌더 애드온 설치와 활성화까지 자동으로 진행됩니다. 기존 설정은 유지되고 바뀐 파일은
.bak으로 백업됩니다.
uvx mcp-for-blender setup
- 클로드 데스크톱을 쓴다면 앱을 완전히 종료한 뒤 다시 엽니다. 윈도우는 창만 닫지 말고 작업 표시줄 오른쪽 아래의 트레이에서 종료합니다. 확인: 다시 열었을 때 blender 도구가 연결 목록에 보입니다.
- 클로드 코드를 쓴다면 터미널에서 아래 명령으로 등록합니다. 확인:
claude mcp list에서 blender가 연결됨으로 보입니다.
claude mcp add blender uvx mcp-for-blender
- 블렌더를 열고 3D 화면에서
N키를 눌러 오른쪽 사이드바를 엽니다. 확인: "MCP for Blender" 탭이 보입니다. 보이지 않으면 Edit → Preferences → Add-ons에서 "Interface: MCP for Blender"에 체크합니다. - 이 탭에서 "Start MCP Server" 버튼을 누릅니다. 확인: 서버가 시작됐다는 표시가 나옵니다.
자동 설정이 어렵다면 저장소의 addon.py
첫 장면 요청하기
연결된 클로드에게 만들고 싶은 장면을 말로 요청합니다. 클로드가 블렌더 코드를 짜서 물체와 재질을 깔고, 끝나면 화면을 다시 보고 어색한 곳을 고칩니다.
용이 금화 항아리를 지키는 던전을 만들어 줘. 다 만든 뒤에는 화면을 다시 확인하고 어색한 곳을 고쳐 줘.
한 번에 큰 장면을 요청하면 시간 초과가 날 수 있습니다. 바닥과 벽, 항아리, 용 순서로 나누어 요청하는 편이 안정적입니다.
- 확인: 블렌더 3D 화면에 물체가 생기고, 클로드가 만든 내용을 설명해 줍니다.
- 마음에 들지 않는 부분은 "용을 항아리 오른쪽으로 옮기고 조명을 더 어둡게 해 줘"처럼 짚어서 이어 요청합니다.
- 소재 파일을 가져올 때 블렌더가 멈추면 해상도를 1k나 2k로 낮춰 달라고 요청합니다.
막힐 때
spawn uvx ENOENT오류: AI 앱이uvx를 찾지 못한 것입니다. 터미널에서 where uvx(맥은which uvx)로 전체 경로를 확인해 설정의 명령 자리에 그 경로를 넣습니다.- 연결이 안 된다: 블렌더에서 서버를 시작했는지, AI 앱을 완전히 종료했다가 다시 열었는지 봅니다. 서버를 두 곳에서 동시에 띄우지 않았는지도 확인합니다.
- 요청이 시간 초과로 끝난다: 장면을 작게 나누어 단계별로 요청합니다.
자주 묻는 질문
블렌더를 하나도 몰라도 쓸 수 있나요?
장면을 시작하는 것까지는 가능합니다. 말로 요청하면 클로드가 코드를 짜서 물체를 만들어 줍니다. 다만 결과를 다듬거나 저장, 내보내기를 하려면 블렌더 기본 화면 조작을 조금은 알아야 하고, 처음에는 작은 장면부터 시작하는 편이 좋습니다.
블렌더 MCP는 무료인가요?
블렌더와 MCP 도구, Poly Haven 소재는 무료입니다. AI 3D 모델 생성 서비스는 해당 서비스의 키나 요금이 따로 필요합니다. 클로드 사용량은 요금제 한도에서 차감됩니다.
맥에서도 되나요?
됩니다. 이 글의 설치 단계는 윈도우와 맥을 모두 적었고, 차이는 uv 설치 명령과 앱을 종료하는 위치 정도입니다. 클로드 코드 쪽은 운영체제와 관계없이 같은 명령을 씁니다.
작업 중인 블렌더 파일이 망가질 수 있나요?
가능성이 있습니다. AI가 임의의 파이썬 코드를 실행하므로 요청을 잘못 이해하면 장면을 지우거나 바꿀 수 있습니다. 시작 전에 저장하고 중요한 파일은 복사본에서 작업하세요.
이 글의 본문은 아래 원본 유튜브 영상의 내용을 바탕으로 쓸모연구소가 다시 정리해 쓴 것입니다. 세부 내용과 최신 정보는 원본 영상과 공식 안내에서 확인해 주세요.
원본 영상 보러가기 ↗