한 줄 요약

Codex가 Blender를 다루는 방법은 세 가지다. 보면서 고칠 땐 MCP, 많이·빨리·똑같이 반복할 땐 스크립트, 버튼으로만 되는 기능은 화면 조작. 어느 방법으로 하든 결과는 전부 파일로 남는다.

1. 세 가지 방법

                ┌─ ① MCP ─────────────────▶ 열려 있는 Blender 장면을 실시간으로 조작
나 ── Codex ────┼─ ② 백그라운드 스크립트 ──▶ .py 작성 → 화면 없이 Blender 실행 → .blend · .png · .glb
                └─ ③ 화면 조작 ────────────▶ 보이는 Blender 창을 직접 클릭·입력

2. ① MCP 깊게

연결 구조

Codex ──▶ uvx blender-mcp (MCP 서버, Codex가 켬) ──▶ 포트 9876 ──▶ Blender 안 애드온 ──▶ 장면

• 애드온이 켜져 있으면 Blender를 열 때 9876 포트 서버가 자동으로 켜진다. 사이드바(N) BlenderMCP 탭에 Running on port 9876.
• MCP 서버는 Codex 샌드박스 밖에서 돈다. 그래서 Codex를 읽기 전용(-s read-only)으로 켜도 장면을 읽을 수 있었다.

도구 28개를 여섯 묶음으로

실제 연결해서 받은 도구 목록 기준이다.

에셋·AI 생성은 기본으로 꺼져 있다. 처음 연결했을 때 get_polyhaven_status 가 "disabled"라고 답했다. BlenderMCP 탭에서 켠다.

blender-mcp 1.30.0 에서는 get_scene_info 가 user_prompt 값을 요구한다. Codex는 알아서 채우니까, 직접 MCP를 부를 때만 신경 쓰면 된다.

승인은 이렇게 동작한다

읽기 전용 도구만 안 묻게 하기 — ~/.codex/config.toml 에 추가:

[mcp_servers.blender.tools.get_scene_info]
approval_mode = "approve"

[mcp_servers.blender.tools.get_object_info]
approval_mode = "approve"

[mcp_servers.blender.tools.get_viewport_screenshot]
approval_mode = "approve"

한 번만 시험할 땐 설정 파일을 안 고치고 명령에 붙여도 된다 (이 방법으로 codex exec 가 장면 읽기에 성공함):

codex exec -c 'mcp_servers.blender.tools.get_scene_info.approval_mode="approve"' "블렌더 장면에 뭐가 있어?"

⚠️ execute_blender_code 는 자동 승인하지 않는다. 파이썬이라 파일 삭제, 인터넷 요청까지 할 수 있다. 매번 코드를 보고 허용한다.

MCP로 잘 시키는 대화 패턴

① 읽기 → 계획 → 실행 → 눈으로 확인

② 코드 먼저 보기 — execute_blender_code 승인 전에

③ 캡처로 스스로 검사

④ 잘 된 걸 스크립트로 저장 — ②로 넘어가는 다리

⑤ 긴 작업은 쪼개기 — 한 번에 1~2분 넘게 걸리는 요청은 중간에 끊긴다.

3. ② 백그라운드 스크립트 깊게

실제로 돌려본 것 (2026-09-14)

Codex(workspace-write 모드)에게 이렇게 시켰다:

실행 명령

Mac

/Applications/Blender.app/Contents/MacOS/Blender -b --factory-startup -P scripts/make_lamp.py

Windows (설치 위치에 따라 경로가 다름)

& "C:\Program Files\Blender Foundation\Blender 5.0\blender.exe" -b --factory-startup -P scripts\make_lamp.py

샌드박스 문제, 이렇게 푼다

Codex 기본 샌드박스는 파일 쓰기는 되지만 Blender를 켜면 GPU 초기화에서 꺼진다.

Codex가 만든 스크립트에서 배울 점

좋은 Blender 스크립트의 조건이 다 들어 있었다.

1. 경로를 스크립트 위치 기준으로 — 어디서 실행해도 같은 폴더에 저장
2. 시작할 때 장면 비우기 — 다시 돌려도 중복 안 생김
3. 치수를 미터로 계산하고 주석 — 0.03 + 0.29 + 0.13 = 0.45 m
4. 부품 이름 + 빈 오브젝트(Empty)로 묶기 — Lamp_45cm_Assembly 아래 Base_Disc, Stand_Pole, Cone_Shade
5. 재질을 함수로 — 색·금속감·거칠기를 숫자로
6. 카메라가 대상을 바라보게 계산 — 손으로 각도 안 맞춤
7. 저장 → 렌더 → 내보내기 순서, GLB엔 모델만 골라서 — 카메라·조명이 딸려 가지 않게
8. 마지막에 결과 경로 출력 — 제대로 됐는지 바로 확인

뼈대만 추리면:

from pathlib import Path
import bpy

