コーディングハーネスを使用して構築する | 文書

このガイドと付随するビデオでは、MCPを介してAI対応のコーディングハーネスをRoblox Studioに接続し、エージェントがあなたの代わりに読み書きやプレイテストを行えるようにする手順を説明します。

最後には、Script Sync（自分のエディタを使用してコードを書くことを可能にする機能）を使用してStudioに同期するプロジェクトフォルダー、エージェントがStudioを直接操作できるMCP接続、開発のために準備されたGitリポジトリを持つことになります。

ステップ1: 事前準備をインストールする

始める前に、以下のコンポーネントが必要です。

AI対応のテキストエディタ - 最も人気のあるオプションはVisual Studio CodeとCursorです。CursorにはAIアシスタントが内蔵されていますが、VS CodeはClaude Codeのような拡張機能が必要です。どちらもここでうまく機能しますので、お好みのものを使用してください。
Roblox Studio - create.roblox.comからダウンロードします。
Git - git-scm.comからインストールします。
- Windowsでは、WinGetを使用できます: winget install --id Git.Git -e --source winget。
- macOSでは、Homebrewを使用できます: brew install git。

ステップ2: すべてにサインインする

テキストエディタ:
- VS Code — サインインは拡張機能によって異なります。Claude Codeの場合は、アクティビティバーのClaudeアイコンをクリックし、Anthropicアカウントでサインインして、チャットパネルが開くことを確認します。他のプロバイダーも同様です。
- Cursor — Cursorを開き、Cursorアカウントでサインインして、チャットパネルが開くことを確認します。お好みのモデルを使用できます。
Roblox Studio — Studioを開き、Robloxアカウントでサインインして、新しい場所を作成できることを確認します。

ステップ3: スタータリポジトリをダウンロードする

スタータリポジトリはフォルダーのレイアウトと.gitignoreファイルを提供し、Gitがプロジェクトの重要な部分のみをコミットするようにします。ほとんどの手動セットアップは既に行われています。

スタータリポジトリをダウンロードし、解凍します。既にWaveSurvivalという名前のフォルダーが含まれています。
エディタでファイル → フォルダーを開くを選択し、WaveSurvivalを選択します。内部に3つのフォルダーが表示されるはずです:
- ServerScriptService/にはゲームロジック、敵AI、ウェーブ管理などのサーバースクリプトが格納されています。
- ReplicatedStorage/にはサーバーとクライアントの両方が使用できる共有モジュールが格納されています。
- StarterPlayerScripts/には各プレイヤーのために実行されるクライアントスクリプトが格納されています。

各フォルダー内の.gitkeepファイルはプレースホルダーであり、Gitが空のままフォルダーを追跡できるようにします。

ステップ4: Roblox Studioで空のプロジェクトを作成する

Roblox Studioを開き、新しい体験をクリックします。
ファイル → ファイルに保存を選択し、WaveSurvivalフォルダーに移動して、場所をWaveSurvival.rbxlxとして保存します。スタータリポジトリの.gitignoreはすでに.rbxlxファイルをGitから除外しています。
Studioを開いたままにしておきます。 Script SyncおよびMCPのために必要です。

ステップ5: Script Syncベータを有効にする

Script Syncはベータ機能ですので、使用する前に有効にする必要があります。

Studioは頻繁に更新されます。リストにScript Syncが表示されない場合は、最新バージョンのStudioをインストールして再試行してください。

Studioでファイル → ベータ機能を選択します。
Script Syncを見つけて有効にし、保存をクリックします。
プロンプトが表示されたらStudioを再起動します。

ステップ6: Script Syncを接続する

Script Syncは、各Studioサービスをディスク上の対応するフォルダーにリンクさせることで、プロジェクトごとに一度接続します。

エクスプローラーでServerScriptServiceを右クリックします。
Script Sync → 同期先を選択し、WaveSurvivalフォルダーを参照します。
ReplicatedStorageおよびStarterPlayerScriptsについても繰り返します。

フォルダー内のフォルダーではなく、最上位のWaveSurvivalフォルダーを選択してください。フォルダーにはすでに適切な名前が付いているため、Script Syncは自動的に各サービスを正しいものと一致させます。

これらのフォルダー内で作成する.luauファイルは、Studio内で自動的にスクリプトとして表示されます。

ステップ7: Script Syncを確認する

エディタのチャットパネルでエージェントにプロンプトを送ります：

ServerScriptService/Test.server.luauに'Hello from Script Sync!'を出力するテストスクリプトを作成してください。

Studioのエクスプローラーを確認します。TestがServerScriptServiceの下に表示されるはずです。MCPが接続された後に、より詳細なエージェント駆動のチェックを実行します。

ステップ8: MCP接続を有効にする

StudioのMCPサーバーにより、AIエージェントはStudioと直接対話し、ゲームツリーを読み取り、オブジェクトを作成し、スクリプトを実行し、出力を確認できます。これは、StarterGuiやStarterPackなどのScript Syncが届かない範囲もカバーします。

Studioで、右上のアシスタントボタンを使用してアシスタントウィンドウを開きます。
⋯ → MCPサーバーの管理をクリックします。
MCPが有効になっていることを確認します。
クイック接続の下で、CursorまたはVisual Studio Codeを有効にします。

Studioを開いている状態でエディタをインストールした場合、接続を確立するためにStudio、エディタ、またはその両方を再起動する必要があるかもしれません。詳細については、Roblox Studio MCPサーバーへの接続を参照してください。

ステップ9: MCP接続を確認する

エージェントにプロンプトを送ります：

Roblox MCPを使用して、Roblox Studioの現在のゲームツリーを読み取ります。Workspace内の内容をリストしてください。

コマンドを承認する必要があるか、MCPツールを許可リストに追加する必要があるかもしれません。新しいベースプレートテンプレートの場合、応答にはデフォルトのCamera、Terrain、Baseplate、およびSpawnLocationが記載されており、他のコンテンツはまだないことを確認します。

Roblox MCP接続を使用して、Script Syncが正常に機能しているか確認してください。Test.server.luauにいくつか変更を加え、他の2つのフォルダーに新しいスクリプトを追加し、それぞれの出力を確認してください。各スクリプト内でgame:GetService("InstanceFileSyncService"):GetStatus(instance)を実行して同期状態を確認してください。完了したら、すべてのスクリプトを削除してください。

Studioで監視すると、エージェントが出力を確認するためにプレイテストを開始するのが見えます。

ステップ11: Gitにコミットする

今、あなたはクリーンで動作する構成を持っていますので、コミットする良いタイミングです。ターミナルから：


git add .
git commit -m "Script sync connected and MCP verified"

次のステップ

あなたのプロジェクトは現在Studioに同期されており、AIエージェントは直接話しかけることができ、変更や進捗を追跡するためのGitリポジトリも持っています。

ここから、スタータープロジェクトにあるWAVE_SURVIVAL.mdファイルをコンテキストとして使用して、エージェントがウェーブサバイバルゲームを構築できるようになります。伴うビデオに従って、テストされたフェーズごとにゲームを構築してください。