Roblox Studio MCPサーバーは、Roblox Studioに組み込まれています。これは、AIツールが外部アプリケーションと安全に通信できるオープンスタンダードであるModel Context Protocol (MCP)を実装しています。接続が完了すると、AIクライアントはオープンなStudioセッションと直接対話し、データモデルを探索し、スクリプトを作成し、Luauコードを実行し、プレイモードでゲームをテストできます。
このガイドでは、Studio MCPサーバーを人気のAIクライアントに接続する方法を示します。セットアップはクライアントによって異なりますが、基本的な考え方は同じです：クライアントをMCPサーバーに接続するように設定し、クライアントからアクティブなStudioセッションにコマンドを送信します。
前提条件
サーバーに接続する前に、最新のRoblox Studioと好みのMCPクライアントがコンピュータにインストールされていることを確認してください。
Studio MCPサーバーの動作
サーバーは、あなたのマシン上でローカルプロセスとして実行され、stdioトランスポートを使用してAIクライアントと通信します。これは標準入力/出力ストリームを使用します。すべてのアクションはAIクライアントを通じて開始され、その後、このチャネルを介してリクエストを送信してStudioセッション内でアクションを実行します。
サーバーは以下のツールを提供します：
| スクリプト | |
|---|---|
| script_read | ドット表記パスを使用してゲームからスクリプトを読み取ります（例：game.ServerScriptService.MyScript）。全体のスクリプトまたは特定の行範囲の読み取りをサポートします。 |
| multi_edit | 1つの操作でスクリプトに複数の編集を適用します。ターゲットパスが存在しない場合は、新しいスクリプトを作成します。datamodel_type（Edit）を指定する必要があります。 |
| script_search | 名前によるスクリプトの検索をファジーマッチングを使用して行います。最大10件の結果を返します。 |
| script_grep | ゲーム内のすべてのスクリプトで文字列パターンを検索します。最大50件の一致を返します。 |
| アセットとコンテンツ生成 | |
| generate_mesh | テキストプロンプトからAIを使用してテクスチャ付き3Dメッシュを生成します。 |
| generate_material | カスタムマテリアルバリアントを生成します。パーツに適用するためのベースマテリアルとマテリアルバリアント名を返します。 |
| generate_procedural_model | プリミティブパーツ（ブロック、球体、円柱、くさび）から構築された3Dオブジェクトを、構成可能な属性を持つProceduralModelとして作成します。参照画像とカスタムパーツスキーマをサポートします。 |
| wait_job_finished | 手続き型モデル生成ジョブが完了するのを待ち、最終ステータスを返します。 |
| search_asset | Creator Store（公開マーケットプレイス）およびCreator Inventory（ユーザー、グループ、またはユニバース）全体でアセットを検索します。アセットタイプ、価格、タグ、スコープによるフィルタリングをサポートします。 |
| insert_asset | 数値のRobloxアセットIDを使用してゲームにアセットを挿入します。モデル、メッシュ、画像、オーディオ、ビデオ、アニメーション、パッケージをサポートします。 |
| upload_image | HTTP URLからの画像のバッチをRobloxアセットサーバーにアップロードし、画像パスとアセットIDのマップを返します。 |
| store_image | ローカルファイルパスから画像を読み込み、他のツールに渡すことができる画像URIを返します（例：generate_procedural_modelの参照画像として）。 |
| データモデルの探索 | |
| subagent | 複雑なマルチステップタスクを自律的に処理するための専門のサブエージェントを起動します。利用可能なタイプには、explore（コードベースの調査とゲーム状態のクエリ用）とplaytest（ゲームプレイシナリオの実行と結果の検証用）があります。 |
| search_game_tree | インスタンス階層をフラットなJSON配列として探索します。パス、インスタンスタイプ、キーワードによるフィルタリングをサポートし、深さ制限を構成可能です。 |
| inspect_instance | 特定のインスタンスに関する詳細情報を返します。すべての読み取り可能なプロパティ、カスタム属性、およびその子供や子孫の概要を含みます。 |
| Luau実行 | |
| execute_luau | StudioでLuauコードを実行します。結果またはエラーを返します。datamodel_type（Edit、Client、またはServer）を指定する必要があります。 |
| プレイテスト | |
| get_studio_state | Studioの現在の状態を取得します。プレイ状態と利用可能なデータモデルタイプを含みます。 |
| start_stop_play | プレイテストを開始または停止します。 |
| get_console_output | Studioの出力ログから出力を取得します。 |
| screen_capture | 現在のStudioビューポートをキャプチャし、画像データを返します。オプションでカスタムカメラ位置と注視対象を受け入れます。 |
| プレイヤー入力シミュレーション | |
| character_navigation | プレイヤーキャラクターを指定された位置またはインスタンスパスに移動します。構成可能な速度倍率をサポートします。 |
| user_keyboard_input | 1つ以上のキーボードアクションを順番に送信します：キーを押す、キーを離す、キーを押す、テキスト入力、または待機します。特定のUIインスタンスをターゲットにすることをサポートします。 |
| user_mouse_input | 1つ以上のマウスアクションを順番に送信します：移動、クリック、ボタンを押す/離す、スクロール、または待機します。特定のインスタンスまたは画面座標をターゲットにすることをサポートします。 |
| ドキュメントとスキル | |
| http_get | 許可されたRobloxドキュメントURL（エンジンAPIリファレンス、クリエイター文書、クラウドAPI、パフォーマンス最適化ガイド）からコンテンツを取得します。取得したコンテンツ内でのキーワード検索をサポートします。 |
| skill | デバッグ、デバイスシミュレーション、ドキュメント検索などの特定のスキルに関する詳細な知識、ベストプラクティス、またはリファレンスマテリアルを取得します。 |
| セッション管理 | |
| list_roblox_studios | 接続されているすべてのStudioインスタンスをリストし、その名前、StudioインスタンスID、およびプレイスIDを含みます。プレイスIDを持たないローカルプレイスは名前のみでリストされます。複数のStudioウィンドウが開いているときに便利です。2つのオープンStudioインスタンスが同じ名前を共有している場合、プレイスIDを使用して区別できます。 |
すべてのツール呼び出しには、ターゲットとするStudioインスタンスの名前を指定するstudio_idパラメータが含まれているため、エージェントはセッション状態に依存せずにStudioインスタンスを明示的に指定します。list_roblox_studiosを使用して、目的のインスタンスのIDを調べてください。
StudioでMCPサーバーを有効にする
StudioでMCPサーバーを有効にするには：
- Assistantを開きます。
- … ⟩ MCPサーバーの管理をクリックします。
- StudioをMCPサーバーとして有効にするをオンにします。
有効にすると、設定パネルにクイック接続オプションと異なるクライアントのセットアップ手順が表示されます。クライアントが正常に接続されると、緑のインジケーターが接続されているクライアントの数を示します。
クライアントを接続する
クライアントをStudio MCPサーバーに接続するには、クイック接続、JSON構成、またはCLIコマンドを使用できます。
- クライアントがサポートされている場合は、クイック接続を使用します。
- サポートされていない場合は、クライアントがMCP構成ファイルをサポートしている場合はJSON構成を使用します。
- それ以外の場合は、CLIコマンドを使用します。
Studio MCPサーバーは、stdioトランスポートをサポートする任意のクライアントで動作します。構成を追加した後は、クライアントのドキュメントに従ってセットアップを完了し、変更を適用するためにクライアントを再起動してください。
MCPクライアントは、オープンなRobloxプレイス内のコンテンツを読み取り、変更できます。信頼できるクライアントのみを接続するようにしてください。
クイック接続
クイック接続は、以下のクライアントをサポートしています：
- Antigravity
- Codex CLI
- Claude Code
- Claude Desktop
- Cursor
- Gemini CLI
- Visual Studio Code
クイック接続を使用して接続するには：
- Assistant Settings ⟩ MCP Serversに移動します。
- クイック接続ドロップダウンを展開して、コンピュータにインストールされているサポートされているクライアントを表示します。
- 選択したクライアントをオンにします。
希望するクライアントがクイック接続リストに表示されない場合は、それをインストールし、Roblox Studioを再起動してください。
JSON構成
ほとんどのMCPクライアントはJSON構成ファイルをサポートしています。以下の例は、使用できる完全な構成を示しています。
Roblox Studioが唯一のMCPサーバーである場合は、これらの構成をそのまま使用します。複数のMCPサーバーを使用している場合は、Roblox_Studioエントリをコピーして、既存のmcpServers辞書に追加します。
mcp.jsonファイルには、すでに他のエントリが含まれている場合があります。Roblox_Studio構成を追加する際は、各エントリがカンマで区切られていることを確認してください。カンマが欠けていると、無効なJSONとなり、構成が読み込まれなくなります。
構成はオペレーティングシステムによって異なります：
{
"mcpServers": {
"Roblox_Studio": {
"command": "cmd.exe",
"args": [
"/c",
"%LOCALAPPDATA%\\Roblox\\mcp.bat"
]
}
}
}{
"mcpServers": {
"Roblox_Studio": {
"command": "/Applications/RobloxStudio.app/Contents/MacOS/StudioMCP"
}
}
}CLIコマンド
一部のMCPクライアントは、JSON構成の代わりにCLIコマンドを必要とします。オペレーティングシステムに応じた適切なコマンドを使用してください：
cmd.exe /c %LOCALAPPDATA%\Roblox\mcp.bat/Applications/RobloxStudio.app/Contents/MacOS/StudioMCP複数のStudioインスタンスを使用する
単一のMCPクライアントを複数の実行中のStudioインスタンスに同時に接続できます。すべてのツール呼び出しには、ターゲットとするStudioインスタンスを識別するstudio_idが含まれており、複数のStudioインスタンスと複数のエージェントまたはクライアントを使用したワークフローが信頼性のあるものになります。
list_roblox_studiosを使用して、接続されているインスタンスの名前、StudioインスタンスID、およびプレイスIDをリストします。その後、次の呼び出しでstudio_idとして目的のインスタンスのIDを渡します。
接続を確認する
クライアントのセットアップ後、Roblox Studioで接続が機能していることを確認します：
- Assistantを開きます。
- … ⟩ MCPサーバーの管理をクリックします。
- StudioをMCPサーバーとして有効にするの下で、クライアントが正常に接続されたことを確認するために緑のインジケーターを確認します。
トラブルシューティング
サーバーが表示されない場合やツールが利用できない場合：
- Roblox StudioとMCPクライアントの両方を再起動します。
- コマンドまたはバイナリパスが正しいことを確認し、ファイルが存在することを確認します。
- JSON構文を確認します。カンマや括弧が欠けているだけでも、構成が読み込まれなくなる可能性があります。