WEPPY

Claude Desktop App 설정

Claude Desktop App에서 WEPPY Roblox AI Toolkit의 WEPPY MCP Server를 사용하는 방법.

Claude Desktop App에서 WEPPY Roblox AI Toolkit의 WEPPY MCP Server를 사용하는 방법입니다.

사전 요구사항

Claude Desktop App 설치됨
Node.js (v18.0.0 이상)
WEPPY Roblox Studio Plugin 설치 완료

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@latest"]
    }
  }
}

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

연결 실패

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