Claude Code (터미널 기반 AI 코딩 도구)에서 WEPPY Roblox AI Toolkit의 WEPPY MCP Server를 사용하는 방법입니다.

사전 요구사항

Claude Code 설치됨
WEPPY Roblox Studio Plugin 설치 완료

설치

npm install -g @anthropic-ai/claude-code

MCP 서버 등록

방법 1: WEPPY AI Agent Plugin 설치 (권장)

일반 터미널에서 실행하세요. WEPPY AI Agent Plugin은 Claude Code에 MCP 서버 설정과 함께 Studio 액션 선택, UI Studio/playtest, Studio-local sync 작업용 WEPPY 스킬을 추가합니다.

# 마켓플레이스 추가
claude plugin marketplace add hope1026/weppy-roblox-mcp --scope user

# 플러그인 설치
claude plugin install weppy-roblox-ai-toolkit@hope1026-roblox-mcp --scope user

설치 확인:

claude plugin list

방법 2: 설정 파일 직접 편집

WEPPY AI Agent Plugin 없이 MCP 서버 설정만 추가하려면 .mcp.json 파일을 생성하세요:

{
  "mcpServers": {
    "weppy-roblox-mcp": {
      "command": "npx",
      "args": ["-y", "@weppy/roblox-mcp@latest"]
    }
  }
}

설정 파일 위치:

범위	경로
프로젝트	`<프로젝트>/.mcp.json`
글로벌	`~/.claude/mcp.json`

자동 서버 관리

Claude Code는 MCP 서버를 자동으로 관리합니다:

필요할 때 자동 시작
세션 종료 시 자동 정지
별도 설정 불필요

연결 테스트

Roblox Studio 실행 → Plugins 탭 → WEPPY → Connect

Claude Code에서 테스트:

Roblox Studio에 파란 파트 만들어줘

문제 해결

플러그인 설치 실패

claude plugin marketplace add hope1026/weppy-roblox-mcp --scope user
claude plugin install weppy-roblox-ai-toolkit@hope1026-roblox-mcp --scope user

서버가 시작되지 않음

Node.js 버전 확인 (18.0 이상 필요):
```
node --version
```
수동으로 서버 시작 테스트:
```
npx -y @weppy/roblox-mcp@latest
```

MCP 도구가 보이지 않음

Claude Code에서 확인:

사용 가능한 MCP 도구 목록 보여줘

Claude Code 설정