Unity AI 입문 3: MCP로 바닥·상자를 만들고 장면을 저장하는 법
AI 요청을 실제 MCP 호출과 대조하고, Hierarchy·Transform·Console·저장 후 재열기로 결과를 확인해요.
마지막 업데이트
메뉴나 지원 기능이 달라졌다면 아래 자료 확인일과 현재 앱 버전을 함께 봐주세요.

대표 화면은 공식 저장소에 포함된 v8.6 예시예요. 현재 10.3.0의 직접 촬영 화면이 아니에요. MIT · Media credits
이번에는 AI에게 부탁한 배치가 Unity의 실제 장면과 저장 파일에 남는지 확인해볼게요. 결과물은 바닥 하나와 AI_Crate라는 상자 하나가 들어 있는 Assets/McpPractice.unity예요. 캐릭터 조종이나 유료 이미지 생성까지 섞지 않고 한 가지 장면 작업을 끝내는 과정이에요.
먼저 2단계 연결에서 활성 장면 조회가 성공해야 해요. 아래 절차는 10.3.0 공식 도구 정의에서 확인한 사용법과 예상 결과예요. 범블비는 서버 초기화만 시험했으며 Unity 안에서 이 장면을 실제 생성·저장하지 않았어요. 이 글의 장면 이름과 좌표는 직접 구성한 연습 입력이에요.

