Tripwire

Tripwire を使うと、アシスタントはデータモデルの読み取り、書き込み、編集、シミュレートされた入力によるプレイテストの実行、実際のエンジンでのヘッドレスなコードテスト、ゲームコードにおけるクライアント信頼の悪用の検出、Open Cloud API（DataStores、MessagingService、Memory Stores など）の呼び出しができます。Studio ツールに API キーは不要です。ヘッドレステスト、アセット、Open Cloud のツールには Open Cloud キーを使用します。

要件

• MCP クライアント：Claude Code、Codex、Gemini、または stdio 経由で MCP に対応する任意のクライアント。
• Studio ツールを使用する場合は、Roblox Studio が必要です。API キーは不要です。
• サーバーを npx で実行する場合に限り、Node.js が必要です。ビルド済みバイナリには Node は不要です。
• ヘッドレステスト、アセット、Open Cloud のツールには、公開済みの place と Roblox Open Cloud API キーが必要です。Open Cloud のセットアップを参照してください。

クイックスタート

Tripwire は、AI コーディングエージェントを通じて Studio を操作する Roblox 開発者向けです。

1. MCP クライアントにサーバーを接続します（コマンド 1 つ、または短い設定ブロックを使用します。以下のインストールを参照）。
2. Studio ツールから Studio に接続できるよう、Studio プラグインをインストールします（「インストール」のプラグイン手順を参照）。
3. Studio で place を開き、Game Settings > Security > Allow HTTP Requests をオンにします。次に Tripwire ツールバーのボタンをクリックし、パネルで Connect を押します。パネルに Connected と表示され、Output に [Tripwire v...] connected と出力されます。
4. エージェントに studio_status を実行するよう依頼します。Studio に接続できていれば、ブリッジが動作しています。
5. 任意：ヘッドレステスト、アセット、Open Cloud のツール用に Open Cloud キーを追加します（「Open Cloud のセットアップ」を参照）。

インストール

Tripwire のサーバーは単一のバイナリです。最も簡単な実行方法は npx を使うことです。プラットフォーム用のビルド済みバイナリが取得されるため、Rust ツールチェーンをインストールする必要はありません。手動でのバイナリ利用やソースからのビルドをご希望ですか？このセクションの最後にある「その他の方法」をご覧ください。

claude mcp add --transport stdio tripwire -- npx -y tripwire-roblox

{
  "mcpServers": {
    "tripwire": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "tripwire-roblox"]
    }
  }
}

[mcp_servers.tripwire]
command = "npx"
args = ["-y", "tripwire-roblox"]

{
  "mcpServers": {
    "tripwire": {
      "command": "npx",
      "args": ["-y", "tripwire-roblox"]
    }
  }
}

command: npx
args:    ["-y", "tripwire-roblox"]

git clone https://github.com/aliboIly/Tripwire.git
cd Tripwire/server
cargo build --release   # produces server/target/release/tripwire-server

cd Tripwire/plugin
npm install
npx rbxtsc
rojo build --output Tripwire.rbxmx
cp Tripwire.rbxmx ~/Documents/Roblox/Plugins/   # macOS; Windows: %LOCALAPPDATA%\Roblox\Plugins

Open Cloud のセットアップ

Tripwire の大半は認証情報を必要としません。以下のツールは Roblox Open Cloud を呼び出すため、認証情報が必要です。run_luau、ヘッドレステスト（run_tests、run_test_file、list_tests）、および以下の Open Cloud セクションにあるすべてのツール（アセット、公開、データストア、メッセージング、メモリ、ユニバースとサーバー、Engine Instance API、モデレーション、シークレット、収益化、Creator Store、グループ、分析、プラットフォーム、open_cloud_request）が対象です。認証には Roblox Open Cloud API キーを使用します。

自己責任でご利用ください。 Open Cloud キーは、エクスペリエンスに対して実際の操作権限を持つ認証情報です。付与するスコープによっては、稼働中の DataStore の読み取りや上書き、プレイスの新しいバージョンの公開、アカウントへのアセットのアップロード、サーバーへのメッセージ送信が可能になります。パスワードと同様に扱ってください。実際に使うスコープだけを付与し、自分の IP のみに制限し、決してコミットせず、漏えいした場合は失効させてください。このキーを使って行う操作については、ご自身が責任を負います。Tripwire は Roblox と提携しておらず、Roblox の承認も受けていません。

1. キーを作成する

