WEPPY

Codex App設定

Codex AppでWEPPY Roblox AI ToolkitとRoblox MCPを使用する方法。

OpenAI Codex App(macOS)でWEPPY Roblox AI ToolkitとRoblox MCPを使用する方法です。

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

前提条件

  • Codex App インストール済み(macOS)
  • ターミナルで codex コマンド が使用可能(マーケットプレイス追加用)
  • Roblox Studioプラグイン インストール完了

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

npm install -g @openai/codex

方法1: WEPPY Roblox AI Toolkitをインストール(推奨)

ターミナルでWEPPYプラグインマーケットプレイスを追加します:

codex plugin marketplace add hope1026/weppy-roblox-mcp

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

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

Skillsメニューで確認・使用

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

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

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

方法2: MCPサーバーのみ手動登録

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設定を使用します。

接続テスト

  1. Roblox Studio を起動 → Pluginsタブ → WEPPYConnect
  2. Codex Appで新しい会話を始めてテスト:
    Roblox Studioで現在選択されているものを教えて

トラブルシューティング

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

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

npx -y @weppy/roblox-mcp@latest

WEPPYプラグインがPluginsメニューに表示されないとき

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

codex plugin marketplace upgrade hope1026-roblox-mcp

接続失敗

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