Blender Bridge MCP
Blender Bridge MCP는 Blender용 MCP 서버로, MCP를 지원하는 모든 앱에 사용자의 Blender에서 작업할 수 있는 도구를 제공합니다. Claude Code, Codex, Cursor 및 기타 에이전트가 씬을 읽고, 코드를 실행하고, 스크린샷으로 결과를 확인하며 요구사항에 맞게 씬을 다듬습니다. 서버는 Blender Bridge 앱 내에 기본 포함되어 있어 별도로 다운로드하거나 빌드할 필요가 없습니다.
MCP란 무엇인가요
MCP(Model Context Protocol)는 AI 앱이 외부 도구를 연결하는 데 사용하는 개방형 표준입니다. 서버는 에이전트에게 사용 가능한 작업을 알리고, 에이전트는 작업에 필요할 때 해당 작업을 호출합니다. Blender Bridge MCP를 사용하면 해당 목록에 Blender 작업(씬 읽기, 코드 실행, 스크린샷 캡처, 프레임 렌더링, 모델 익스포트, 씬을 체크포인트로 되돌리기)이 추가됩니다.
두 가지 연결 방법
| 로컬 | 서버 주소 | |
|---|---|---|
| 용도 | 한 컴퓨터에 AI 앱과 Blender가 모두 있는 경우; MCP가 앱과 직접 통신합니다 | 동일한 컴퓨터를 포함한 모든 기기의 채팅이나 앱, 그리고 공동 작업; 명령이 Blender Bridge 서버를 통해 전달됩니다 |
| 방법 | Blender Bridge 앱의 stdio 구성 | 주소 https://mcp.blenderbridge.com/mcp 및 Blender Bridge 계정 |
| 지원 대상 | Claude Desktop, Claude Code, Codex, Cursor, VS Code, Windsurf, Antigravity, JetBrains AI Assistant, Gemini CLI, Cline, Kiro, Zed, LM Studio, Trae, Qwen Code, Kimi Code, Cherry Studio, CodeBuddy, Tongyi Lingma | ChatGPT, Claude, Mistral Le Chat, Perplexity, Gemini(미국 내 개인 계정, 18세 이상, 영어, Keep Activity 켜짐) 및 서버 주소를 지원하는 기타 앱 |
한 번의 연결로 현재 컴퓨터의 Blender는 물론, 로그인 후 다른 위치에 있는 본인의 컴퓨터와도 연동됩니다.
연결 방법
먼저 이메일 인증을 완료하고 유효한 액세스 권한이 있는 계정으로 Blender Bridge 앱에 로그인하세요. 아직 계정이 없다면 앱 설치부터 시작하세요.
가장 빠른 방법: 설정 지침 사용
Blender Bridge 앱에서 연결 창을 열고 MCP를 선택한 뒤 설정 지침을 복사하세요. 사용 중인 앱의 채팅창에 붙여넣고 Blender Bridge MCP에 연결하도록 요청합니다. Codex, Claude Code, Cursor처럼 설정을 직접 편집할 수 있는 에이전트는 자체적으로 연결을 추가합니다. 직접 편집이 불가능한 앱의 경우 AI가 구성을 추가할 위치를 안내합니다.
수동 방법: stdio 구성 사용
앱에서 MCP 구성을 복사하세요. 현재 설치 환경에 맞는 명령어, 인수 및 환경 변수가 이미 포함되어 있으므로 경로를 직접 입력할 필요가 없습니다.
- Claude Desktop — Settings → Developer → Edit Config에서 구성을 추가합니다.
- Cursor, Windsurf, Antigravity, Gemini CLI, Cline, Kiro — 앱의 MCP 설정 파일에 stdio 서버로 추가합니다.
- VS Code — MCP: Add Server 명령을 사용하거나
.vscode/mcp.json(최상위 키는servers이며mcpServers가 아님)에 추가합니다. - JetBrains AI Assistant — AI Assistant 설정의 MCP 항목에 추가합니다.
- Zed — 컨텍스트 서버 설정에 추가합니다.
- Qwen Code —
settings.json또는qwen mcp add명령을 사용합니다. - Kimi Code —
kimi mcp add명령을 사용합니다. - Trae — MCP 설정에서 Add → Add Manually를 선택합니다.
- Cherry Studio — Settings → MCP Servers를 선택합니다.
- CodeBuddy —
.mcp.json파일에 추가합니다. - Tongyi Lingma — 플러그인의 MCP 서비스 항목에 추가합니다.
서버를 추가한 후 활성화하고 도구 목록을 새로고침하세요. 앱에서 요청하는 경우 재시작합니다.
서버 주소로 연결
커넥터 또는 MCP 서버 설정에서 https://mcp.blenderbridge.com/mcp를 추가하고 Blender Bridge 계정으로 로그인한 다음, AI에게 컴퓨터 목록을 표시하고 하나를 선택하도록 요청하세요. 해당 컴퓨터에서 Blender Bridge 앱이 실행 중이어야 합니다.
에이전트가 수행할 수 있는 작업
| 작업 | 도구 |
|---|---|
| 씬 파악 | get_scene_state, take_screenshot, get_blender_info |
| 씬 생성 및 변경 | execute_blender_code — 임의의 Blender Python 코드를 실행하고 작업 단계에 이름 지정 |
| 장시간 작업 모니터링 | get_blender_operation_status, cancel_blender_operation |
| 이전 단계로 되돌리기 | scene_checkpoints — AI의 작업 단계가 체크포인트로 저장되며, 사용 가능한 체크포인트로 씬을 되돌린 뒤 그 복원 작업 자체를 취소할 수도 있습니다; undo_last_action |
| Blender 정보 조회 | lookup_blender_api — 조회 가능한 Blender 버전(3.6, 4.2, 4.4, 4.5, 5.0, 5.1, 5.2)의 API 레퍼런스, search_blender_manual — Blender 5.2 매뉴얼, get_blender_recipe — 자주 수행하는 작업을 위한 레시피 |
| 준비된 에셋 활용 | find_free_assets — Poly Haven 및 ambientCG의 텍스처, Poly Haven의 모델 및 HDRI 환경 |
| 참조 자료 기반 작업 | set_reference_image, compare_reference_render — 참조용 사진 설정 및 나란히 비교 |
| 렌더링 | render_project_image — 프로젝트 폴더에 PNG 프레임 저장. 긴 렌더링 및 애니메이션의 경우 AI가 execute_blender_code를 통해 백그라운드 렌더링을 시작하여 별도의 Blender에서 씬 복사본을 렌더링하며 진행 상황 확인 및 중지가 가능합니다 |
| 저장 및 익스포트 | save_blend_file, export_model — 웹 및 Godot용 GLB, Unity 및 Unreal Engine용 FBX, AR용 USDZ, 3D 프린팅용 STL |
| 자체 설정 | open_blender, select_blender, ensure_blender_extension, restart_blender_with_extension, check_connection |
| 공동 작업 | invite_collaborator, accept_collaboration, end_collaboration |
에이전트가 필요한 도구를 직접 선택합니다. 예를 들어 "모바일 게임용 로우폴리 숲을 만들고 Unity용 FBX로 익스포트해 줘"와 같이 작업을 설명하기만 하면 됩니다.
에이전트가 Blender를 인식하지 못하는 경우
- AI에게 Blender와의 연결 상태를 확인하도록 요청하세요. Blender Bridge가 앱 미실행, Blender 종료, Blender Bridge 확장 기능 미설치 등 누락된 원인을 정확히 알려줍니다. AI가 직접 Blender를 열고 확장 기능을 설치한 후 Blender를 재시작합니다.
- 앱이 서버를 전혀 인식하지 못하는 경우 앱에서 구성을 다시 복사하고 서버를 활성화한 뒤 도구 목록을 새로고침하거나 앱을 재시작하세요.
다음: Blender Bridge 브라우저 확장: ChatGPT, Claude, Gemini 및 DeepSeek을 Blender에서 사용