Blender 공식 MCP 서버를 Claude에 연결하여 교실 만들기 (시행착오 기록)

서론

Blender에 공식 MCP 서버가 출시되었다. 이를 사용하면 Claude로부터 자연어로 Blender를 조작할 수 있을 것이다. 시험해보고 싶었다 ── 결론부터 말하자면, 작동했다. Claude에게 "일본의 교실을 만들어줘"라고 부탁했더니, 칠판도 교탁도 학생 책상도 있는, 그럴듯한 장면이 완성되었다.

다만, 공식 절차대로 애드온 (Add-on)을 설치하려다 세 군데에서 막혔다. 같은 곳에서 멈추는 사람이 적지 않을 것이기에, 시행착오와 최종적으로 효과가 있었던 회피책을 그대로 기록한다. 에러 메시지, 버전 번호, 경로는 검색을 통해 들어온 사람이 그대로 대조할 수 있도록 실제 내용 그대로 기재한다.

대상 버전: Blender 5.1.2 (Windows / x64)

검증일: 2026년 5월 31일

대상 환경

Blender 5.1.2 (Windows / x64)
5.1 계열은 2026-03-17 출시, 5.1.2는 2026-05-19의 버그 수정판. 집필 시점의 안정판.
설치한 것: 공식 Blender Lab의 MCP 서버 (https://www.blender.org/lab/mcp-server/)
프로젝트: https://projects.blender.org/lab/blender_mcp
연결 대상 LLM: Claude (Claude 앱 측의 MCP 연결)

TL;DR (문제 발생 지점 요약표)

The extension dropped was not found in the remote repository
→ 리포지토리 (Repository) 인덱스 미취득. 동기화(Sync) 또는 재시작. 해결되지 않으면 다음으로.
remote data unavailable, sync with the remote repository
→ 네트워크/SSL 차단 의심 (백신·방화벽·VPN). System Console에서 에러 확인.
결국 연결되지 않을 때 → ZIP 파일을 디스크에서 설치하는 것이 가장 빠름. 자동 업데이트는 포기.
공식 (blender.org/lab)과 제3자 제작 blender-mcp는 별개의 것이다.

애초에 무엇을 설치하는가 ── 부품은 2개

공식 MCP는 "2개의 부품이 연동한다"라고 정리하면 이해하기 쉽다. 이 부분을 먼저 파악해 두면, 어디에서 막히고 있는지 구분하기가 수월해진다.

(A) Blender 애드온 (Extension): Blender 내부에서 동작하며, 요청을 받아 실행한다. TCP로 대기한다 (이번 설정: Host localhost / Port 9876). 이것이 설치되어 동작하지 않으면 아무것도 시작되지 않는다.
(B) MCP 서버 본체 (별도 프로세스): Claude 등의 LLM 클라이언트로부터 기동되어, (A)로 중계한다.

이번 스크린샷으로 확인한 (A)의 애드온 정보:

항목	값
명칭	MCP
...

이 글의 시행착오는 거의 전부 (A)를 설치하는 단계에서 발생했다.

시행착오 ① ── 드래그 & 드롭은 "2번" 필요했다

공식 절차에서는 애드온을 Blender에 드래그 & 드롭하여 설치한다. 이것이 사실 2단계로 나뉘어 있다.

1회차: "Blender Lab 리포지토리 (lab.blender.org)"를 추가한다.
2회차: 애드온 본체를 설치한다.

1회차는 성공했다 (Repository found: "lab.blender.org"). 그런데 2회차에서 다음 메시지가 나온다.

익스텐션 설치
Repository found: "lab.blender.org"
The extension dropped was not found in the remote repository.
...

리포지토리는 추가되었는데, 드롭한 애드온이 "리포지토리 안에 없다"라고 판정되고 있다.

원인은, 리포지토리는 등록되었지만 그 내용물 (인덱스)을 아직 가져오지 못했기 때문이다. "기동 시 업데이트 체크"는 말 그대로 "기동 시"에만 동기화하므로, 리포지토리를 추가한 직후의 동일한 세션에서는 내용물이 비어 있는 상태다. 그래서 드롭한 애드온이 목록에서 발견되지 않는다고 판정되는 것이다.

……라는 것이 처음에 세운 가설이었다. 그렇다면 재시작하면 동기화될 것이다 ── 라고 생각했지만, 후술하듯이 이것은 재시작만으로는 해결되지 않았다. 동기화 자체가 실패하고 있었으나, 이 시점에서는 아직 깨닫지 못했다.

난관 ② ── 목록에 MCP가 나타나지 않음

그렇다면, Preferences(환경 설정) > 「Get Extensions(익스텐션 입수)」에서 mcp를 검색했다. 검색 결과 없음.

리포지토리(Repository) 목록을 보면 lab.blender.org는 추가됨·활성화됨·URL https://lab.blender.org/·「Check for updates on startup(시작 시 업데이트 확인)」 On 상태다. 등록 자체는 문제 없어 보인다.

난관 ①과 동일한 「내용물이 비어 있음」 증상일 것이라 생각하여, 수동 동기화(Refresh)와 재시작을 시도했다.

난관 ③ ── 리포지토리 동기화 자체가 실패하고 있었다

재시작 후, 익스텐션 입수 화면에서 이번에는 이 경고가 나타났다.

리포지토리 경고:
Repository: "lab.blender.org" remote data unavailable, sync with the remote repository.

이것은 Blender가 리포지토리 목록 데이터를 네트워크를 통해 가져오지 못하고 있는 상태다. 다운로드한 파일이나 MCP 고유의 문제가 아니라, Blender 커뮤니티에서는 extensions.blender.org에서도 빈번하게 발생하는 유명한 에러다. MCP에 국한되지 않고 「익스텐션을 동기화할 수 없음」 전반에서 발생한다.

자주 발생하는 원인과 대처법을 내가 확인한 범위 내에서 정리해 둔다.

백신 소프트웨어 / 방화벽 / VPN이 Blender의 통신 (SSL)을 차단하고 있다. 브라우저에서 사이트가 보이더라도, Blender의 통신만 차단되는 경우가 있다 (이 부분이 맹점이다).
Windows의 경우, Microsoft Visual C++ Redistributable (재배포 가능 패키지)를 다시 설치하여 해결되었다는 보고가 있다.
캐시(Cache) 손상 시에는, extensions.cache 내의 compat.dat를 백업(퇴피)하고 재시작하면 해결된 사례가 있다.

문제 분리의 정석은, Window > Toggle System Console로 시스템 콘솔을 연 상태에서 「Refresh Remote」를 실행하여, SSL 에러인지 연결 거부(Connection Refused)인지를 확인하는 것이다.

다만, 솔직히 말하자면 나는 여기서 원인 특정까지는 하지 않았다. 목적은 MCP를 작동시키는 것이지, 리포지토리 동기화를 고치는 것 자체가 아니기 때문이다. 동기화 불량을 깊게 파고들기보다, 다음에 쓸 ZIP 직접 설치로 전환하는 것이 빠르다고 판단했다. 그래서 이 글에서는 「동기화 실패 원인은 이것이었다」라는 결론을 내리지 않는다. 같은 경고로 어려움을 겪고 있는 사람은 위의 후보들을 시도해 보되, 해결되지 않는다면 회피책으로 넘어가는 것이 현실적이라고 생각한다.

해결 ── ZIP을 「Install from Disk(디스크에서 설치)」하기

리모트 동기화를 고치는 것보다 더 빠른 회피책이 있다. 애드온의 ZIP 파일을 직접 설치하는 것이다. 리포지토리를 거치는 과정을 건너뛴다.

ZIP은 공식 Lab 페이지에서 입수할 수 있다.

입수처: https://www.blender.org/lab/mcp-server/

절차:

위 페이지에서 애드온 ZIP을 다운로드해 둔다.
Blender의 익스텐션 입수 화면 우측 상단의 ▼ 메뉴를 연다.
**「Install from Disk(디스크에서 설치)」**를 선택한다.
다운로드한 ZIP을 선택한다.

결과, 애드온 「MCP (Blender Lab / v1.0.0)」가 활성화되었고, Server is running 표시까지 도달했다. 설치 경로는 다음과 같았다.

C:\Users\<user>\AppData\Roaming\Blender Foundation\Blender\5.1\extensions\lab_blender_org\mcp\__init__.py

解決: MCPアドオン（Blender Lab / v1.0.0）が有効化され、Host localhost / Port 9876 で Server is running まで到達

Claude와의 연결

Blender 측의 애드온이 localhost:9876에서 가동 중이라면 (Auto Start On), 나머지는 Claude 측의 MCP 연결을 통과시키기만 하면 된다.

나는 Claude 앱의 커넥터(Connector) 기능을 통해 연결했다. 절차는 다음과 같다.

설정(Settings) → 커넥터(Connector) 열기 -
**「커스터마이즈(Customize)」**로 이동 -
「커넥터 추가(Add Connector)」 (+ 버튼) 클릭 - 검색창에 Ble를 입력하면, Blender 공식 커넥터가 나타나므로 이를 추가한다.

연결이 완료되면, Claude에서 execute_blender_code와 같은 도구(Tool)를 호출할 수 있는 상태가 된다.

실제로 만들어 보았다 ── 일본의 교실

연결이 되었으므로 바로 요청해 보았다.

플랜 모드(Plan mode)에서 시작하여, Blender를 조작해 일본의 교실을 만들도록 요청했다.

결과는 서두의 이미지와 같다. 칠판, 교탁, 정렬된 학생 책상, 벽시계, 창문이 있는 일본 교실다운 장면이 생성되었다. 오른쪽 아웃라이너(Outliner)를 보면 Desks 컬렉션에 다수의 책상 오브젝트가 나열되어 있는 것을 확인할 수 있다.

다만, 가까이서 다른 각도로 보면 허점이 보인다. 의자는 생성되었으나, 배치가 어긋나 책상에 파묻혀 있다. 책상과 의자를 각각 만들 수는 있어도, "의자를 책상 아래에 올바르게 배치한다"와 같은 공간적인 정합성(Spatial consistency)까지는 깔끔하게 맞추지 못했다.

솔직히 말하면, 이러한 막힘은 중간에도 있었다. AI를 이용한 모델링(Modeling)은 한 번에 완벽하게 되지 않으며, 무너진 부분을 지적하며 **반복과 지시의 미세 조정(Fine-tuning)**을 거듭해야 하는 작업이 된다. 그럼에도 불구하고, 대화만으로 이 정도 그럴싸한 장면이 구축된다는 점은 순수하게 흥미롭다.

요약

공식 Blender MCP를 Claude에 연결하는 과정에서 겪은 함정과 효과적이었던 대처법을 다시 정리한다.

막힘 ① (The extension dropped was not found in the remote repository): 리포지토리(Repository)는 추가할 수 있어도 인덱스(Index)를 가져오지 못함. 동기화(Sync) 또는 재시작 필요.
막힘 ② (검색해도 MCP가 나오지 않음): 마찬가지로 내용이 비어 있음. 동기화를 통해 해결 시도.
막힘 ③ (remote data unavailable, sync with the remote repository): 네트워크/SSL 차단을 의심. 시스템 콘솔(System Console)에서 에러 확인.
해결책: 고쳐지지 않을 때는 ZIP 파일을 디스크에서 직접 설치하는 것이 가장 빠름. 자동 업데이트는 포기한다. - 공식(blender.org/lab)과 제3자 제작 blender-mcp는 별개의 것이다.

같은 에러를 검색해서 들어온 분들이 여기서 멈추지 않고 앞으로 나아갈 수 있다면 글을 쓴 보람이 있을 것이다.

참고

Blender Lab: MCP server ── 공식 MCP 서버 안내 페이지
blender_mcp 프로젝트 ── 공식 버전의 프로젝트 리포지토리