1. create.roblox.com/dashboard/credentials にアクセスしてサインインします。
2. Create API Key をクリックし、名前を付けます（例：Tripwire）。
3. Access Permissions で、使用するツールに必要な API システムだけを追加し、それぞれに必要な操作を許可して、対象をエクスペリエンスに限定します。ダッシュボードで選択できるすべてのシステムに対応するツールがあります。対応表は、以下の権限とツールを参照してください。概要は次のとおりです。
   • Luau Execution（書き込み）：run_luau とヘッドレステスト。
   • universe-places（書き込み）：publish_place。
   • Assets（読み取り＋書き込み）と Asset Permissions：アセットツール。
   • DataStores と Ordered DataStores：データストアツール。
   • Messaging Service（パブリッシュ）と Memory Stores：それぞれに対応するツール。
   • Universe、Place、Instance、User Restrictions、Secrets、Analytics：ユニバース、サーバー、インスタンス、モデレーション、シークレット、アナリティクスのツール。
   • Developer Products、Game Passes、Creator Store：収益化とストアのツール。
   • User/Group/Inventory/Subscription/Notification：プラットフォーム、グループ、エンゲージメントのツール。
   • それ以外（レガシーおよび実験的なシステム）：open_cloud_request。
4. Security で、Accepted IP Addresses にお使いのマシンの IP アドレスを設定するか、任意の IP アドレスを許可する場合は 0.0.0.0/0 を設定します（ローカルでの使用にはこちらが最も簡単です）。必要に応じて有効期限も設定してください。
5. Save & Generate Key をクリックし、キー文字列をコピーします。キーが表示されるのは一度だけです。

2. ユニバース ID とプレース ID を確認する

Studio のコマンドバー（View、次に Command Bar）で、次を実行します。

print("universe", game.GameId, "place", game.PlaceId)

GameId が ROBLOX_UNIVERSE_ID、PlaceId が ROBLOX_PLACE_ID です。Open Cloud が操作するには、プレースが Roblox に 公開済みである必要があります。

3. Tripwire に認証情報を設定する

リポジトリのルートに .env を作成します。このファイルは gitignore に登録されており、サーバーが自動的に読み込みます。

ROBLOX_OPEN_CLOUD_KEY=paste_the_key_here
ROBLOX_UNIVERSE_ID=000000
ROBLOX_PLACE_ID=000000
ROBLOX_CREATOR_USER_ID=000000   # only for upload_asset (your user id)

代わりに、同じ変数を MCP クライアントの env ブロックに記述することもできます（こちらの設定が優先されます）。 どちらを変更した場合も、MCP サーバーに再接続してください。各ツールは、キーに必要なスコープが付与されていれば動作し、スコープが不足している場合は Roblox 独自のエラーを返すため、必要に応じてスコープを追加できます。

ツール

接続

空間（読み取り専用）

編集（各操作が1回の元に戻す操作になります）

テストとヘッドレス実行（Open Cloud）

セキュリティレビュー（静的解析、キー不要）

DataStores（Open Cloud）

ユニバース、プレース、サーバー（Open Cloud）

Engine Instance API（Open Cloud、Studio 不要）

モデレーション（Open Cloud）

シークレット（Open Cloud）

グループ（Open Cloud）

プラットフォーム、エンゲージメント、分析（Open Cloud）

その他すべて（Open Cloud）

Creator Dashboard でキーに追加できる各 API システムと、それを使用するツールです。スコープ名は、ダッシュボードや Roblox のエラーメッセージで使用されているものです。

できること

• プロンプトからシーンを構築します。 インスタンスを作成・一括作成し、型付きプロパティを設定し、モデルを挿入してスクリプトを書き込みます。それぞれの操作は、個別に元に戻せます。
• CI でゲームプレイをテストします。 テスト仕様を記述し、Open Cloud 経由で実際のエンジン上でヘッドレス実行して、その結果をプルリクエストのマージ条件にできます。
• リリース前にエクスプロイトを検出します。 セキュリティレビュー担当がクライアントの入力を信頼しているサーバーハンドラーにフラグを立て、サーバー側での修正を提案します。同じチェックがすべての PR で自動的に実行されます。
• 実際のプレイテストを実施します。 Play モードに入り、キーボードとマウスの入力を送り、キャラクターを目的の場所まで歩かせ、サーバーとクライアントの出力をまとめて読み取ってから停止します。
• ライブのプレースを調査します。 インスタンスツリーを読み取り、名前やプロパティで検索し、スクリプトを読み取って grep し、Output ログを取得します。
• Open Cloud を自動化します。 テスト用フィクスチャとして DataStores にデータを投入したり、プレースを公開したり、MessagingService のトピックにメッセージをブロードキャストしたり、ユーザー、グループ、インベントリを検索したりできます。

既知の制限

これらはプラットフォームの制限であり、バグではありません。あらかじめ把握していただけるよう、ここに記載しています。

