Apidog

올인원 협업 API 개발 플랫폼

API 설계

API 문서

API 디버깅

API 모킹

API 자동화 테스트

윈도우 11에서 커서와 함께 블렌더 MCP 실행하는 방법

Young-jae

Young-jae

Updated on March 24, 2025

Blender MCP는 BlenderCursor와 같은 도구를 통합하는 데 필수적인 도구로, 개발자가 작업 흐름을 간소화할 수 있게 해줍니다. 그러나 많은 사용자가 Windows 11에서 MCP를 작동시키려고 할 때 Client Closed 오류와 같은 문제를 경험하고 있습니다.

이 가이드는 MCP에 대해 알아야 할 모든 것과 설정 과정 및 일반적인 문제 해결 방법을 다룹니다.

💡
API 개발 및 테스트를 간소화하고 싶다면 Apidog가 API 설계, 테스트 및 문서화를 위한 종합 플랫폼을 제공합니다. Blender MCP가 모션 캡처 작업흐름을 자동화하는 것처럼, Apidog는 API 개발에 자동화를 가져와서 프로세스를 더 빠르고 효율적으로 만들어줍니다.
버튼

MCP란 무엇입니까?

MCP (Modular Code Processing)는 Cursor가 Blender와 같은 외부 응용 프로그램과 상호작용할 수 있도록 하는 시스템입니다. 이는 Blender 내에서 자동화, 스크립팅 및 AI 기반 상호작용을 가능하게 하여 다음과 같은 작업을 더 쉽게 처리할 수 있도록 합니다:

  • 자동 렌더링
  • 스크립트 실행
  • AI 지원 라이브 편집

간단히 말해, MCP는 Cursor와 Blender 간의 다리 역할을 하여 smoother한 통합과 생산성 향상을 가능하게 합니다.


Blender + MCP, 코딩을 위한 마법

당신이 Blender를 사용하는 개발자이거나 디자이너라면, Cursor와 함께하는 MCP는 여러 가지 이점을 제공합니다:
- AI 기반 개발 – 스크립트를 더 효율적으로 작성하고 실행합니다.
- 매끄러운 통합 – Cursor에서 직접 Blender 작업을 자동화합니다.
- 더 빠른 작업 흐름 – 여러 도구 간 전환 없이 단일 인터페이스를 사용합니다.

그러나 일부 호환성 문제 때문에 Windows 11에서 Blender MCP를 제대로 작동시키려면 일부 수동 설정이 필요합니다.

💡
내 MCP 서버에 대한 신바람이 나나요? 모든 MCP 서버를 한 곳에서 찾고 싶으신가요?

himcp.ai를 방문해 보세요. 멋진 MCP 서버와 클라이언트를 발견하는 데 전념하는 플랫폼입니다!

일반적인 문제: Windows 11에서 ‘Client Closed’ 오류

많은 사용자들이 MCP가 제대로 시작되지 않고 ‘Client Closed’ 오류가 발생했다고 보고합니다. 이 오류의 주요 원인은 다음과 같습니다:
- 잘못된 경로 구성 – MCP 구성 파일이 올바른 디렉토리를 가리키지 않습니다.
- 누락된 uv 패키지 관리자 – MCP가 정상적으로 작동하기 위해서는 uv가 필요합니다.
- 방화벽/안티바이러스 제한 – 보안 설정이 MCP의 연결을 차단할 수 있습니다.

다음 단계를 따라 이러한 문제를 해결하고 Windows 11에서 Blender MCP가 원활하게 실행되도록 하세요.


1단계: uv 패키지 관리자 설치

Blender MCP를 구성하기 전에 MCP 종속성을 관리하기 위해 필요한 uv를 설치해야 합니다.

Windows 11에서 uv 설치하기

PowerShell 또는 명령 프롬프트를 관리자 권한으로 엽니다.

다음 명령어를 실행합니다:

curl -fsSL https://astral.sh/uv/install.sh | sh

변경 사항을 적용하려면 컴퓨터를 재부팅합니다.

설치 확인을 위해 다음을 실행합니다:

uv --version

명령이 버전 번호를 반환하면 uv가 성공적으로 설치된 것입니다.


