⚠ 명필은 여러분의 유니티 프로젝트를 실제로 변경합니다.
반드시 git 등으로 버전 관리가 되는 프로젝트에서 쓰시고, 작업 전에 커밋해 두세요.
1단계 — 유니티에 MCP를 설치합니다. 명필은 여러분 PC의 유니티를 조작하므로 이게 없으면 아무것도 못 합니다.
유니티 에디터에서 Window → Package Manager → 좌측 상단 + 버튼 →
Add package from git URL… 을 누르고 아래 주소를 붙여넣으세요.
https://github.com/CoplayDev/unity-mcp.git?path=/MCPForUnity#main
설치가 끝나면 설정 마법사가 자동으로 열립니다. Python과 uv 설치를 안내해 주니 그대로 따라가면 되고,
마지막에 감지된 AI 클라이언트 목록에서 쓰실 것(Claude 등)을 고르고 Configure Selected 를 누르면 됩니다.
필요 환경: 유니티 2021.3 LTS ~ 6.x · Python 3.10 이상
2단계 — 명필 심은 따로 설치하지 않습니다.
아래 등록 명령에 uvx 가 들어 있어, 실행할 때 자동으로 내려받아 돕니다.
1단계에서 유니티 MCP를 설치하면 uv 가 함께 깔리므로 준비는 이미 끝난 셈입니다.
심 패키지는 PyPI에서 받되, 현재 배포판 확인이
버전을 대조해 필요하면 명필 서버의 검증된 wheel로 자동 전환합니다. 아래 명령을 그대로 쓰세요.
💡 터미널 여는 법 — 윈도우: 시작 메뉴에 cmd 입력 · 맥: 스포트라이트(⌘Space)에 터미널 입력
3단계 — 위 탭에서 여러분이 쓰는 도구를 골라 이어서 진행하세요.
터미널에서 아래 한 줄을 실행하면 끝입니다.
키를 연결하면 표시됩니다.
💡 --env 바로 뒤에 서버 이름을 두면 CLI가 이름을 환경변수로 잘못 읽습니다.
위 명령은 그 순서를 지켜 만들어져 있으니 그대로 복사해 쓰세요.
확인: 새 세션을 열고 /mcp 를 입력하면 myeongpil 이 목록에 보입니다.
1) Claude 앱 좌측 하단의 내 이름(계정) 클릭 → 설정(Settings) 을 엽니다.
2) 왼쪽 목록에서 개발자(Developer) 를 고르고 설정 파일 편집(Edit Config) 을 누릅니다.
그러면 설정 파일이 있는 폴더가 열립니다.
버튼이 안 보이면 직접 파일을 여세요 —
Windows %APPDATA%\Claude\claude_desktop_config.json ·
macOS ~/Library/Application Support/Claude/claude_desktop_config.json
3) claude_desktop_config.json 을 메모장(또는 텍스트 편집기)으로 열고 아래를 붙여넣습니다.
파일에 이미 내용이 있으면 mcpServers 안쪽에 myeongpil 항목만 추가하세요.
키를 연결하면 표시됩니다.
4) 저장한 뒤 Claude를 완전히 종료했다가 다시 실행합니다.
창만 닫으면 반영되지 않습니다 — 윈도우는 작업표시줄 아이콘에서 종료, 맥은 ⌘Q 입니다.
확인: 대화창 하단의 도구/커넥터 아이콘에 myeongpil 이 보이면 성공입니다.
터미널에서 아래를 실행합니다.
키를 연결하면 표시됩니다.
또는 ~/.codex/config.toml 을 직접 편집해도 됩니다.
키를 연결하면 표시됩니다.
확인: Codex 세션에서 /mcp 를 입력하면 연결 상태와 도구 목록이 나옵니다.
ChatGPT 데스크톱 앱은 로컬 MCP(STDIO)를 지원합니다. 앱에서 이렇게 등록하세요.
1) ChatGPT 앱 설정 → 플러그인 → MCP 탭 → 맞춤형 MCP에 연결
2) 각 칸에 아래 값을 입력합니다.
| 칸 | 넣을 값 |
|---|
| 이름 | myeongpil |
| 유형 | STDIO 선택 |
| 실행 명령 | uvx |
| 인자 | 키를 연결하면 표시됩니다 |
| 환경 변수 | 키를 연결하면 표시됩니다 |
| 작업 중인 디렉토리 | 비워둠 |
3) 저장을 누르면 끝입니다. 대화에서 delegate_unity_task 도구가 보이면 성공입니다.
💡 유니티 MCP(사전 준비 1단계)도 같은 화면에 등록돼 있어야 명필이 유니티를 조작할 수 있습니다.
참고: ChatGPT 웹사이트의 커넥터(개발자 모드)는 원격 HTTPS만 받아 명필을 등록할 수 없습니다 —
반드시 데스크톱 앱을 쓰세요.