OpenAI Codex CLI (터미널 기반 AI 코딩 도구)에서 WEPPY Roblox AI Toolkit과 Roblox MCP를 사용하는 방법입니다.

Codex 플러그인은 스킬, 앱 통합, MCP 서버 설정을 함께 묶을 수 있습니다. WEPPY는 Codex 플러그인으로 MCP 서버 설정과 Roblox Studio 작업용 스킬을 함께 제공하므로, 수동 MCP 설정보다 플러그인 설치를 먼저 권장합니다.

사전 요구사항

Node.js (v18.0.0 이상)
Codex CLI 설치됨
Roblox Studio 플러그인 설치 완료

Codex CLI 설치

npm install -g @openai/codex

이미 설치되어 있다면 최신 버전으로 업데이트하세요:

codex update

방법 1: WEPPY Roblox AI Toolkit 설치 (권장)

터미널에서 WEPPY 플러그인 마켓플레이스를 추가하세요:

codex plugin marketplace add hope1026/weppy-roblox-mcp

그 다음 Codex CLI를 다시 열고 플러그인 목록을 엽니다:

codex
/plugins

추가된 WEPPY 마켓플레이스에서 WEPPY Roblox AI Toolkit을 선택한 뒤 Install plugin을 실행하세요.

설치가 끝나면 새 대화를 시작하세요. 플러그인이 npx -y @weppy/roblox-mcp@latest MCP 서버 설정과 WEPPY 스킬을 함께 추가합니다. 필요한 경우 프롬프트에서 @로 플러그인/번들 스킬을 직접 지정하거나, /skills 또는 $로 설치된 스킬을 확인하고 호출할 수 있습니다.

방법 2: MCP 서버만 수동 등록

WEPPY 스킬 없이 MCP 서버만 직접 등록하려면 아래 방법을 사용하세요. 방법 1로 플러그인을 설치했다면 이 단계는 건너뛰어도 됩니다.

CLI 명령어

codex mcp add weppy-roblox-mcp -- npx -y @weppy/roblox-mcp@latest

설정 파일 직접 편집

~/.codex/config.toml 파일에 아래 내용을 추가하세요:

[mcp_servers.weppy-roblox-mcp]
command = "npx"
args = ["-y", "@weppy/roblox-mcp@latest"]

설정 파일 위치:

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@latest

WEPPY 플러그인이 목록에 보이지 않을 때

마켓플레이스를 새로고침한 뒤 Codex를 다시 시작하세요:

codex plugin marketplace upgrade hope1026-roblox-mcp

연결 실패

Roblox Studio 플러그인이 Connected 상태인지 확인
포트 3002가 방화벽에 의해 차단되지 않았는지 확인

Codex CLI 설정