Roblox Studio MCPサーバーに接続する | 文書

Roblox Studio MCPサーバーはRoblox Studioに組み込まれています。これは、AIツールが外部アプリケーションと安全に通信できるオープンスタンダードであるModel Context Protocol (MCP)を実装しています。一度接続すると、AIクライアントは開いているStudioセッションと直接やりとりし、データモデルを探索し、スクリプトを書き、Luauコードを実行し、プレイモードで体験をテストできます。

このガイドでは、Studio MCPサーバーを人気のあるAIクライアントに接続する方法を示します。設定はクライアントによって異なりますが、基本的な考え方は同じです。クライアントをMCPサーバーに接続するように設定し、クライアントからアクティブなStudioセッションにコマンドを送信します。

前提条件

サーバーに接続する前に、最新のRoblox Studioと好みのMCPクライアントがコンピュータにインストールされていることを確認してください。

Studio MCPサーバーの動作

サーバーはあなたのマシン上でローカルプロセスとして実行され、AIクライアントと**stdioトランスポート**を使用して通信します。これにより、標準入力/出力ストリームを使用します。すべてのアクションはAIクライアントから開始され、その後、このチャネルを介してStudioセッション内でアクションを実行するためにリクエストが送信されます。

サーバーは以下のツールを提供します：

スクリプト
script_read	ドット表記パスを使用してゲームからスクリプトを読み取ります（例:game.ServerScriptService.MyScript）。スクリプト全体または特定の行範囲を読み取ることができます。
multi_edit	1つの操作でスクリプトに複数の編集を適用します。ターゲットパスが存在しない場合、新しいスクリプトを作成します。datamodel_type（編集）が必要です。
script_search	名前を使用してスクリプトをファジーマッチングで検索します。最大10件の結果を返します。
script_grep	ゲーム内のすべてのスクリプトで文字列パターンを検索します。最大50件の一致を返します。
アセットとコンテンツ生成
generate_mesh	テキストプロンプトからテクスチャ付き3DメッシュをAIを使用して生成します。
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（編集、クライアント、またはサーバー）の指定が必要です。
プレイテスト
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インスタンスをリストし、その名前、ID、およびアクティブなステータスを表示します。複数のStudioウィンドウが開いている場合に便利です。
set_active_studio	Studioインスタンスをアクティブとして設定し、以降のツール呼び出しがそのインスタンスにターゲットされるようにします。

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の設定 ⟩ MCPサーバーに移動します。
クイック接続のドロップダウンを展開して、コンピュータにインストールされているサポートされているクライアントを表示します。
選択したクライアントをオンにします。

希望するクライアントがクイック接続リストに表示されない場合は、それをインストールしてRoblox Studioを再起動してください。

JSON構成

ほとんどのMCPクライアントはJSON構成ファイルをサポートしています。以下の例は、使用できる完全な構成を示しています。

Roblox Studioが唯一のMCPサーバーである場合は、これらの構成をそのまま使用します。複数のMCPサーバーを使用している場合は、Roblox_Studioエントリをコピーして既存のmcpServers辞書に追加します。

mcp.jsonファイルには他のエントリがすでに含まれている場合があります。Roblox_Studio構成を追加する際には、各エントリをカンマで区切るようにしてください。カンマが欠落すると、不正なJSONとなり、構成が読み込まれない原因になります。

構成はオペレーティングシステムによって異なります：

Windows
{
  "mcpServers": {
    "Roblox_Studio": {
      "command": "cmd.exe",
      "args": [
        "/c",
        "%LOCALAPPDATA%\\Roblox\\mcp.bat"
      ]
    }
  }
}

macOS
{
  "mcpServers": {
    "Roblox_Studio": {
      "command": "/Applications/RobloxStudio.app/Contents/MacOS/StudioMCP"
    }
  }
}

CLIコマンド

一部のMCPクライアントは、JSON構成の代わりにCLIコマンドを必要とします。あなたのオペレーティングシステムに適したコマンドを使用してください：

Windows
cmd.exe /c %LOCALAPPDATA%\Roblox\mcp.bat

macOS
/Applications/RobloxStudio.app/Contents/MacOS/StudioMCP

複数のStudioインスタンスを使用する

単一のMCPクライアントを使用して、同時に複数の実行中のStudioインスタンスに接続することができます。サーバーはコンテキストに基づいて使用するインスタンスを自動的に決定します（例：特定のエクスペリエンスやそのインスタンスにのみ存在するオブジェクトを参照する場合）。

list_roblox_studiosおよびset_active_studioを使用してインスタンスを手動で切り替えることができます。

接続を確認する

クライアントの設定が完了したら、接続がRoblox Studioで正しく機能していることを確認します：

Assistantを開きます。
… ⟩ MCPサーバーの管理をクリックします。
StudioをMCPサーバーとして有効にするの下で、緑色のインジケーターが表示されていることを確認して、クライアントが正常に接続されたことを確認します。

トラブルシューティング

サーバーが表示されなかったり、ツールが利用できない場合：

Roblox StudioとMCPクライアントの両方を再起動します。
コマンドまたはバイナリパスが正しいか、ファイルが存在することを確認します。
JSONの構文を確認します。カンマや括弧が欠落すると、構成が読み込まれない場合があります。