roblox-mcp

roblox-mcp

公式ソース：

• https://create.roblox.com/docs/en-us/studio/mcp
• https://create.roblox.com/docs/en-us/ai/build
• https://create.roblox.com/docs/en-us/scripting/sync
• https://modelcontextprotocol.io/docs/getting-started/intro

公式の Roblox Studio MCP サーバーを使うと、接続した AI クライアントから開いているプレイスを調査、編集できます。スクリプト、インスタンス、Luau の実行、アセット、プレイテスト用のツールを提供します。

Studio MCP サーバーについて

Roblox Studio は、stdio トランスポートを使用する Model Context Protocol（MCP） サーバーを実装しています。このサーバーはマシン上のローカルプロセスとして実行され、対応する AI クライアントからのリクエストを、アクティブな Studio セッションに中継します。エディターのエージェントと Studio をつなぐ役割を担います。Script Sync がディスクと Studio 間のファイル同期を処理し、MCP はそれ以外のすべて（Explorer の選択、インスタンスの調査、スクリプトの編集、Luau の実行、プレイモード、入力のシミュレーション、アセットの挿入）を処理します。

前提条件

1. 最新の Roblox Studio。ランチャーからアップデートするか、Creator Hubからダウンロードしてください。
2. MCP 対応の AI クライアント。Cursor、Claude Code を使用する VS Code、Claude Desktop、Codex CLI、Gemini CLI、Antigravity、または stdio トランスポートに対応する任意のクライアント。
3. Studio にサインイン済みの Roblox アカウント。
4. ファイルベースのワークフローでは Git（推奨）。

Studio でサーバーを有効にする

1. Studio を開き、エージェントに作業させるプレイスを読み込みます。
2. Assistant（右上のボタン）を開きます。
3. ⋯ → Manage MCP Serversをクリックします。
4. Enable Studio as MCP serverをオンにします。
5. パネルにクイック接続のオプションと手動設定のコードが表示されます。クライアントが接続すると、緑色のインジケーターが表示されます。

MCP のオプションが表示されない場合は、Studio を最新バージョンにアップデートしてから再起動してください。

クライアントを接続する

クライアントに合った方法を選んでください。

クイック接続は、Antigravity、Codex CLI、Claude Code、Claude Desktop、Cursor、Gemini CLI、Visual Studio Code に対応しています。

1. Studio で、Assistant → ⋯ → Manage MCP Servers → Quick connectを選択します。
2. インストール済みのクライアントをオンにします。
3. ツールがすぐに表示されない場合は、クライアントを再起動します。

mcp.jsonなどの設定ファイルを読み込むクライアントについては、OS ごとのコピー＆ペースト可能な設定をreferences/setup-and-connection.mdで確認してください。

CLI コマンドを直接指定する必要があるクライアントについては、Windows および macOS 用のコマンドをreferences/setup-and-connection.mdで確認してください。

接続後、次のように確認します。

Roblox MCP を使って、Roblox Studio の現在のゲームツリーを読み取ってください。Workspace にあるものを一覧表示してください。

MCP ツールでできること

サーバーは複数のカテゴリのツールを公開しています。現在のツール名と使用方法については、references/tool-reference.mdを参照してください。

カテゴリ	例
スクリプト	script_read、multi_edit、script_search、script_grep
データモデル	search_game_tree、inspect_instance、subagent（explore）
Luau の実行	execute_luau
アセットの生成と挿入	generate_mesh、generate_material、generate_procedural_model、wait_job_finished、search_asset、insert_asset、upload_image、store_image
プレイテスト	start_stop_play、get_studio_state、get_console_output、screen_capture、subagent（playtest）
入力のシミュレーション	character_navigation、user_keyboard_input、user_mouse_input
ドキュメント	http_get、skill
インスタンスの検出	list_roblox_studios。以降の呼び出しではstudio_idを渡します

MCP と Script Sync の併用

