@weppy/roblox-mcp 2.5.0 → 2.6.0

package/docs/ko/dashboard/overview.md

@@ -1,95 +0,0 @@
-# 대시보드
-
-> MCP 서버의 상태, 연결, 동기화, 도구 실행 기록, 게임 변경 이력을 웹 브라우저에서 실시간으로 확인하고 관리합니다.
-
-![대시보드 Overview — 서버 상태, 최근 변경 사항, 세션 요약을 한눈에 확인](../../assets/screenshots/dashboard/dashboard_overview.png)
-
-## 대시보드란?
-
-대시보드는 MCP 서버가 제공하는 웹 기반 모니터링 인터페이스입니다. MCP 서버가 실행되면 자동으로 브라우저에서 열리며, AI 에이전트가 Roblox Studio에서 수행하는 모든 작업을 실시간으로 추적할 수 있습니다.
-
-- 터미널 로그를 뒤질 필요 없이 시각적으로 상태를 파악
-- AI가 Studio에서 무엇을 변경했는지 변경 이력으로 추적
-- 동기화 상태, 연결 상태, 도구 실행 통계를 한 곳에서 확인
-
-## 페이지 구성
-
-| 페이지 | 설명 | 상세 가이드 |
-|--------|------|------------|
-| [Overview](#overview) | 서버/플러그인/에이전트/Sync 상태 카드, 최근 변경 피드 | 이 문서 |
-| [Changelog](changelog.md) | 게임 변경 이력 — 세션별 카드, 변경 요약, 타임라인, Before & After | [상세 가이드](changelog.md) |
-| [Connection](connection.md) | 서버 상태, AI 에이전트 목록, 플러그인 연결 정보 | [상세 가이드](connection.md) |
-| [Sync](sync.md) | 동기화 상태, 방향 설정, 로그 | [상세 가이드](sync.md) |
-| [Playtest](playtest.md) | 플레이테스트 상태, 테스트 기록 | [상세 가이드](playtest.md) |
-| [Tools](tools.md) | 도구 실행 기록, 통계, 티어 분포 | [상세 가이드](tools.md) |
-| [Settings](settings.md) | 라이선스, 로그 레벨, 언어 | [상세 가이드](settings.md) |
-
-## 접속 방법
-
-MCP 서버가 실행되면 대시보드가 자동으로 브라우저에서 열립니다. 수동으로 접속하려면:
-
-```
-http://localhost:3002
-```
-
-> `DASHBOARD_AUTO_OPEN=false`로 설정하면 자동 열림을 비활성화할 수 있습니다 ([Settings](settings.md) 페이지에서 확인).
-
-## 연결 상태
-
-대시보드는 연결 상태에 따라 사용 가능한 기능이 달라집니다:
-
-| 상태 | 조건 | 사용 가능한 페이지 |
-|------|------|-------------------|
-| **서버 연결 끊김** | 서버 미연결 | 재연결 대기 화면만 표시 |
-| **서버 연결됨** | 서버 연결, 플러그인 미연결 | Connection, Tools, Settings |
-| **Studio 연결됨** | 서버 + 플러그인 모두 연결 | 모든 페이지 |
-
-대시보드가 **서버 연결됨** 상태일 때는 Overview, Changelog, Sync, Playtest 페이지에 접근할 수 없습니다.
-
-## Overview
-
-Overview 페이지는 대시보드의 첫 화면으로, 시스템 전체 상태를 한눈에 보여줍니다.
-
-### 상태 카드
-
-| 카드 | 표시 정보 |
-|------|----------|
-| **Server** | 서버 연결 상태 (Online/Offline) |
-| **Plugin** | 플러그인 연결 상태, Place 정보 |
-| **Agent** | 현재 연결된 AI 에이전트 이름 |
-| **Sync** | 동기화 상태 (Idle/Syncing/Error) |
-
-### 최근 게임 변경 (Recent Game Changes)
-
-AI가 Studio에서 수행한 최근 변경 사항을 실시간으로 표시합니다 (최대 20개). 각 항목은 변경 카테고리 아이콘과 함께 표시되며, 클릭하면 [Changelog](changelog.md)의 상세 뷰로 이동합니다.
-
-카테고리 아이콘:
-- Script — 스크립트 생성/수정
-- Instance — 인스턴스 생성/삭제/이동
-- Property — 속성 변경
-- Lighting — 조명/환경 설정
-- Terrain — 지형 변경
-- Asset — 에셋 삽입
-
-### 세션 변경 요약 (Session Change Summary)
-
-현재 세션의 변경 통계를 카테고리별로 집계하여 보여줍니다 (예: "4 scripts · 3 properties").
-
-## 실시간 업데이트
-
-대시보드는 SSE(Server-Sent Events)를 사용하여 실시간으로 데이터를 업데이트합니다:
-
-- 서버 상태: 5초 간격 폴링
-- 변경 피드, 연결 이벤트: SSE 실시간 스트리밍
-- SSE 연결 끊김 시: 3초 후 자동 재연결
-
-## 관련 문서
-
-- [Changelog](changelog.md) — 게임 변경 이력 추적
-- [Connection](connection.md) — 서버/에이전트/플러그인 연결 상태
-- [Sync](sync.md) — 동기화 상태 모니터링
-- [Playtest](playtest.md) — 플레이테스트 기록
-- [Tools](tools.md) — 도구 실행 기록/통계
-- [Settings](settings.md) — 라이선스, 서버 설정, 언어
-- [Tool 전체 목록](../tools/overview.md)
-- [Sync 기능 상세 가이드](../sync/overview.md)

package/docs/ko/dashboard/playtest.md

@@ -1,61 +0,0 @@
-# Playtest
-
-> AI가 실행한 플레이테스트의 상태와 테스트 결과를 확인합니다.
-
-![Playtest — 플레이테스트 상태와 테스트 기록](../../assets/screenshots/dashboard/dashboard_playtest.png)
-
-## 개요
-
-Playtest 페이지는 AI가 실행한 플레이테스트의 상태와 테스트 결과를 보여줍니다. 대시보드가 **Studio 연결됨** 상태일 때만 접근할 수 있습니다.
-
-## Playtest Status
-
-현재 플레이테스트 상태를 표시합니다:
-
-| 상태 | 의미 |
-|------|------|
-| **NotRunning** | 플레이테스트 미실행 |
-| **Running** | 플레이테스트 실행 중 |
-| **Paused** | 플레이테스트 일시정지 (Run 모드) |
-
-## Test History
-
-AI가 `run_test` 액션으로 실행한 테스트 결과를 시간순으로 나열합니다:
-
-| 항목 | 설명 |
-|------|------|
-| 타임스탬프 | 테스트 실행 시간 |
-| Test Report | 테스트 리포트 링크 |
-| Mode | 실행 모드 (play/run) |
-| Duration | 테스트 소요 시간 |
-| Status | 결과 (Passed/Failed) |
-
-테스트 리포트를 클릭하면 마크다운 형식의 상세 리포트와 로그를 확인할 수 있습니다.
-
-## 활용 사례
-
-### 테스트 실패 분석
-
-```
-"방금 실행한 자동 테스트가 실패한 원인을 찾고 싶다"
-```
-
-Test History에서 Failed 상태의 테스트를 찾아 Test Report를 클릭하면, 상세 로그와 실패 원인을 확인할 수 있습니다.
-
-### 테스트 이력 확인
-
-```
-"오늘 실행한 테스트들의 성공/실패 현황을 보고 싶다"
-```
-
-Test History에서 타임스탬프와 Status를 확인하여 테스트 결과 추이를 파악합니다.
-
-## 관련 문서
-
-- [대시보드 Overview](overview.md)
-- [Changelog](changelog.md)
-- [Connection](connection.md)
-- [Sync](sync.md)
-- [Tools](tools.md)
-- [Settings](settings.md)
-- [플레이테스트 & 자동 테스트 (도구)](../tools/playtest.md)

package/docs/ko/dashboard/settings.md

@@ -1,60 +0,0 @@
-# Settings
-
-> 라이선스 정보, 서버 설정, 언어를 확인하고 관리합니다.
-
-## 개요
-
-Settings 페이지에서는 라이선스 정보와 서버 설정을 확인하고 일부를 변경할 수 있습니다. 대시보드가 **서버 연결됨** 또는 **Studio 연결됨** 상태이면 항상 접근할 수 있습니다.
-
-## License (읽기 전용)
-
-현재 라이선스 상태를 표시합니다:
-
-| 항목 | 설명 |
-|------|------|
-| Status | 상태 배지 (Active/Inactive) |
-| Tier | 현재 티어 (Basic/Pro) |
-| License Key | 마스킹된 라이선스 키 |
-| Provider | 라이선스 제공자 정보 |
-
-## General
-
-| 설정 | 설명 |
-|------|------|
-| Log Level | 로그 출력 수준 |
-| History Recording | 도구 실행 기록 저장 여부 |
-| Stats Collection | 도구 통계 수집 여부 |
-| Request Timeout | 요청 타임아웃 (초) |
-
-## Server Environment (읽기 전용)
-
-환경 변수로 설정된 서버 설정을 표시합니다:
-
-| 환경 변수 | 설명 | 기본값 |
-|----------|------|--------|
-| `HTTP_PORT` | HTTP 포트 | 3002 |
-| `HTTP_HOST` | HTTP 호스트 | 127.0.0.1 |
-| `DASHBOARD_AUTO_OPEN` | 대시보드 자동 열림 | true |
-
-## Language
-
-대시보드 UI 언어를 변경합니다. 6개 언어 + Auto(브라우저 언어 자동 감지)를 지원합니다.
-
-| 옵션 | 언어 |
-|------|------|
-| Auto | 브라우저 언어 자동 감지 |
-| English | 영어 |
-| 한국어 | 한국어 |
-| 日本語 | 일본어 |
-| Español | 스페인어 |
-| Português | 포르투갈어 |
-| Bahasa Indonesia | 인도네시아어 |
-
-## 관련 문서
-
-- [대시보드 Overview](overview.md)
-- [Changelog](changelog.md)
-- [Connection](connection.md)
-- [Sync](sync.md)
-- [Playtest](playtest.md)
-- [Tools](tools.md)

package/docs/ko/dashboard/sync.md

@@ -1,68 +0,0 @@
-# Sync
-
-> Studio ↔ 로컬 파일 동기화의 현재 상태, 방향 설정, 로그를 모니터링합니다.
-
-![Sync — 동기화 상태, 방향 설정, 로그](../../assets/screenshots/dashboard/dashboard_sync.png)
-
-> Sync 기능 자체의 상세 가이드는 [Sync 기능 상세 가이드](../sync/overview.md)를 참고하세요.
-
-## 개요
-
-Sync 페이지는 Studio ↔ 로컬 파일 동기화의 현재 상태와 설정을 시각적으로 보여줍니다. 대시보드가 **Studio 연결됨** 상태일 때만 접근할 수 있습니다.
-
-## Sync Status
-
-현재 동기화 상태를 표시합니다:
-
-| 상태 | 의미 |
-|------|------|
-| **Idle** | 동기화 대기 중 |
-| **Initializing** | 초기 동기화 진행 중 |
-| **Syncing** | 증분 동기화 진행 중 |
-| **Error** | 동기화 오류 발생 |
-
-상태 카드에는 동기화 경로, 동기화된 인스턴스 수, 현재 적용 모드(Auto/Manual)가 함께 표시됩니다.
-
-## Sync Directions
-
-타입별 동기화 방향을 테이블로 보여줍니다:
-
-| 열 | 설명 |
-|----|------|
-| Type | 동기화 대상 타입 (Scripts, Values, Instances, Data, Services) |
-| Direction | 동기화 방향 (Local → Studio, Studio → Local) |
-| Apply Mode | 적용 모드 (Auto/Manual) |
-
-각 타입의 동기화 방향을 확인하여 어떤 변경이 어느 방향으로 반영되는지 파악할 수 있습니다.
-
-## Sync Log
-
-동기화 이벤트를 시간순으로 표시합니다. 각 로그 항목에는 변경 유형 태그(create, update, delete 등)와 대상 경로가 포함됩니다.
-
-## 활용 사례
-
-### 동기화 상태 확인
-
-```
-"Sync가 제대로 동작하는지 확인하고 싶다"
-```
-
-Sync Status가 Idle인지 확인하고, Sync Log에서 최근 변경이 정상적으로 기록되었는지 확인합니다.
-
-### 동기화 방향 파악
-
-```
-"스크립트 변경이 어느 방향으로 동기화되는지 알고 싶다"
-```
-
-Sync Directions 테이블에서 Scripts 타입의 Direction을 확인합니다.
-
-## 관련 문서
-
-- [대시보드 Overview](overview.md)
-- [Changelog](changelog.md)
-- [Connection](connection.md)
-- [Playtest](playtest.md)
-- [Tools](tools.md)
-- [Settings](settings.md)
-- [Sync 기능 상세 가이드](../sync/overview.md)

package/docs/ko/dashboard/tools.md

@@ -1,69 +0,0 @@
-# Tools
-
-> AI가 실행한 MCP 도구의 기록과 통계를 확인합니다.
-
-![Tools — 도구 실행 기록과 통계](../../assets/screenshots/dashboard/dashboard_tools.png)
-
-## 개요
-
-Tools 페이지는 AI가 실행한 MCP 도구의 기록과 통계를 제공합니다. **History**와 **Statistics** 두 개의 서브탭으로 구성됩니다. 대시보드가 **서버 연결됨** 또는 **Studio 연결됨** 상태이면 항상 접근할 수 있습니다.
-
-## History 탭
-
-도구 실행 기록을 시간순 테이블로 보여줍니다:
-
-| 열 | 설명 |
-|----|------|
-| Time | 실행 시간 |
-| Tool.Action | 실행된 도구와 액션 (예: `query_instances.get_instance`) |
-| Duration | 실행 소요 시간 |
-| Status | 결과 상태 (OK/Error) |
-| Tier | 사용된 티어 (Basic/Pro) |
-
-기능:
-- **Tool 필터** 드롭다운으로 특정 도구만 필터링
-- 페이지네이션으로 대량의 기록 탐색
-- 실시간으로 새 실행 기록 추가
-
-## Statistics 탭
-
-도구 사용 통계를 시각적으로 분석합니다:
-
-- **티어 분포** — Basic/Pro 도구 사용 비율
-- **도구별 통계** — 각 도구의 호출 횟수, 평균 응답 시간
-- **액션별 분석** — 도구 내 액션별 세부 통계
-
-## Basic 티어 전용 기능
-
-Basic 티어 사용자에게는 추가 UI가 표시됩니다:
-
-- **Tier Usage Progress** — 사용량 진행 바
-- **Basic vs Pro 비교 모달** — Pro 티어의 추가 기능을 안내
-
-## 활용 사례
-
-### 도구 성능 분석
-
-```
-"어떤 도구가 가장 오래 걸리는지 알고 싶다"
-```
-
-Statistics 탭에서 도구별 평균 응답 시간을 확인합니다.
-
-### 오류 추적
-
-```
-"방금 실행한 도구가 실패한 이유를 알고 싶다"
-```
-
-History 탭에서 Status가 Error인 항목을 찾아 상세 정보를 확인합니다.
-
-## 관련 문서
-
-- [대시보드 Overview](overview.md)
-- [Changelog](changelog.md)
-- [Connection](connection.md)
-- [Sync](sync.md)
-- [Playtest](playtest.md)
-- [Settings](settings.md)
-- [Tool 전체 목록](../tools/overview.md)

package/docs/ko/installation/README.md

@@ -1,95 +0,0 @@
-# 설치 가이드
-
-Roblox MCP를 사용하려면 **두 가지**를 설치해야 합니다.
-
-```
-AI 앱 (Claude, Codex, Gemini 등)
-       │
-   MCP 서버 ← 여기서 AI의 명령을 Roblox가 이해하는 형태로 변환
-       │
-Roblox Studio 플러그인 ← Studio 안에서 명령을 실행
-```
-
-AI 앱이 "파란 파트를 만들어줘"라고 하면, MCP 서버가 이 요청을 변환하고, Roblox Studio 플러그인이 실제로 파트를 만듭니다.
-
----
-
-## 원라인 설치 (권장)
-
-아래 명령어 한 줄로 MCP 서버와 플러그인을 한 번에 설치합니다:
-
-**macOS / Linux**
-
-```bash
-curl -fsSL https://raw.githubusercontent.com/hope1026/weppy-roblox-mcp/main/install.sh | bash
-```
-
-**Windows (PowerShell)**
-
-```powershell
-irm https://raw.githubusercontent.com/hope1026/weppy-roblox-mcp/main/install.ps1 | iex
-```
-
-AI 앱을 다시 열고 Roblox Studio를 재시작하세요.
-
-설치 중 오류가 발생하면 임시 로그 파일 경로를 출력하고, 대화형 실행에서는 종료 전에 콘솔을 유지해서 원인을 확인할 수 있습니다.
-
-자동 MCP 등록은 **Claude Code, Claude Desktop, Cursor, Codex CLI/App, Gemini CLI, Antigravity**를 지원합니다.
-
-Windows에서 PowerShell 실행이 차단되면 아래 수동 설치로 진행하세요. ZIP 패키지를 사용하는 경우 `setup-plugin.bat`, `setup-mcp.bat`를 실행할 수 있습니다.
-
----
-
-## 수동 설치
-
-원라인 설치가 동작하지 않거나 환경상 자동 설치를 사용할 수 없는 경우에 진행하는 대안 설치 방법입니다.
-
-### 1단계: Roblox Studio 플러그인 설치
-
-GitHub에서 플러그인 파일을 다운로드한 뒤, Roblox Studio의 Plugins 폴더에 넣으면 됩니다.
-
-👉 [플러그인 설치 가이드](https://weppyai.com/ko/install#plugin)
-
----
-
-### 2단계: AI 앱에 MCP 서버 등록
-
-사용하는 AI 앱에 MCP 서버를 등록합니다. MCP를 지원하는 모든 AI 앱에서 사용할 수 있어요.
-
-| AI 앱 | 설치 가이드 |
-|-------|-------------|
-| Claude Code | [설정 방법](ai-apps/claude-code.md) |
-| Claude Desktop | [설정 방법](ai-apps/claude-app.md) |
-| Cursor | [설정 방법](ai-apps/cursor.md) |
-| Codex CLI | [설정 방법](ai-apps/codex-cli.md) |
-| Codex Desktop | [설정 방법](ai-apps/codex-app.md) |
-| Gemini CLI | [설정 방법](ai-apps/gemini-cli.md) |
-| Antigravity | [설정 방법](ai-apps/antigravity.md) |
-
-> 위 목록에 없는 AI 앱이라도 MCP를 지원한다면 사용할 수 있습니다. MCP 서버 명령어는 `npx -y @weppy/roblox-mcp` 입니다.
-
----
-
-## 선택 사항: WEPPY Roblox Explorer (VSCode 확장) 설치
-
-동기화된 인스턴스 트리를 Roblox 클래스 아이콘과 함께 VSCode에서 탐색할 수 있습니다.
-이 확장은 위의 Roblox MCP 설치를 먼저 완료해야 사용할 수 있습니다. Explorer가 프로젝트 루트 아래의 `weppy-project-sync` Sync 데이터를 읽기 때문입니다.
-
-👉 [WEPPY Roblox Explorer 설치 가이드](https://weppyai.com/ko/install#explorer)
-
-바로 설치:
-- [VS Code Marketplace](https://marketplace.visualstudio.com/items?itemName=weppy.weppy-roblox-explorer)
-- [Open VSX](https://open-vsx.org/extension/weppy/weppy-roblox-explorer)
-
----
-
-## 설치 완료 후
-
-1. **Roblox Studio**를 열고, Plugins 탭에서 **WEPPY** → **Connect** 클릭
-2. **AI 앱**에서 다음과 같이 테스트해보세요:
-
-```
-Roblox Studio에 파란 파트 만들어줘
-```
-
-정상적으로 파트가 생성되면 설치가 완료된 것입니다!

package/docs/ko/installation/ai-apps/antigravity.md

@@ -1,88 +0,0 @@
-# Antigravity 설정
-
-[Google Antigravity](https://developers.googleblog.com/build-with-google-antigravity-our-new-agentic-development-platform/)에서 Roblox MCP를 사용하는 방법입니다.
-
-> **Antigravity**는 Google의 에이전트 기반 개발 플랫폼으로, AI 에이전트가 코드 편집, 터미널, 브라우저를 넘나들며 복잡한 작업을 자율적으로 수행합니다.
-
-## 사전 요구사항
-
-1. **Antigravity** 설치됨 (지원 OS/요구사항은 공식 문서 참고)
-2. **Node.js** (v18.0.0 이상, `npx` 사용 가능)
-3. **Roblox Studio 플러그인** 설치 완료
-
-## MCP 서버 등록
-
-Antigravity에서는 MCP 서버를 **에이전트 패널(Agent pane)**에서 관리합니다.
-
-### Raw config로 수동 등록 (권장)
-
-1. 에이전트 패널에서 **⋯** → **MCP Servers** → **Manage MCP Servers** → **View raw config** 클릭
-
-![MCP Servers 메뉴 열기](../../../assets/screenshots/antigravity/antigravity_mcp_services_menu.png)
-
-2. 표시되는 설정(JSON)에 아래 내용을 추가/병합:
-
-```json
-{
-  "mcpServers": {
-    "weppy-roblox-mcp": {
-      "command": "npx",
-      "args": ["-y", "@weppy/roblox-mcp"]
-    }
-  }
-}
-```
-![Raw config 수정](../../../assets/screenshots/antigravity/antigravity_mcp_raw.png)
-
-3. 저장 후 **Refresh**(또는 UI 안내에 따른 재시작/새로고침) 수행
-
-> 설정 파일의 실제 경로/이름은 OS와 Antigravity 버전에 따라 달라질 수 있으므로, 항상 **View raw config**에서 안내되는 위치를 기준으로 수정하세요.
-
-### 옵션: 환경 변수로 포트/로그 조정
-
-기본값(HTTP `127.0.0.1:3002`)을 유지하는 것을 권장합니다. 필요 시 아래처럼 환경 변수를 설정할 수 있습니다:
-
-```json
-{
-  "mcpServers": {
-    "weppy-roblox-mcp": {
-      "command": "npx",
-      "args": ["-y", "@weppy/roblox-mcp"],
-      "env": {
-        "HTTP_HOST": "127.0.0.1",
-        "HTTP_PORT": "3002",
-        "LOG_LEVEL": "INFO"
-      }
-    }
-  }
-}
-```
-
-## 연결 테스트
-
-1. **Roblox Studio** 실행 → Plugins 탭 → **WEPPY** → **Connect**
-2. **Antigravity**에서 다음을 입력:
-   ```
-   Roblox Studio에서 현재 선택된 것을 알려줘
-   ```
-
-## 문제 해결
-
-### 서버가 시작되지 않을 때
-
-MCP 서버를 직접 실행하여 오류를 확인하세요:
-```bash
-npx -y @weppy/roblox-mcp
-```
-
-### 연결 실패
-
-- Roblox Studio 플러그인이 **Connected** 상태인지 확인
-- 포트 **3002**가 방화벽에 의해 차단되지 않았는지 확인
-- 에이전트 패널 **⋯** → **MCP Servers**에서 서버 상태 확인
-- (고급) `HTTP_PORT`를 변경했다면, Roblox Studio 플러그인/브릿지 설정도 동일 포트를 사용하도록 맞춰야 합니다.
-
-## 참고 자료
-
-- [Google Antigravity 소개](https://developers.googleblog.com/build-with-google-antigravity-our-new-agentic-development-platform/)
-- [Antigravity 시작 가이드 (Codelab)](https://codelabs.developers.google.com/getting-started-google-antigravity)

package/docs/ko/installation/ai-apps/claude-app.md

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