OpenAI Codex App (macOS)에서 WEPPY Roblox AI Toolkit과 Roblox MCP를 사용하는 방법입니다.

Codex App에서는 Plugins 메뉴에서 플러그인을 설치하고, 설치된 스킬은 Skills 메뉴 또는 프롬프트 호출로 확인할 수 있습니다. WEPPY 플러그인은 MCP 서버 설정과 Roblox Studio 작업용 스킬을 함께 제공하므로, 수동 MCP 설정보다 플러그인 설치를 먼저 권장합니다.

사전 요구사항

Codex App 설치됨 (macOS)
터미널에서 codex 명령어 사용 가능 (마켓플레이스 추가용)
Roblox Studio 플러그인 설치 완료

codex 명령어가 없다면 Codex CLI를 설치하세요:

npm install -g @openai/codex

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

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

codex plugin marketplace add hope1026/weppy-roblox-mcp

그 다음 Codex App을 다시 열고 Plugins 메뉴에서 추가된 WEPPY 마켓플레이스를 선택한 뒤 WEPPY Roblox AI Toolkit을 설치하세요. 앱에서는 플러스 버튼 또는 Add to Codex로 설치할 수 있습니다.

설치가 끝나면 새 대화를 시작하세요. 플러그인이 npx -y @weppy/roblox-mcp@latest MCP 서버 설정과 WEPPY 스킬을 함께 추가합니다.

Skills 메뉴에서 확인/사용

설치 후 Codex App의 Skills 메뉴에서 WEPPY 스킬을 확인할 수 있습니다.

WEPPY Roblox MCP Guide: Studio 직접 제어, UI Studio, playtest, 로그 확인
WEPPY Roblox Sync Guide: Studio-local sync, 방향 설정, 충돌 처리, Roblox Explorer 문맥

프롬프트에서 @로 플러그인/번들 스킬을 직접 지정하거나, $로 특정 스킬을 호출할 수 있습니다. 직접 지정하지 않아도 작업 내용이 스킬 설명과 맞으면 Codex가 자동으로 사용할 수 있습니다.

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

WEPPY 스킬 없이 MCP 서버만 직접 등록하려면 앱에서 Settings (Cmd + ,) → Integrations & MCP를 열고 커스텀 MCP 서버를 추가하세요. 방법 1로 플러그인을 설치했다면 이 단계는 건너뛰어도 됩니다.

Server name: weppy-roblox-mcp
Command: npx -y @weppy/roblox-mcp@latest

Codex App, Codex CLI, IDE 확장은 같은 ~/.codex/config.toml MCP 설정을 사용합니다.

연결 테스트

Roblox Studio 실행 → Plugins 탭 → WEPPY → Connect

Codex App에서 새 대화 시작 후 테스트:

Roblox Studio에서 현재 선택된 것을 알려줘

문제 해결

서버가 시작되지 않을 때

MCP 서버를 직접 실행하여 오류를 확인하세요:

npx -y @weppy/roblox-mcp@latest

WEPPY 플러그인이 Plugins 메뉴에 보이지 않을 때

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

codex plugin marketplace upgrade hope1026-roblox-mcp

연결 실패

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

Codex App 설정