Script Sync は、ディスク上のフォルダー（ServerScriptService/、ReplicatedStorage/、StarterPlayerScripts/ など）を Studio のサービスに対応付けるため、ローカルで編集した .luau ファイルが Studio に自動的に反映されます。Script Sync では扱えないすべての操作は MCP が担います。たとえば、StarterGui の編集、モデルの挿入、コマンドの実行、プレイテスト、インスタンスの調査などです。

エージェントの一般的な作業ループ：

1. 再利用可能なモジュールやスクリプトは、Script Sync を使ってディスク上のファイルを編集します。
2. MCP を使ってインスタンスを調査し、Luau スニペットを実行して、プレイモードを開始し、出力やスクリーンショットを取得します。
3. Script Sync の対象外のコンテナーにあるスクリプト（例：StarterGui）は、MCP を使って編集します。

詳しい設定方法とスタータープロジェクトの構成については、references/script-sync-integration.md を参照してください。

複数インスタンスの処理

list_roblox_studios を呼び出すと、接続されているウィンドウ、その Studio インスタンス ID、プレース ID を確認できます。プレース ID のないローカルプレースは、名前で一覧表示されます。選択したインスタンスの studio_id を以降のツール呼び出しすべてに渡してください。共有のアクティブウィンドウに頼ったり、オブジェクトパスから対象を推測したりしないでください。ウィンドウが閉じたときや対象が変わったときは、インスタンスを再度一覧表示してください。

セキュリティと信頼

MCP クライアントは、開いているプレースを読み取り、変更できます。MCP 接続は、特権を持つほかの連携機能と同様に扱ってください。

• 信頼できるクライアントのみ接続してください。
• テスト用のプレースまたはバージョン管理されたプロジェクトで作業してください。
• 公開する前に、エージェントによる編集内容を確認してください。
• .rbxlx などのプレースファイルは Git の対象外にしてください（スターターの .gitignore を使用してください）。
• MCP サーバーを使用しないときは、接続を切るか無効にしてください。
• execute_luau は特権コードとして扱ってください。プレースの公開、DataStore への書き込み、HTTP リクエストの送信、Studio に読み込まれた認証情報へのアクセスが可能です。

セキュリティチェックリストとトラブルシューティングの詳しい手順については、references/security-and-troubleshooting.md を参照してください。

確認チェックリスト

• Studio が更新され、MCP が有効になっている。
• 再起動後に、AI クライアントに Roblox MCP ツールが表示される。
• script_read または search_game_tree で、現在のプレース構造が返される。
• Script Sync で、想定したサービスフォルダーがディスクに対応付けられている（ファイルベースのワークフローを使用する場合）。
• execute_luau で簡単な print を実行し、出力を取得できる。
• start_stop_play で、プレイモードへの移行と終了が正常に行われる。

スクリプト

• scripts/MCPReadyChecker.lua：execute_luau で実行し、Script Sync の状態とモデルの基本的な健全性を確認できる診断用スニペットです。
• scripts/StudioModelProbe.lua：ゲームツリーを要約する再利用可能なユーティリティです。エージェントの探索プロンプトを作成する際のパターンとして役立ちます。

次の手順

1. 前提条件を確認し、Studio で MCP を有効にします。
2. クイック接続、または references/setup-and-connection.md の手動設定を使ってクライアントを接続します。
3. 簡単なツリー読み取りまたは execute_luau の呼び出しで、接続を確認します。
4. ファイルベースのワークフローを使用する場合は、references/script-sync-integration.md に従って Script Sync を設定します。
5. ツールリファレンスを使ってエージェント向けのプロンプトを正確に作成し、セキュリティガイドに従ってワークフローの安全性を保ちます。

リファレンス一覧

• script-sync-integration.md：ディスク上のファイルと Studio での MCP 編集およびプレイテストを組み合わせます。
• security-and-troubleshooting.md：MCP 接続の失敗を調査したり、Studio へのアクセスを確認したりします。
• setup-and-connection.md：Studio MCP を有効にして、Windows または macOS でクライアントを接続します。
• tool-reference.md：Studio MCP ツールを選び、対象の Studio インスタンスを特定します。