接続、権限、Sync、検証の問題をステップバイステップで絞り込むガイドです。
プラグインが接続できないとき
症状: 「Connection failed」またはRoblox Studioでプラグインが接続不可として表示されます。
- MCPサーバーが起動しているか確認:
npx -y @weppy/roblox-mcp@latest - Roblox Studio: Pluginsタブ → WEPPY → Connect をクリック
localhost:3002をブロックするファイアウォール、ウイルス対策ソフト、VPNがないか確認- Roblox StudioとMCPサーバーをどちらも再起動
AIクライアントがMCPサーバーを認識しないとき
- AIクライアント設定で正しいコマンドが使われているか確認:
npx -y @weppy/roblox-mcp@latest - Node.js 18以上がインストールされているか確認:
node --version - Windowsで権限エラーが発生した場合はターミナルを管理者権限で実行してみてください
- 使用しているAIアプリのインストールガイドを確認してください
”Pro feature required” お知らせ
BasicでPro専用アクションをリクエストすると、可能な場合は回避策を探して処理します。ただし回避フローが追加トークンを消費し、常に同じ結果を保証するわけではありません。
また回避自体が不可能な一部のPro専用ツールはBasicでは実行できません。このお知らせが繰り返し表示される場合は、要求したアクションが現在のプランで利用できるか確認してください。
Syncが動作しないとき
- Sync状態を確認: AIに
manage_sync statusをリクエスト - Sync開始前にプラグインが接続されているか確認
- Reverse sync（ファイル → Studio）が動作しない場合はProティアが有効か確認
- ローカルSyncフォルダーが存在し、書き込み権限があるか確認
詳しいSync設定は双方向Syncを参照してください。
対応AIクライアント
| クライアント |
|---|
| Claude Code |
| Claude Desktop |
| Cursor |
| Codex CLI |
| Codex Desktop |
| Gemini CLI |
| MCP対応アプリ |
サーバーコマンド: npx -y @weppy/roblox-mcp@latest
システム要件
| 項目 | 最小値 |
|---|---|
| Node.js | 18.0.0以上 |
| Roblox Studio | 最新バージョン（自動更新を維持） |
| OS | Windows 10+ または macOS 12+ |
| ネットワーク | localhost:3002にアクセス可能であること |
よく発生するエラーメッセージ
| エラー | 原因 | 解決方法 |
|---|---|---|
ECONNREFUSED localhost:3002 | MCPサーバー未起動 | npx -y @weppy/roblox-mcp@latest を実行 |
Timeout waiting for plugin | Studioプラグイン未接続 | プラグインパネルでConnectをクリック |
Forbidden path | CoreGui/CorePackagesへのアクセス試行 | 有効なインスタンスパスのみ使用 |
Place ID mismatch | 誤ったプレイスに接続 | 正しいStudioセッションで再接続 |
サポートが必要な場合
それでも問題が解決しない場合はGitHub Issueを作成し、以下の情報を含めてください:
- OSおよびNode.jsバージョン
- AIクライアントおよびバージョン
- エラーメッセージまたはログ
- 既に試みたステップ
公開Issueには、生のライセンスキー、領収書、メールアドレス、請求情報、非公開プロジェクト情報を書かないでください。購入、ライセンス、メール、請求、非公開プロジェクト情報を含む問い合わせは[email protected]へ送ってください。