OpenAI Codex CLI (터미널 기반 AI 코딩 도구)에서 Roblox MCP를 사용하는 방법입니다.
사전 요구사항
- Node.js (v18.0.0 이상)
- Roblox Studio 플러그인 설치 완료
설치
npm install -g @openai/codex
MCP 서버 등록
방법 1: CLI 명령어 (권장)
codex mcp add weppy-roblox-mcp -- npx -y @weppy/roblox-mcp
방법 2: 설정 파일 직접 편집
~/.codex/config.toml 파일에 아래 내용을 추가하세요:
[mcp_servers.weppy-roblox-mcp]
command = "npx"
args = ["-y", "@weppy/roblox-mcp"]
설정 파일 위치:
| OS | 경로 |
|---|---|
| macOS/Linux | ~/.codex/config.toml |
| Windows | %USERPROFILE%\.codex\config.toml |
연결 테스트
- Roblox Studio 실행 → Plugins 탭 → WEPPY → Connect
- Codex CLI 실행 후 다음을 입력:
Roblox Studio에서 현재 선택된 것을 알려줘
문제 해결
서버가 시작되지 않을 때
MCP 서버를 직접 실행하여 오류를 확인하세요:
npx -y @weppy/roblox-mcp
연결 실패
- Roblox Studio 플러그인이 Connected 상태인지 확인
- 포트 3002가 방화벽에 의해 차단되지 않았는지 확인