시연 보는 법: AI 요청과 Unity 장면의 변화를 전체 흐름으로 살펴보세요. 아래 연습은 별도 예시이므로 영상의 구성과 정확히 같을 필요는 없어요. 움직이는 이미지가 불편하거나 불러오지 못하면 원본 링크로 이동하거나 아래 텍스트 단계를 따라갈 수 있어요.
1. 현재 프로젝트와 장면부터 읽게 해요
Cursor의 대화에서 현재 Unity 장면 이름과 경로를 읽어달라고 요청해요. manage_scene의 get_active 호출과 반환값을 보고, 자신의 연습 프로젝트에 연결됐는지 대조해요. 다른 프로젝트 이름이라면 생성 요청을 보내기 전에 대상부터 고쳐요. 여러 에디터가 켜져 있으면 어느 인스턴스를 사용할지 명시해야 해요.
Unity의 편집 상태에서 기존 장면을 저장해두세요. 이 과정에서는 새 연습 장면으로 전환하므로 미저장 변경을 먼저 정리해야 해요. 프로젝트 폴더 위치와 기존 장면 경로를 남기면 이후에 원래 작업으로 돌아가기 쉬워요. 삭제나 대량 정리 요청은 필요하지 않아요.
2. 새 연습 장면과 두 대상을 요청해요
AI에게 현재 프로젝트 안에 McpPractice라는 새 3D 연습 장면을 만들도록 요청해요. 기존 장면을 덮어쓰지 않고 Assets/McpPractice.unity 경로를 쓰는 조건이에요. 같은 경로가 이미 있다면 다른 파일명으로 정하고 이후 메모에도 그 이름을 써요.
생성 후에는 GameObject를 다음 표에 맞춰 만들도록 요청해요. 두 대상은 부모 없는 장면 최상위에 두는 예시예요. Plane은 바닥으로 쓰는 기본 도형이고 Cube는 상자 모양이에요. 이름이 같은 대상이 이미 있다면 또 만들지 말고 먼저 현재 목록을 확인하게 해요.
| 대상 | 도형 | Position X, Y, Z | Scale X, Y, Z |
|---|---|---|---|
| Floor | Plane | 0, 0, 0 | 1, 1, 1 |
| AI_Crate | Cube | 0, 0.5, 0 | 1, 1, 1 |
AI가 완료했다고 말하면 도구 호출 기록도 확인해요. 새 장면은 manage_scene, 도형은 manage_gameobject로 처리할 수 있어요. 아래는 실제로 실행했다는 로그가 아니라 공식 도구 형식에 맞춘 인수 예시예요. Cursor의 MCP 연결 설정 파일에 이 JSON을 넣는 것이 아니에요.
전체 작업 요청과 도구 인수 예시 보기
현재 Unity 프로젝트와 장면을 먼저 읽고 알려줘.
연습 프로젝트가 맞으면 기존 장면을 덮어쓰지 말고 Assets/McpPractice.unity를 3D 기본 템플릿으로 만들어줘.
최상위 Floor Plane은 위치 (0,0,0), AI_Crate Cube는 (0,0.5,0), 둘 다 크기 (1,1,1)로 배치해줘.
같은 이름이 있으면 중복 생성하지 말고 먼저 알려줘.
장면 목록과 Transform을 읽어 확인하고 장면을 저장해줘.
끝에 사용한 도구, 변경 대상, 저장 경로와 남은 오류를 알려줘. 유료 생성 서비스와 코드 실행 도구는 쓰지 마.
manage_scene — 새 장면:
{"action":"create","path":"McpPractice.unity","template":"3d_basic"}
manage_gameobject — 바닥, 그다음 상자:
{"action":"create","name":"Floor","primitive_type":"Plane","position":[0,0,0],"scale":[1,1,1]}
{"action":"create","name":"AI_Crate","primitive_type":"Cube","position":[0,0.5,0],"scale":[1,1,1]}
manage_scene — 상태 확인, 그다음 저장:
{"action":"get_hierarchy","include_transform":true,"page_size":100}
{"action":"save"}
여기서 장면 도구의 짧은 경로는 Assets 기준이에요. 실제 저장 위치는 반환값과 Project 창에서 다시 확인해요.
3. Hierarchy와 Inspector에서 직접 대조해요
화면에서 확인: 일반적인 Unity 배치에서 Hierarchy는 장면 오브젝트 목록, Scene은 편집 화면, Inspector는 선택한 항목의 속성이에요. 패널 위치는 사용자의 레이아웃에 따라 다를 수 있어요. Hierarchy에서 AI_Crate를 클릭한 뒤 Inspector의 Position과 Scale의 X·Y·Z 칸을 표와 하나씩 비교하세요.
Unity의 Hierarchy에서 Floor와 AI_Crate를 찾고, 상자를 선택해 Inspector → Transform 값이 표와 같은지 봐요. Scene 창에서는 두 대상의 배치를 확인해요. 기본 크기 상자의 중심 높이를 0.5로 잡은 것은 밑면을 높이 0의 바닥에 맞추려는 예시예요.
이 작업은 Rigidbody나 이동 스크립트를 넣지 않아요. 상자가 가만히 있는 것이 예상 결과예요. Game 창의 카메라 구도가 맞지 않아 보이지 않는다면 Scene의 존재 확인과 카메라 확인을 구분하세요. “오브젝트가 없다”는 이유로 중복 생성하기 전에 Hierarchy부터 살펴봐요. 수동 조작이 낯설면 엔진 첫 장면 설명을 참고해요.
4. 저장 성공과 화면 표시를 따로 확인해요
저장 체크: Project 창에서 Assets 폴더와 .unity 장면 파일을 찾고, 저장 응답의 경로와 비교해요. 다시 열 때는 저장된 파일을 더블 클릭한 후 Hierarchy와 Inspector 값을 다시 확인하세요. 시연 영상만으로 이 과정이 성공했다고 판단하지 않아요.
AI가 manage_scene의 save를 호출했는지, 응답이 성공인지, 반환 경로가 연습 장면인지 확인해요. Unity Project 창에서도 McpPractice.unity를 찾아요. 오브젝트가 보이는 것만으로 파일 저장까지 완료된 것은 아니에요. Play 상태라면 종료한 뒤 최종 값을 확인하고 저장해요.
에디터를 닫았다가 Hub에서 같은 프로젝트를 열고, Project의 저장 장면을 두 번 클릭해요. Floor·AI_Crate 이름과 Transform이 남아 있으면 이번 저장·재열기 조건을 통과한 거예요. 아직 재열기를 하지 않았다면 메모에 그 항목을 미확인으로 남겨요. .unity 파일 하나는 장면 재료이며 독립 실행 게임이 아니에요.
5. Console을 읽고 완료 기록을 남겨요
AI에게 read_console의 get 동작으로 최근 오류를 읽도록 요청할 수 있어요. Console을 지우는 clear는 진단 기록을 없애므로 첫 단계로 요청하지 않아요. 오류가 없다면 조회 범위 안에서 오류가 없었다고 적고, 게임 전체의 무결성을 보장한다고 넓히지 않아요.
작업 메모에는 장면 경로, 생성 대상 두 개, Transform 대조, save 응답, 재열기 결과, 남은 오류를 적어요. 응답에 success:false가 있거나 대상 프로젝트가 다르면 멈춘 단계를 그대로 남기세요. 다음 단계에서는 연결·도구 가시성·Console 오류를 나눠 같은 작업을 다시 확인하는 방법을 살펴봐요.
다음 단계: 4. 오류 읽고 다시 확인하기.
참고 자료
- https://github.com/CoplayDev/unity-mcp/blob/aa5fc638d623f56178d50329d9ad8c541a57fe66/MCPForUnity/package.json
- https://github.com/CoplayDev/unity-mcp/blob/aa5fc638d623f56178d50329d9ad8c541a57fe66/website/docs/getting-started/install.md
- https://github.com/CoplayDev/unity-mcp/blob/aa5fc638d623f56178d50329d9ad8c541a57fe66/website/docs/getting-started/clients.md
- https://github.com/CoplayDev/unity-mcp/blob/aa5fc638d623f56178d50329d9ad8c541a57fe66/website/docs/getting-started/first-prompt.md
- https://github.com/CoplayDev/unity-mcp/blob/aa5fc638d623f56178d50329d9ad8c541a57fe66/website/docs/reference/tools/core/manage_scene.md
- https://github.com/CoplayDev/unity-mcp/blob/aa5fc638d623f56178d50329d9ad8c541a57fe66/website/docs/reference/tools/core/manage_gameobject.md
- https://github.com/CoplayDev/unity-mcp/blob/aa5fc638d623f56178d50329d9ad8c541a57fe66/website/docs/reference/tools/core/read_console.md
- https://github.com/CoplayDev/unity-mcp/blob/aa5fc638d623f56178d50329d9ad8c541a57fe66/website/docs/guides/troubleshooting.md
- https://github.com/CoplayDev/unity-mcp/releases/tag/v10.3.0
- https://cursor.com/docs/mcp
- https://github.com/CoplayDev/unity-mcp/blob/aa5fc638d623f56178d50329d9ad8c541a57fe66/LICENSE