← ブログへ

Codex / ChatGPT で Unity MCP に接続する

Codex や ChatGPT を Unity MCP に接続:Unity 側はインストールガイドと同じ。Codex は Open/Copy。ChatGPT は STDIO(relay、--port、Assets 直下のプロジェクトルート)。Hierarchy で確認。Codex や ChatGPT を Unity …

公開日
  • unity
  • mcp
  • codex
  • chatgpt
  • tutorial
  • unity-mcp
  • ai

このガイドでできること

Codex や ChatGPT を Unity MCP に接続するには? Unity 側(インポート・有効化・Server 起動)は Unity MCP インストール および Claude Code + Unity MCP と同じです。本稿は クライアントの MCP 設定のみ(Codex の Open/Copy、ChatGPT の STDIO フォーム)を扱います。

2 つの経路:

  1. Codex CLI — One-click Configuration(クイック設定) で Codex CLI を選び、Open(自動)または Copy で config.toml 断片を取得
  2. ChatGPT デスクトップ / Web — Open は使えない。Copy した relay 設定を STDIO MCP フォームに手入力(コマンド、引数、Unity プロジェクトの作業ディレクトリ)

完了時の状態:

  • エディタで Unity MCP Server が Running、ポートはパネル表示と一致
  • クライアントに unity-mcp(または同等名)が登録され tools が見える
  • 読み取り専用プロンプトでアクティブシーンの Hierarchy ルートを列挙できる

製品ページ:Unity MCP

前提条件

項目内容
Unity2022.3+ / Unity 6 推奨(ベンダーのサポート表記に従う)
Unity MCPインポート・有効化済み(インストール)
Server 実行中パネル Running;ポートを控える(既定 6589 のことが多い — パネル優先)
Codex CLI または ChatGPTカスタム STDIO MCP に対応
Unity プロジェクト操作対象プロジェクトを Unity で開いている
ローカル通信橋渡しは通常 127.0.0.1。ポートを公開しない

--port は Unity MCP パネルの値と一致させること。ブログやスクショの固定値は使わない。

パート 1:Unity 側(インストールと同じ)

未導入なら Unity MCP インストール に従う:ディスクからパッケージを追加 → MCP パネルで有効化 → サービスを起動 して Running → ツール管理 で必要な tools を有効化。

以下は Unity がすでに Running である前提です。

パート 2:Codex CLI

  1. Unity MCP パネル → One-click Configuration → Codex CLI
  2. Open で MCP 設定を書き込む、または Copy で config.toml を手動反映
  3. 形状の例のみ — Copy 出力のパスとポートを使う(Windows と macOS でパスは異なる):
[mcp_servers.unity-mcp]
command = "/Users/<you>/.unitymcp/relay/<relay-id>/unity-mcp-relay"
args = ["--stdio", "--port", "<panel-port>"]
  1. Codex CLI を再起動、または Codex 手順に従い MCP をリロード
  2. unity-mcp と tools が表示されることを確認

Unity + CLI の全体像は Claude Code + Unity MCP(Unity 手順は同じ、クライアントのみ異なる)。

パート 3:ChatGPT デスクトップ / Web

Unity MCP パネルで Codex CLI → Copy から relay 設定を取得し、TOML を ChatGPT に対応付けます。新規追加時は Name と Type(STDIO)を設定。Unity-mcp を更新する場合は下表とスクショの欄が一致します。

ChatGPT UI(英語表示)値
Name(追加時)unity-mcp(TOML セクション名と揃える)
Type(追加時)STDIO(HTTP/SSE 不可)
Start commandcommand = "..." の unity-mcp-relay へのフルパス(Copy 出力を Windows / Linux / macOS でそのまま使用)
Parameters3 行:--stdio → --port → パネルのポート番号
Environment variables空のまま
Environment variable inheritance空のまま
Working directoryUnity プロジェクトルート(Assets を含むフォルダ)。~/code などの汎用既定は避ける

ChatGPT デスクトップ UI(参考)

ChatGPT デスクトップ:Plug-ins → MCP → Update Unity-mcp — Start command、Parameters 3 行、Working directory(表と同じ)

スクショの relay パス・ポート・プロジェクトフォルダ は例です。Copy 出力とローカルの Assets 親パスを使ってください。

Save の後、ChatGPT デスクトップは完全終了して再起動(Web は更新後に新しいセッションで試す)。

作業ディレクトリが必要な理由

relay は STDIO で ChatGPT と通信しますが、どの Unity プロジェクトを対象にするかは プロジェクトルートで指定します。プロジェクトを切り替えたらここも更新してください。

Copy 設定の意味

  • unity-mcp-relay — クライアントとエディタ内 Unity MCP Server をつなぐローカル relay
  • --stdio — 子プロセスの標準入出力で接続
  • --port — Running サービスのポートと一致必須。不一致や未起動は 失敗・タイムアウト

接続確認

まず読み取り専用プロンプト:

MCP 経由でアクティブ Unity シーンの Hierarchy ルート GameObject を列挙してください。

Unity Hierarchy と一致したら、小さな書き込み(空の GameObject MCP_SmokeTest 作成→削除など)を試す。大きな変更の前にバージョン管理へコミット。

Server は Running だがエディタが active instances に無い場合は Unity MCP インストール FAQ を参照。

クライアント早見表

クライアントパネル操作
Cursorクイック設定 → 自動設定
Claude Code / Gemini CLICopy CLI command → ターミナル実行
Codex CLIOpen または Copy → config.toml
ChatGPT デスクトップ / WebCopy → STDIO フォーム + working directory

一覧:Unity MCP 対応 AI クライアント

FAQ

Codex の Copy は ChatGPT でも使える?
はい。command と arguments は同じ。ChatGPT では working directory も必須。

ChatGPT で MCP 接続失敗?
Unity Running、--port 一致、relay パスの実行権、Assets 親フォルダ、Save 後のクライアント再起動を確認。

Codex に Unity tools が出ない?
パネル Open を再試行、または Copy を config.toml に再貼付して Codex 再起動。それでも → active instances。

C# は全部手書き?
日常のスクリプトは MCP 経由で AI が作成・コンポーネント付与も可能 — 差分確認・コンパイル・Play モードで検証。アーキテクチャ・ネットワーク・ホットパスは人間が担当(FAQ)。

次のステップ

こちらの記事もおすすめです

AI IDE + エンジン MCP で自動ゲームテスト:推奨パス

Unity / Godot / Cocos 向け:Cursor 等の AI IDE とエンジン MCP で、反復可能なスモーク検査・規約巡回・テスト足場を作る。ゲームの自動テストは、リポジトリ内のユニット/エディタモード断言と、エンジン文脈を要するシーン/プレハブ検査の二系統が並走します。録画スクリプトは UI 変更…

  • game testing
  • MCP
  • AI IDE
  • automation
続きを読む