Claude Desktop App에서 Roblox MCP를 사용하는 방법입니다.
사전 요구사항
- Claude Desktop App 설치됨
- Node.js (v18.0.0 이상)
- Roblox Studio 플러그인 설치 완료
MCP 서버 등록
방법 1: Desktop Extensions (권장)
2026년부터 브라우저 확장처럼 원클릭 설치 가능
- Claude Desktop → Settings → Extensions
weppy-roblox-mcp검색- Install 클릭
방법 2: 설정 파일 직접 편집
-
Claude Desktop → Settings → Developers → Edit Config 클릭
-
claude_desktop_config.json파일에 아래 내용 추가:
{
"mcpServers": {
"weppy-roblox-mcp": {
"command": "npx",
"args": ["-y", "@weppy/roblox-mcp"]
}
}
}
- Claude Desktop 완전히 종료 후 재시작
설정 파일 위치:
| OS | 경로 |
|---|---|
| macOS | ~/Library/Application Support/Claude/claude_desktop_config.json |
| Windows | %APPDATA%\Claude\claude_desktop_config.json |
연결 테스트
- Roblox Studio 실행 → Plugins 탭 → WEPPY → Connect
- Claude Desktop에서 새 대화 시작 후 테스트:
Roblox Studio에 파란 파트 만들어줘
문제 해결
MCP 서버가 로드되지 않음
- JSON 문법 확인: 온라인 JSON validator로 설정 파일 검증
- Claude Desktop 완전 재시작: 설정 변경 후 반드시 앱 완전 종료 후 재시작
- 경로 확인: command와 args가 올바른지 확인
서버가 시작되지 않을 때
MCP 서버를 직접 실행하여 오류를 확인하세요:
npx -y @weppy/roblox-mcp
연결 실패
- Roblox Studio 플러그인이 Connected 상태인지 확인
- 포트 3002가 방화벽에 의해 차단되지 않았는지 확인