OpenAI Codex App（macOS）でWEPPY AI Agent PluginとWEPPY Roblox AI ToolkitのWEPPY MCP Serverを使用する方法です。

Codex Appでは、Plugins メニューからプラグインをインストールし、インストール済みのスキルは Skills メニューまたはプロンプトから確認できます。WEPPY AI Agent PluginはMCPサーバー設定とRoblox Studio作業用スキルをまとめて提供するため、手動MCP設定より先にプラグインをインストールすることを推奨します。

前提条件

Codex App インストール済み（macOS）
ターミナルで codex コマンド が使用可能（マーケットプレイス追加用）
WEPPY Roblox Studio Plugin インストール完了

codex コマンドがない場合は、Codex CLIをインストールしてください:

npm install -g @openai/codex

方法1: WEPPY AI Agent Pluginをインストール（推奨）

ターミナルでWEPPY AI Agent Pluginマーケットプレイスを追加します:

codex plugin marketplace add hope1026/weppy-roblox-mcp

その後、Codex Appを開き直し、Plugins メニューで追加されたWEPPYマーケットプレイスを選択して WEPPY AI Agent Plugin をインストールします。アプリではプラスボタンまたは Add to Codex からインストールできます。

インストール後、新しい会話を開始してください。プラグインが npx -y @weppy/roblox-mcp@latest のMCPサーバー設定とWEPPYスキルを一緒に追加します。

Skillsメニューで確認・使用

インストール後、Codex Appの Skills メニューでWEPPYスキルを確認できます。

WEPPY MCP Server Guide: Studioの直接制御、UI Studio、playtest、ログ確認
WEPPY Roblox Sync Guide: Studio-local sync、同期方向、競合処理、Roblox Explorerコンテキスト

プロンプトで @ を使うとプラグインまたは同梱スキルを直接指定できます。$ を使うと特定のスキルを呼び出せます。直接指定しなくても、作業内容がスキル説明に合っていればCodexが自動で使用できます。

方法2: WEPPY MCP Serverを手動登録

WEPPYスキルなしでMCPサーバーだけを直接登録したい場合に使用します。アプリで Settings (Cmd + ,) → Integrations & MCP を開き、カスタムMCPサーバーを追加してください。方法1でプラグインをインストール済みなら、この手順は不要です。

Server name: weppy-roblox-mcp
Command: npx -y @weppy/roblox-mcp@latest

Codex App、Codex CLI、IDE拡張は同じ ~/.codex/config.toml のMCP設定を使用します。

接続テスト

Roblox Studio を起動 → Pluginsタブ → WEPPY → Connect

Codex Appで新しい会話を始めてテスト:

Roblox Studioで現在選択されているものを教えて

トラブルシューティング

サーバーが起動しないとき

MCPサーバーを直接実行してエラーを確認してください:

npx -y @weppy/roblox-mcp@latest

WEPPY AI Agent PluginがPluginsメニューに表示されないとき

マーケットプレイスを更新してからCodex Appを再起動してください:

codex plugin marketplace upgrade hope1026-roblox-mcp

接続失敗

WEPPY Roblox Studio Pluginが Connected 状態か確認
ポート3002がファイアウォールにブロックされていないか確認

Codex App設定