Roblox Studio MCPサーバーは、Roblox Studioに組み込まれています。これは、AIツールが外部アプリケーションと安全に通信できるオープンスタンダードであるModel Context Protocol (MCP)を実装しています。接続が確立されると、AIクライアントはオープンなStudioセッションと直接対話し、データモデルを探索し、スクリプトを作成し、Luauコードを実行し、プレイモードでゲームをテストできます。
このガイドでは、Studio MCPサーバーを人気のAIクライアントに接続する方法を示します。セットアップはクライアントによって異なりますが、基本的な考え方は同じです:クライアントをMCPサーバーに接続するように設定し、クライアントからアクティブなStudioセッションにコマンドを送信します。
APIキーなしでMCPクライアントからOpen Cloud APIを呼び出す方法については、Studio MCPサーバーでOpen Cloudを使用するを参照してください。
前提条件
サーバーに接続する前に、最新のRoblox Studioと好みのMCPクライアントがコンピュータにインストールされていることを確認してください。
Studio MCPサーバーの動作
サーバーは、あなたのマシン上でローカルプロセスとして実行され、AIクライアントと**stdioトランスポート**を使用して通信します。これは標準入力/出力ストリームを使用します。すべてのアクションはAIクライアントを通じて開始され、その後、このチャネルを介してリクエストを送信してStudioセッション内でアクションを実行します。
サーバーは以下のツールを提供します:
| スクリプト | |
|---|---|
| script_read | ドット表記パスを使用してゲームからスクリプトを読み取ります(例:game.ServerScriptService.MyScript)。全体のスクリプトまたは特定の行範囲の読み取りをサポートします。 |
| multi_edit | 1つの操作でスクリプトに複数の編集を適用します。ターゲットパスが存在しない場合は、新しいスクリプトを作成します。datamodel_type(Edit)を指定する必要があります。 |
| script_search | 名前を使用してスクリプトをファジーマッチングで検索します。最大10件の結果を返します。 |
| script_grep | ゲーム内のすべてのスクリプトで文字列パターンを検索します。最大50件の一致を返します。 |
| アセットとコンテンツ生成 | |
| generate_animation | テキストプロンプトからR15アニメーションを生成するか、既存のR6アニメーションをそのアセットIDからR15に変換します。特定のリグをターゲットにし、最大10秒の持続時間を設定することをサポートします。 |
| 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 | デバッグ、デバイスシミュレーション、ドキュメント検索などの特定のスキルに関する詳細な知識、ベストプラクティス、またはリファレンスマテリアルを取得します。 |
| プレース管理 | |
| save_place | オープンプレースをファイル ⟩ 保存と同じ方法で保存します:Robloxから開かれたプレースの新しいバージョンとして、またはローカルの.rbxおよび.rbxlxプレースのファイルに戻します。ダイアログは開きません。 |
| セッション管理 | |
| list_roblox_studios | 接続されているすべてのStudioインスタンスをリストし、それぞれの名前、StudioインスタンスID、およびプレースIDを表示します。プレースIDを持たないローカルプレースは名前のみでリストされます。複数のStudioウィンドウが開いているときに便利です;2つのオープンStudioインスタンスが同じ名前を共有している場合、プレースIDを使用して区別できます。 |
| フィードバック | |
| submit_feedback | ツールが失敗したとき、機能が欠けているとき、またはStudio内のワークフローが必要以上に多くのステップを要する場合に、Robloxにフィードバックを送信します。これにより、チームはStudioとそのMCPツールを改善できます。 |
プレイテストの自動化はテレポートを跨いで機能します。プレイテスト中、エージェントはプレイヤーを同じ体験内の別のプレースにテレポートし、宛先サーバーの出力を読み取り、見つけた問題を修正できます。すべての操作は公開せずに行われます。サポートされているテレポート方法とテストの制限については、Studioでのテレポートをテストするを参照してください。
StudioでMCPサーバーを有効にする
StudioでMCPサーバーを有効にするには:
- アシスタントを開きます。
- … ⟩ MCPサーバーの管理をクリックします。
- StudioをMCPサーバーとして有効にするをオンにします。
有効にすると、設定パネルにクイック接続オプションと異なるクライアントのセットアップ手順が表示されます。クライアントが正常に接続されると、緑のインジケーターが接続されたクライアントの数を示します。
クライアントを接続する
クライアントをStudio MCPサーバーに接続するには、クイック接続、JSON構成、またはCLIコマンドを使用できます。
- クライアントがサポートされている場合は、クイック接続を使用します。
- そうでない場合は、クライアントがMCP構成ファイルをサポートしている場合はJSON構成を使用します。
- それ以外の場合は、CLIコマンドを使用します。
Studio MCPサーバーは、stdioトランスポートをサポートする任意のクライアントで動作します。構成を追加した後は、クライアントのドキュメントに従ってセットアップを完了し、変更を適用するためにクライアントを再起動してください。
クイック接続
クイック接続は以下のクライアントをサポートしています:
- Antigravity
- Codex CLI
- Claude Code
- Claude Desktop
- Cursor
- Gemini CLI
- Visual Studio Code
クイック接続を使用して接続するには:
- アシスタント設定 ⟩ MCPサーバーに移動します。
- クイック接続のドロップダウンを展開して、コンピュータにインストールされているサポートされているクライアントを表示します。
- 選択したクライアントをオンにします。
希望するクライアントがクイック接続リストに表示されない場合は、それをインストールし、Roblox Studioを再起動してください。
JSON構成
ほとんどのMCPクライアントはJSON構成ファイルをサポートしています。以下の例は、使用できる完全な構成を示しています。
Roblox Studioが唯一のMCPサーバーである場合は、これらの構成をそのまま使用します。複数のMCPサーバーを使用している場合は、Roblox_Studioエントリをコピーして、既存のmcpServers辞書に追加します。
構成はオペレーティングシステムによって異なります:
{
"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で接続が機能していることを確認します:
- アシスタントを開きます。
- … ⟩ MCPサーバーの管理をクリックします。
- StudioをMCPサーバーとして有効にするの下で、クライアントが正常に接続されたことを確認するために緑のインジケーターを確認します。
トラブルシューティング
サーバーが表示されない場合やツールが利用できない場合:
- Roblox StudioとMCPクライアントの両方を再起動します。
- コマンドまたはバイナリパスが正しいことを確認し、ファイルが存在することを確認します。
- JSON構文を確認します。カンマや括弧が欠けているだけでも、構成が読み込まれなくなることがあります。