接続、権限、Sync、検証の問題をステップバイステップで絞り込むガイドです。
プラグインが接続できないとき
症状: 「Connection failed」またはRoblox Studioでプラグインが接続不可として表示されます。
- MCPサーバーが起動しているか確認:
npx -y @weppy/roblox-mcp - Roblox Studio: Pluginsタブ → WEPPY → Connect をクリック
localhost:3002をブロックするファイアウォール、ウイルス対策ソフト、VPNがないか確認- Roblox StudioとMCPサーバーをどちらも再起動
AIクライアントがMCPサーバーを認識しないとき
- AIクライアント設定で正しいコマンドが使われているか確認:
npx -y @weppy/roblox-mcp - Node.js 18以上がインストールされているか確認:
node --version - Windowsで権限エラーが発生した場合はターミナルを管理者権限で実行してみてください
- 使用しているAIアプリのインストールガイドを確認してください
”Pro feature required” お知らせ
BasicでPro専用アクションをリクエストすると、可能な場合は回避策を探して処理します。ただし回避フローが追加トークンを消費し、常に同じ結果を保証するわけではありません。
また回避自体が不可能な一部のPro専用ツールはBasicでは実行できません。このお知らせが繰り返し表示される場合はProへの移行を検討してください。
Syncが動作しないとき
- Sync状態を確認: AIに
manage_sync statusをリクエスト - Sync開始前にプラグインが接続されているか確認
- Reverse sync（ファイル → Studio）が動作しない場合はProティアが有効か確認
- ローカルSyncフォルダーが存在し、書き込み権限があるか確認
詳しいSync設定は双方向Syncを参照してください。
対応AIクライアント
| クライアント | Basic | Pro |
|---|---|---|
| Claude Code | ✅ | ✅ |
| Claude Desktop | ✅ | ✅ |
| Cursor | ✅ | ✅ |
| Codex CLI | ✅ | ✅ |
| Codex Desktop | ✅ | ✅ |
| Gemini CLI | ✅ | ✅ |
| MCP対応アプリ | ✅ | ✅ |
サーバーコマンド: npx -y @weppy/roblox-mcp
システム要件
| 項目 | 最小値 |
|---|---|
| Node.js | 18.0.0以上 |
| Roblox Studio | 最新バージョン（自動更新を維持） |
| OS | Windows 10+ または macOS 12+ |
| ネットワーク | localhost:3002にアクセス可能であること |
Basic vs Pro 機能比較
Basic（無料）でもAIコーディング作業の主要フローのほとんどをそのまま使用できます。 インスタンス・プロパティ・スクリプト・選択・カメラ・ログを扱う主要ツールがすべて含まれ、Studio → Local 単方向SyncとツールExec履歴もそのまま使用できます。Proは双方向Sync、大量操作、そして地形・ライティング・物理・オーディオ・アニメーションなどの高度なツール群を追加します。
| 機能 | Basic | Pro |
|---|---|---|
| インスタンス検索・作成・削除・複製・移動 | ✅ | ✅ |
| インスタンスツリー・階層探索 | ✅ | ✅ |
| プロパティ・タグ読み書き | ✅ | ✅ |
| スクリプト読み込み・作成・変更 | ✅ | ✅ |
| 選択管理 | ✅ | ✅ |
| カメラ移動・フォーカス | ✅ | ✅ |
| ログ照会 | ✅ | ✅ |
| システム情報・接続確認 | ✅ | ✅ |
| ツール実行履歴・統計 | ✅ | ✅ |
| Studio → Local 単方向Sync | ✅ | ✅ |
| 双方向Sync（Local → Studio） | — | ✅ |
| タイプ別Direction / Apply Mode | — | ✅ |
| Sync変更履歴 | — | ✅ |
| マルチプレイス同期（最大3つ） | — | ✅ |
| 大量操作（一括作成・変更） | — | ✅ |
| ライティング・大気圏制御 | — | ✅ |
| 地形生成・編集 | — | ✅ |
| トウィーン・アニメーション制御 | — | ✅ |
| オーディオ制御 | — | ✅ |
| パーティクル・エフェクト | — | ✅ |
| 物理グループ・コリジョン | — | ✅ |
| 空間クエリ・レイキャスト | — | ✅ |
| アセット検索・挿入・エクスポート | — | ✅ |
| スクリーンショットキャプチャ | — | ✅ |
| Playtest自動実行・テスト注入 | — | ✅ |
| バッチ実行・任意Luauコード | — | ✅ |
BasicでPro専用機能をリクエストすると可能な範囲で回避処理しますが、トークン消費が増え一部機能は回避不可能です。詳しくは上の「Pro feature required」お知らせを参照してください。
よく発生するエラーメッセージ
| エラー | 原因 | 解決方法 |
|---|---|---|
ECONNREFUSED localhost:3002 | MCPサーバー未起動 | npx -y @weppy/roblox-mcp を実行 |
Timeout waiting for plugin | Studioプラグイン未接続 | プラグインパネルでConnectをクリック |
Forbidden path | CoreGui/CorePackagesへのアクセス試行 | 有効なインスタンスパスのみ使用 |
Place ID mismatch | 誤ったプレイスに接続 | 正しいStudioセッションで再接続 |
サポートが必要な場合
それでも問題が解決しない場合はGitHub Discussionsに以下の情報を含めてお問い合わせください:
- OSおよびNode.jsバージョン
- AIクライアントおよびバージョン
- エラーメッセージまたはログ
- 既に試みたステップ