メインコンテンツまでスキップ

インストール

3つの導入方法があります。まず試すだけなら Git URL が最短です。

前提条件​

方法1 — Git URL​

Unityで Window → Package Manager を開き、+ → Add package from git URL... を選び、次のURLを貼り付けます。

https://github.com/CoplayDev/unity-mcp.git?path=/MCPForUnity#main

最新のbeta機能を使う場合は beta branchを指定します。

https://github.com/CoplayDev/unity-mcp.git?path=/MCPForUnity#beta

方法2 — Unity Asset Store​

  1. Asset StoreのMCP for Unityを開きます。
  2. Add to My Assets を選びます。
  3. Window → Package Manager → My Assets からimportします。

方法3 — OpenUPM​

openupm add com.coplaydev.unity-mcp

serverを起動して接続する​

import後、MCP for Unityのセットアップウィザードが自動的に開きます。

  1. Pythonとuvが導入済みか確認します。未導入の場合はウィザードの案内に従います。
  2. 依存関係が正常になったら Done を押します。PC上で検出されたMCPクライアントの一覧が表示されます。
  3. 設定したいクライアントを選び、Configure Selected を押します。

以後は Window → MCP for Unity からserverの起動・停止、通信方式（HTTP / stdio）の切り替え、クライアントの再設定を行えます。接続できるとstatus panelに Connected と表示されます。

最初に試すプロンプト​

MCPクライアントから例えば次のように指示します。

現在のシーンに赤・青・黄のCubeを作り、X軸方向に1 unitずつ離して配置してください。

WASD移動と二段ジャンプを持つ簡単なplayer controllerを作ってください。

Assets/Scripts 内の全scriptを一覧化し、Rigidbodyを参照しているものを教えてください。

クライアントごとの注意点​

  • Claude Desktop はstdioのみ対応します。全体設定でHTTPを選んでいても、MCP for UnityはClaude Desktop用にはstdioを設定します。
  • Cursor、Antigravity、OpenClaw は自動設定後、各クライアント側でMCPまたはpluginを有効化する必要があります。
  • OpenClaw は openclaw-mcp-bridge pluginも必要で、MCP for Unityで現在選択されている通信方式に従います。
  • Claude Code、VS Code、Windsurf、Cline、CLI系クライアント は設定後に自動接続します。

詳細はMCPクライアント設定ガイドを参照してください。

MCPクライアントを手動設定する​

自動設定が使えない場合は、各クライアントのMCP設定ファイルへ以下を追加します。

HTTP（既定 — Cursor、Windsurf、Antigravity、VS Code、Clineなど）​

{
  "mcpServers": {
    "unityMCP": {
      "url": "http://localhost:8080/mcp"
    }
  }
}

VS Code​

{
  "servers": {
    "unityMCP": {
      "type": "http",
      "url": "http://localhost:8080/mcp"
    }
  }
}

Stdio（Claude Desktop、またはHTTP非対応クライアント）​

macOS / Linux:

{
  "mcpServers": {
    "unityMCP": {
      "command": "uvx",
      "args": ["--from", "mcpforunityserver", "mcp-for-unity", "--transport", "stdio"]
    }
  }
}

Windows:

{
  "mcpServers": {
    "unityMCP": {
      "command": "C:/Users/YOUR_USERNAME/AppData/Local/Microsoft/WinGet/Links/uvx.exe",
      "args": ["--from", "mcpforunityserver", "mcp-for-unity", "--transport", "stdio"]
    }
  }
}

トラブルシューティング​

  • Unity Bridgeが接続しない — Window → MCP for Unity を開いてstatus panelを確認します。必要ならUnityを再起動します。
  • serverが起動しない — terminalで uv --version が動作するか確認し、MCP for Unityのlogを確認します。
  • クライアントが接続しない — HTTP serverが localhost:8080 で起動していることと、クライアント設定のURLが一致していることを確認します。

Cursor / VS Code / Windsurf / Claude Codeの詳細なトラブルシューティングはGitHub Wikiも参照できます。

解決しない場合はKAFKA2306/unity-mcpのIssueを作成するか、上流コミュニティのDiscordを確認してください。