PROJECT = Path(__file__).resolve().parent.parent
BLEND, RENDER, GLB = PROJECT / "blend/lamp.blend", PROJECT / "renders/lamp.png", PROJECT / "exports/lamp.glb"
for p in (BLEND, RENDER, GLB):
    p.parent.mkdir(parents=True, exist_ok=True)

bpy.ops.object.select_all(action="SELECT")
bpy.ops.object.delete()                                   # 1. 장면 비우기

# 2. 부품 (단위 m): 받침 0.03 + 기둥 0.29 + 갓 0.13 = 0.45
bpy.ops.mesh.primitive_cylinder_add(radius=0.11, depth=0.03, location=(0, 0, 0.015))
base = bpy.context.object; base.name = "Base_Disc"
# … 기둥, 갓, 재질, 카메라, 조명 …

scene = bpy.context.scene                                 # 3. 렌더 설정
scene.render.engine = "BLENDER_WORKBENCH"
scene.render.resolution_x = scene.render.resolution_y = 512
scene.render.filepath = str(RENDER)

bpy.ops.wm.save_as_mainfile(filepath=str(BLEND))          # 4. 저장 → 렌더 → 내보내기
bpy.ops.render.render(write_still=True)
bpy.ops.export_scene.gltf(filepath=str(GLB), export_format="GLB", use_selection=True)
print("Saved:", BLEND, RENDER, GLB)

스크립트라서 가능한 것

4. ③ 화면 조작

Codex에게 물어보면 스스로 제안하는 방법이다. 컴퓨터 사용 기능으로 화면에 보이는 Blender 창을 직접 클릭하고 입력한다.

이번에는 검증하지 않았다. 실제로 마우스를 움직이는 방식이라 멘토 화면에서 따로 시험해볼 것.

쓸 때 규칙

• Blender 창 하나만 띄우고 다른 앱은 닫기
• 진행 중에 마우스·키보드 건드리지 않기
• 시작 전에 저장

5. 섞어 쓰는 흐름 (추천)

① MCP로 형태 잡기 ─────── 보면서 대화로
      │  "잘 됐으면 처음부터 다시 만드는 스크립트로 저장해줘"
      ▼
② 스크립트로 변형·렌더·내보내기 ─── 실행은 내가 터미널에서
      │  renders/ 보고 고르기
      ▼
① MCP로 고른 것 열어서 세부 수정

결과물은 전부 파일로 남는다

lamp-project/
├── AGENTS.md     ← Codex한테 주는 이 프로젝트 규칙
├── scripts/      ← .py   레시피 — 이것만 있으면 언제든 다시 만든다
├── blend/        ← .blend 작업 파일
├── renders/      ← .png · .mp4
└── exports/      ← .glb · .stl

스크립트는 레시피, .blend는 완성된 요리, 렌더는 사진. 레시피를 남겨두면 사진이 날아가도 다시 만든다.

6. AGENTS.md — Codex한테 Blender 규칙을 한 번에 주기

Codex는 작업 폴더의 AGENTS.md 를 읽고 시작한다. 매번 "단위는 미터, 이름 붙여, 저장은 blend/에"를 말할 필요가 없어진다.

# Blender 작업 규칙

## 환경
- Blender: /Applications/Blender.app/Contents/MacOS/Blender (5.0)
- 열린 Blender 연결: MCP 서버 이름 blender (포트 9876)

## 작업 방식
- 보면서 고치는 작업은 MCP로, 여러 개·렌더·내보내기는 scripts/ 의 파이썬 스크립트로
- Blender 실행 명령은 내가 직접 실행한다. 스크립트를 만들면 실행 명령만 알려줘
- execute_blender_code 를 쓰기 전에 코드를 먼저 보여줘

## 3D 규칙
- 단위 미터, Z가 위, 바닥은 Z=0
- 오브젝트 이름은 영어로: 물건_부품 (Lamp_Base)
- 대칭은 Mirror, 반복은 Array, 모서리는 Bevel 0.5cm
- 기존 모델을 고칠 땐 원본을 숨기고 복사본(_edit)에서

## 저장
- 작업 파일 blend/, 렌더 renders/, 내보내기 exports/ — 경로는 스크립트 위치 기준
- 파일 이름 끝에 버전: _v01, _v02
- 테스트 렌더는 해상도 50%, Workbench 또는 EEVEE

7. Codex 권한 모드와 Blender

8. 막힐 때

9. 수업 주차별로 어디에 쓰나

출처

• blender-mcp (설치·도구·주의사항): https://github.com/ahujasid/blender-mcp
• Codex MCP 설정 (config.toml, codex mcp add): https://learn.chatgpt.com/docs/extend/mcp?surface=cli
• AGENTS.md 형식: https://agents.md
• Blender 명령줄 옵션: https://docs.blender.org/manual/en/latest/advanced/command_line/arguments.html
• 검증: 2026-09-14 멘토 맥 — MCP 도구 목록·장면 읽기, codex exec 승인 동작, 샌드박스 안/밖 스크립트 실행 비교