Claude 또는 Cursor와 같은 도구에서 '현재 열려 있는 Blender 장면을 건드리게 하는' 애드온, Klakix Bridge의 사용법을 정리했습니다. 필자는 Klakix 개발팀 소속이므로, 중립적인 리뷰가 아닌 제작자 관점의 도입 가이드로 읽어주시기 바랍니다.
Klakix Bridge란 무엇인가
Blender 4.2 이상에서 작동하는 무료 GPL-3.0 애드온입니다. 호스트형 Klakix MCP 서버와 Blender를 연결하여, MCP 클라이언트(Claude, ChatGPT, Cursor, Claude Code 등)가 열려 있는 장면을 조작할 수 있게 합니다. 에이전트가 세트를 구성하고, 라이트와 카메라를 배치하며, 애니메이션을 추가하고, 렌더링하며, AI로 생성한 이미지나 비디오를 장면에 배치합니다. 게다가 각 단계 후에 결과 화면을 직접 보고 확인할 수 있습니다.
README에 기재된 특징들을 나열합니다.
- 커넥터는 하나입니다. 이미지/비디오 생성을 위해 사용하는 MCP의 URL(
https://klakix.com/api/mcp)이 그대로 Blender 조작에도 사용됩니다. 별도의 브릿지 서버를 추가할 필요가 없습니다. -
로컬 포트나 Python 환경 준비가 불필요합니다. 애드온은 외부로 나가는 HTTPS 연결만 유지하면 되기 때문에, 로컬 머신에서 대기하는 것이 없습니다. 따라서 브라우저상의 claude.ai나 chatgpt.com에서도 구동할 수 있습니다.
- 1배치(Batch)가 Ctrl+Z 한 번. 조작은 배치 단위로 실행되며, 실패한 배치는 일괄적으로 롤백됩니다. -
에이전트가 결과를 볼 수 있습니다. 배치마다 뷰포트, 카메라, 간이 렌더링 중 하나의 이미지를 반환할 수 있습니다. -
Python 실행은 초기 상태에서 비활성화되어 있습니다. 임의 코드를 실행하는 run_python 기능은 패널에서 'Allow Python'을 활성화했을 때만 나타납니다.
설치
- 최신 릴리스에서
klakix-blender.zip 파일을 다운로드합니다(https://klakix.com/indir/klakix-blender.zip에서도 받을 수 있습니다). -
Blender 4.2 이상 버전에서, zip 파일을 창에 드래그앤드롭하거나,
Edit → Preferences → Get Extensions → ⌄ → Install from Disk를 통해 불러옵니다. Blender가 물어보면 Online Access를 허용해 주세요. 애드온은 네트워크를 사용합니다. -
3D 뷰포트에서 N을 눌러 Klakix 탭을 열고, Connect를 클릭합니다. 브라우저가 열리므로 로그인하고, Blender에 표시된 8자리 코드를 확인하여 승인합니다. -
아직 안 되었다면, 사용 중인 AI 앱에 Klakix 커넥터를 추가합니다(Claude, ChatGPT, Cursor, Claude Code 등의 설정). 그 후, 예를 들어 다음과 같이 요청합니다.
'Blender 장면에 향수병의 무드 있는 프로덕트샷을 만들어줘.'
브릿지 도구 자체는 크레딧을 사용하지 않습니다. 장면에 넣을 이미지, 비디오, 3D 모델을 생성할 때만 평소대로 Klakix 크레딧이 소모됩니다.
에이전트가 할 수 있는 것
에이전트는 MCP 서버의 list_desktop_apps, get_app_operations, run_in_app, capture_app_view를 호출합니다. 현재 애드온이 공개하고 있는 조작은 다음과 같습니다.
분류 및 작업 목록
| 분류 | 작업 |
|---|
| 알아보기 | scene_info, list_objects, object_info |
| 생성하기 | add_object (프리미티브, 텍스트), transform, rename_object, set_parent, set_visibility, delete_objects, add_modifier |
| 외형/재질 | set_material (색상, 메탈릭, 러프니스, 에미션), add_light, set_world, polyhaven_search, polyhaven_apply (무료 CC0 HDRI, 텍스처, 모델) |
| 카메라 및 시간 | add_camera, look_at, keyframe, set_frame_range |
| 출력 | set_render, save_file, 뷰포트 / 카메라 / 렌더링 스냅샷 |
| 미디어 | import_media (생성된 이미지나 비디오를 텍스처가 적용된 평면으로, glTF, OBJ, FBX, USD 등의 모델, HDR/EXR을 월드 라이트로 불러오기) |
| 고급 | run_python (허용된 경우만) |
blender -b --factory-startup --python tests/test_ops.py
확장 기능 패키지 검증 및 빌드
blender --command extension validate klakix_bridge
...
로컬 개발 시에는 환경 변수 KLAKIX_BRIDGE_URL을 사용하여 서버 주소를 덮어쓸 수 있습니다. 작동 확인은 Windows의 Blender 4.2 LTS와 5.2 LTS에서 진행했습니다. 이 애드온은 순수한 Python으로 작성되었으며 네이티브 컴포넌트는 없습니다.
관련 링크
- 가이드, 타 제품과의 비교, FAQ: https://klakix.com/blender-mcp
- 애드온 소스: github.com/klakix-ai/klakix-blender
- MCP 서버의 오픈소스 패키지: github.com/klakix-ai/klakix-mcp
- 서비스 소개(일본어): klakix.com/ja
라이선스는 Blender 애드온의 요구 사항에 맞춰 GPL-3.0-or-later입니다. 버그나 요청사항은 GitHub의 issue를 이용하거나, 에이전트에게 report_issue를 호출하여 전달해 주십시오. 애드온 사용 중 예상치 못한 오류가 발생할 경우, 오류 메시지와 스택 트레이스가 자동으로 보고됩니다.
토론 (Discussion)