• F5 のプレイテスト停止はベストエフォートです。プラグインと実行中のゲームは別々の DataModel であるため、stop_playtest が機能しない場合があります。stop_simulation（F8）を使えば確実に停止できます。F5 のプレイテストが停止しない場合は、Studio で「Stop」を押してください。
• プレイ中のアクションは、注入されたランナーを経由します。プレイテスト中の入力、実行時の状態、停止はプラグインから直接呼び出されるのではなく、ブリッジ経由で中継されます。
• ヘッドレステストはサーバーコンテキストで実行されます。Open Cloud は公開済みのプレースをサーバー上で実行するため、RunService:IsStudio() は false になり、プラグイン API も利用できません。サーバーやゲームプレイのロジック、セキュリティテストには使用できますが、Studio プラグインやクライアント入力の動作には使用できません。
• Roblox に組み込まれている Assistant とのツールの同等性は、手作業で維持されています。
• Open Cloud のいくつかのシステムは、Roblox 側でベータ版または試験段階です（Instance API、ユーザー制限、シークレット、ゲームサーバー、分析、および open_cloud_request の背後にあるすべての機能）。仕様が変更される可能性があり、open_cloud_request は整形されていない生のレスポンスを返します。

Tripwire は、1 人が空き時間にメンテナンスしています。Issue やプルリクエストには、通常 1 週間ほどで返信します。返信が遅いからといって、対応しないという意味ではありません。

トラブルシューティング

Studio のツールがタイムアウトする、または Studio に接続されていないと表示されます。 プラグインが接続されていません。Tripwire.rbxmx をインストールして Studio を再起動し、Tripwire のツールバーボタンをクリックして、パネルの「Connect」を押してください。パネルのステータスと Output の [Tripwire v...] connected という行の両方で、接続を確認できます。

プラグインが HTTP がブロックされていると報告します。 開いているプレースで、ゲーム設定 > セキュリティ > HTTP リクエストを許可 をオンにしてください。これはセットアップ時に最もよく発生する問題です。これを有効にしないと、Studio はローカルブリッジに接続できません。

Output に、プラグインとサーバーのバージョンが一致しないと表示されます。 インストールされている .rbxmx が古くなっています。再ビルドし（npx rbxtsc && rojo build --output Tripwire.rbxmx）、Plugins フォルダーにコピーしてから Studio を再起動してください。プラグインはコンパイル済みのバージョンを出力するため、接頭辞から実際にインストールされているバージョンを確認できます。パネルのヘッダーにも同じバージョンが表示されます。

Open Cloud のツールが 401 Invalid API Key を返します。 キー自体が受け付けられていません。再生成された、期限切れになった、または一部しか貼り付けられていない可能性があります。すべてのツールで同じエラーが発生します。Creator Dashboard でキーを作成し直すか、もう一度コピーし、ROBLOX_OPEN_CLOUD_KEY を置き換えて、MCP サーバーに再接続してください。

Open Cloud のツールが 403 またはスコープエラーを返します。 キーにそのツールが必要とするスコープがない、ユニバース ID またはプレース ID が間違っている、あるいはプレースが公開されていない可能性があります。Creator Dashboard でスコープを追加し（必要なスコープはツールの説明に記載されています）、ID を確認して、MCP サーバーに再接続してください。エラーテキストは Roblox 独自のものなので、不足している項目が示されます。

run_tests が最新の変更を認識しません。 公開済みのプレースを読み込むため、先に公開してください。rojo serve が更新するのはライブ編集セッションのみであり、Open Cloud が実行する内容は更新されません。

npx がサーバーを取得できません。 Node.js がインストールされていないか、初回ダウンロード時にネットワーク接続がありません。Node をインストールするか、Releases ページからビルド済みバイナリを使い、command にそのパスを指定してください（Install の Alternatives を参照）。

サーバーがブリッジのポートが使用中だと報告します。 前のサーバーがまだポート 44331 を使用しています。以前の MCP セッションまたは古いプロセスを終了してから、再接続してください。

先行事例

Studio の実行時アプローチ（ローカルサーバーをロングポーリングするプラグインと、プレイ中に注入されるランナー）は、 boshyxd/robloxstudio-mcp と Chrrxs/robloxstudio-mcp のアイデアを参考にしています。Tripwire は独立したゼロからの実装であり、ヘッドレステストハーネス、CI セキュリティレビューアー、Open Cloud のツール群は独自に開発されたものです。

コントリビューション

バグ報告、機能のアイデア、パッチを歓迎します。セットアップ、ビルドゲート、ブランチとコミットのルールについてはCONTRIBUTING.mdを、各要素の連携についてはARCHITECTURE.mdをご覧ください。参加することで、行動規範に同意したものとみなされます。

セキュリティ上の問題を見つけましたか？公開のIssueは作成しないでください。非公開での報告方法については、SECURITY.mdをご覧ください。

変更履歴

各バージョンのリリースノートはリリースページにあります。

ライセンス

MITです。LICENSEをご覧ください。