2단계: MCP 설정 구성

Blender MCP는 올바른 실행 파일 경로를 지정하기 위해 구성 파일(mcp.json)이 필요합니다.

mcp.json 편집

당신의 Cursor 구성 디렉토리로 이동합니다.

상당한 mcp.json 파일을 찾습니다. 존재하지 않는 경우 새로 만듭니다.

VS Code 또는 Notepad++와 같은 텍스트 편집기에서 엽니다.

다음 구성을 추가합니다:

{
  "mcpServers": {
    "blender": {
      "command": "C:\\Users\\<your-username>\\.local\\bin\\uvx.exe",
      "args": ["blender-mcp"]
    }
  }
}
  • 반드시 <your-username> 을 실제 Windows 사용자 이름으로 교체하세요.
  • uvx.exe의 파일 경로가 올바른지 확인하세요.

파일을 저장하고 닫기.


3단계: Cursor 재시작 및 새로 고침

구성을 업데이트한 후 다음 단계를 따르세요:

  1. PC를 재부팅하여 변경 사항을 적용합니다.
  2. Cursor를 열고 Blender MCP가 사용 가능한 통합 목록에 있는지 확인합니다.
  3. MCP가 나타나지 않으면:
  • Ctrl + Shift + R를 눌러 Cursor를 수동으로 새로 고칩니다.
  • Cursor를 한두 번 새로 고칩니다.
  • 시스템이 MCP를 인식할 수 있도록 몇 초 동안 기다립니다.
  1. 모든 설정이 올바르게 되어 있다면, Blender MCP 옆에 녹색 표시기가 나타나, 정상적으로 실행되고 있음을 확인할 수 있습니다.

4단계: 추가 문제 해결

MCP가 여전히 작동하지 않으면 다음 수정 방법을 시도하세요:

1. Cursor를 관리자 권한으로 실행

일부 기능은 정상적으로 작동하기 위해 상승된 권한이 필요합니다.

  • Cursor 바로 가기를 마우스 오른쪽 버튼으로 클릭하고 관리자로 실행을 선택합니다.

2. MCP 재설치

MCP가 누락되었거나 손상된 경우, 다음을 사용하여 재설치합니다:

uv install blender-mcp

3. 방화벽 및 안티바이러스 설정 확인

Windows 방화벽 또는 안티바이러스 소프트웨어가 MCP의 연결을 차단할 수 있습니다.

  • Cursor와 Blender MCPWindows Defender 예외 목록에 추가합니다.
  • 잠시 안티바이러스를 비활성화하고 MCP가 시작되는지 확인합니다.

5단계: MCP가 작동하는지 확인

모든 설정이 완료되면, Cursor에서 간단한 스크립트를 실행하여 MCP를 테스트합니다.

Cursor를 열고 새 Blender 스크립트를 만듭니다.

다음 Python 명령어를 복사하여 붙여넣습니다:

import bpy
bpy.ops.mesh.primitive_cube_add()

스크립트를 실행하고 Blender에 큐브가 나타나는지 확인합니다.
-  스크립트가 성공적으로 실행되면 MCP가 완전히 작동 중입니다!

💡
Blender MCP가 Blender의 자동화를 향상시키는 동안, API 작업을 하고 있다면 Apidog가 강력한 올인원 API 설계, 테스트 및 문서화 플랫폼을 제공합니다.
버튼

결론

Windows 11에서 Blender MCP를 설정하는 것은 까다로울 수 있지만, 이 가이드를 따르면 Cursor와 Blender 간의 완전한 통합을 갖출 수 있습니다.

주요 요점:

✔ MCP 종속성을 관리하기 위해 uv를 설치하세요.
✔ 올바른 uvx.exe의 경로로 mcp.json을 업데이트하세요.
✔ 변경 사항을 적용하려면 Cursor와 PC를 재시작하세요.
권한 확인, MCP 재설치 및 방화벽 설정 조정을 통해 문제를 해결하세요.

이 단계들을 따르면, 이제 Cursor 내에서 Blender MCP를 원활하게 사용할 수 있으며, 강력한 자동화 및 AI 지원 작업 흐름을 잠금 해제할 수 있습니다.