이 수업에서는 Blender를 직접 조작하지 않고 AI(GPT)한테 말로 시켜요. 그러려면 AI와 Blender를 이어주는 MCP라는 연결선을 먼저 깔아야 해요. 수업 중에 설치하면 60분이 그냥 끝나니까 꼭 미리 해오세요.

나 ──말──▶ GPT(Codex) ──MCP──▶ Blender
                ◀── 장면 정보, 화면 캡처 ──

막히면 멘토에게 어느 단계에서 어떤 화면이 떴는지 캡처해서 보내주세요. 수업 30분 전에 같이 봐요.

1. Blender 설치

• https://www.blender.org/download/ 에서 설치
• 한 번 켜서 기본 화면(회색 정육면체)이 뜨는지 확인

2. uv 설치

MCP 서버를 실행해주는 도구예요. pip install uv 말고 아래 공식 방법으로 설치하세요.

Mac — 터미널을 열고:

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

(Homebrew를 쓰고 있다면 brew install uv 도 됨)

Windows — PowerShell을 열고:

powershell -c "irm https://astral.sh/uv/install.ps1 | iex"

• 터미널을 껐다 켠 뒤 uv --version 입력 → 버전 숫자가 나오면 성공

3. Codex 준비 (GPT)

Codex는 ChatGPT 계정으로 쓰는 OpenAI의 작업용 AI예요. ChatGPT 웹사이트에서는 내 컴퓨터의 Blender에 연결할 수 없어서 Codex를 써요.

• ChatGPT 계정 로그인 확인
• 공식 안내에 따라 Codex 설치: https://developers.openai.com/codex
  • ChatGPT 데스크톱 앱이나 터미널용 Codex CLI 중 하나. 둘 다 같은 설정 파일을 써요.
  • 터미널용 예시(Node.js 필요): npm install -g @openai/codex

4. Codex에 Blender MCP 연결

터미널에 한 줄:

codex mcp add blender -- uvx blender-mcp

또는 설정 파일 ~/.codex/config.toml 에 직접 추가:

[mcp_servers.blender]
command = "uvx"
args = ["blender-mcp"]

앱에서 uvx를 못 찾는다고 나오면 전체 경로로 적어요. Mac: /opt/homebrew/bin/uvx 또는 ~/.local/bin/uvx · Windows: C:\Users\<내 이름>\.local\bin\uvx.exe

• 연결 추가 완료
• 터미널에 codex mcp list → 목록에 blender 가 enabled 로 보이면 성공

5. Blender 애드온 설치

터미널에:

uvx blender-mcp install-addon

Blender 사용자 애드온 폴더에 blender_mcp_addon.py 가 복사돼요. (Mac 예: ~/Library/Application Support/Blender/5.0/scripts/addons/)

그다음 Blender에서:

• Edit → Preferences → Add-ons 에서 Blender MCP 를 검색해서 켜기
• Blender를 껐다 켜기 — 애드온이 켜져 있으면 Blender를 열 때 연결 서버가 자동으로 시작돼요
• 3D 화면에 마우스를 올리고 N 키 → 오른쪽 사이드바 BlenderMCP 탭에 Running on port 9876 이 보이면 OK
• 안 보이면 같은 탭의 Connect to MCP server 버튼 누르기

명령어가 안 되면: https://github.com/ahujasid/blender-mcp 에서 addon.py 를 받아서 Edit → Preferences → Add-ons → Install from Disk 로 설치해요.

6. 연결 테스트

Blender를 켠 상태(사이드바에 Running on port 9876)에서 Codex에 입력:

• Codex가 Blender 도구(get_scene_info)를 써도 되는지 물어보면 허용
• "큐브, 조명, 카메라 3개" 비슷한 답이 오면 성공

하나 더:

• Blender 화면에서 큐브가 빨개지면 준비 끝

꼭 알아둘 것

• MCP는 한 AI 프로그램에만 연결해요. Codex랑 다른 AI 앱을 동시에 연결하면 꼬여요.
• AI가 Blender 안에서 코드를 직접 실행해요. 지시하기 전에 저장하는 습관(⌘S / Ctrl+S). 수업용 파일은 따로 만들어요.
• 사용 통계 전송이 기본으로 켜져 있어요. 끄고 싶으면 애드온 설정에서 해제할 수 있어요.
• Blender 조작은 딱 네 개만 알면 돼요.

  하고 싶은 것	방법
  화면 돌리기	오른쪽 위 축 표시(X·Y·Z 동그라미)를 드래그, 또는 마우스 가운데 버튼 드래그
  확대·축소	마우스 휠 / 트랙패드 두 손가락
  되돌리기	⌘Z / Ctrl+Z
  저장	⌘S / Ctrl+S

자주 막히는 곳