← 블로그로

Unity MCP 지원 AI: Cursor·Claude 등

Unity MCP와 연동되는 AI: Cursor, Claude Code, Codex, Windsurf, Gemini CLI가 하나의 unity-mcp 서버에 연결—Unity 공통 설정, 스모크 테스트, 심화 링크.Unity MCP는 어떤 AI 클라이언트를 지원하나요? AI마다 Unit…

게시일 · Updated
  • unity
  • unity-mcp
  • mcp
  • cursor
  • claude-code
  • codex
  • vberai

Unity MCP는 어떤 AI 클라이언트를 지원하나요? AI마다 Unity 플러그인이 따로 필요하다고 오해하기 쉽지만, Unity에는 로컬 MCP Server 하나(패널의 unity-mcp)만 돌아갑니다. Cursor, Claude Code, Codex, Windsurf, Cline, Gemini CLI 등 Model Context Protocol 클라이언트는 같은 브리지에 붙습니다. 달라지는 것은 클라이언트 MCP 설정이지 Unity 패키지 중복 설치가 아닙니다.

포트·라벨은 VberAI Unity MCP 빌드 기준으로 확인하세요. 다운로드: Unity MCP

Unity 측: 모든 클라이언트 공통 3단계

  1. Package Manager → Add package from disk (Unity MCP 설치)
  2. Mcp Panel 활성화; Unity MCP Server Running(기본 포트 6589 흔함)
  3. 패널 Quick setup 또는 endpoint / stdio를 클라이언트 MCP 목록에

Running이 아니면 모든 AI는 **디스크 .cs**만 보고 Hierarchy / Console / 선택은 못 봅니다.

공통 스모크 테스트

  1. 읽기 전용: 활성 씬 루트 GameObject 목록
  2. 작은 쓰기: 빈 MCP_SmokeTest 생성 후 삭제
  3. 큰 에이전트 편집 전 커밋; Play·컴파일 오류는 사람이 확인

클라이언트 비교

AI 클라이언트일반적 연결심화
Cursor패널 원클릭 → Cursor MCP unity-mcp(필요 시 Reload)Cursor + Unity MCP 워크플로
Claude CodeQuick setup → Copy CLI commandClaude Code + Unity MCP
CodexRunning 후 unity-mcp Codex MCP에(패널과 동일)아래 FAQ; active instances
Windsurf / Cline / ContinueMCP 항목 + Reload(Cursor 패턴)워크플로 가이드
Gemini CLIQuick setup → Gemini CLI → 명령 복사Claude 설치 CLI 흐름

Unity MCP 최적 AI? MCP는 특정 LLM에 묶이지 않음—레포에서 쓰는 클라이언트 우선. 안정 Running + 보이는 tools가 모델 교체보다 중요.

클라이언트별 최단 3단계(Running 후)

Cursor

  1. Quick setup → Cursor → 성공 토스트
  2. Cursor Settings → MCP unity-mcp + tools
  3. 읽기 전용 루트 노드 목록

Claude Code

  1. Quick setup → Copy CLI command
  2. Claude CLI 환경 실행
  3. 읽기 전용 루트 노드 목록

Codex

  1. 패널 URL 또는 stdio 복사
  2. Codex MCP 설정 붙여넣기
  3. Codex 재시작; tools 비면 → active instances

범위

포함기대하지 말 것
Hierarchy, 컴포넌트, 스크립트, Console(tools 기준)빌드, 넷코드, 성능 튜닝
한 Server에서 클라이언트 교체AI 브랜드마다 Unity 플러그인
Studio 임포트 후 UI 배선AI Studio 없이 Figma→Prefab

Godot 판단: Godot MCP 필요?

다음 단계

  1. 미설치 → Unity MCP 설치
  2. Running → Quick setup + 스모크 테스트
  3. 영상 → Unity MCP 플러그인 가이드

자주 묻는 질문

Unity MCP 지원 AI는?
로컬 unity-mcp에 연결되는 MCP 클라이언트—흔히 Cursor, Claude Code, Codex, Windsurf, Cline, Gemini CLI. 비교표.

Cursor·Claude에 Unity 플러그인 두 개?
아니요. Unity 서버 하나; 클라이언트마다 MCP 등록.

Codex에 Unity 도구가 안 보임?
Running, 설정 일치, 재시작; active instances.

C#을 전부 직접 써야 하나?
일상적인 게임플레이 스크립트는 보통 아님: AI가 Unity MCP로 C#을 생성·수정하고 GameObject에 붙이며 Inspector를 조정(플러그인 tools 범위). diff 검토, 컴파일, Play 확인에 집중. 아키텍처·네트워크·핫 패스는 여전히 사람의 판단이 필요—MCP가 코드를 못 써서가 아니라 책임 구분 때문.

이 글도 추천합니다

Unity MCP로 3D RPG 만들기: 3인칭 조작, 전투, 퀘스트

Unity MCP를 활용한 3D RPG 프로토타입 제작 가이드: 3인칭 이동, 실시간 근접 전투, 적 상태 머신, 퀘스트 연결. Cursor 등 MCP 지원 AI IDE에서 진행.데모 준비가 된 3D RPG 프로토타입은 보통 다음 요소들이 먼저 필요합니다: 조정 가능한 3인칭 이동 및…

  • Unity MCP
  • 3D RPG
  • Unity
  • combat
더 읽기

게임 UI 로케일 오버플로: 디자인 여유 공간과 VberAI Studio 번역 내보내기 QA

독일어·스페인어 문구가 버튼과 목록을 깨뜨릴 때의 합격/불합격 기준, 디자인에서 너비를 확보하는 방법, 전체 트리 재내보내기 전에 VberAI Studio 캔버스에서 로케일을 비교하는 방법을 다룹니다.출시 가능한 UI는 번역 품질이 아닌 다른 이유로 현지화에 실패하는 경우가 많습니다:…

  • game-ui-design
  • game-dev-ai
  • ui-localization
  • i18n
더 읽기