1. Home
  2. MCP for Unity
  3. MCP for Unity for Windsurf: Setup & Config

Data as of

MCP for Unity for Windsurf: Setup & Config

MCP for Unity links Windsurf to the Unity Editor for scene work, asset management, script editing, testing, and builds.

What you can do with MCP for Unity in Windsurf

Connect AI-assisted coding with direct Unity scene, asset, testing, and build operations.

  • Edit C# scripts while working with Unity Editor state.
  • Run tests, profile a project, and initiate builds.

Before you start: MCP for Unity in Windsurf

  • Unity 2021.3 LTS through 6.x
  • Python 3.10 or later via uv
  • An MCP-compatible client
  • OpenUPM when using this installation command

This command installs the Unity package, not a standalone MCP launch process. Alternatively, add https://github.com/CoplayDev/unity-mcp.git?path=/MCPForUnity#main in Package Manager, then use Window > MCP for Unity > Configure All Detected Clients. Individual tool names and a standalone server launch command are not stated in the README.

MCP for Unity Windsurf configuration

  1. Choose Windsurf configuration scope

    For MCP for Unity, open macOS/Linux: ~/.codeium/windsurf/mcp_config.json Windows: %USERPROFILE%\.codeium\windsurf\mcp_config.json. Merge into mcpServers; remote endpoints use serverUrl.

  2. Add MCP for Unity to Windsurf

    Use the unity-mcp entry below in mcpServers. Keep MCP for Unity's documented stdio connection fields and your other Windsurf entries.

  3. Check MCP for Unity in Windsurf

    MCP for Unity: Refresh MCP in Windsurf settings and inspect Cascade’s tools.

Config file · macOS/Linux: ~/.codeium/windsurf/mcp_config.json

Windows: %USERPROFILE%\.codeium\windsurf\mcp_config.json

JSON
{
  "mcpServers": {
    "unity-mcp": {
      "command": "openupm",
      "args": [
        "add",
        "com.coplaydev.unity-mcp"
      ],
      "env": {}
    }
  }
}

Troubleshooting MCP for Unity in Windsurf

  • MCP for Unity's openupm add command installs a Unity package. Follow the upstream editor setup before expecting a stdio connection in Windsurf.
  • Check openupm on the machine running Windsurf's MCP integration for MCP for Unity; refresh MCP and inspect Cascade's tools.
  • Known limitation: Requires a supported Unity installation and Python through uv.
  • Known limitation: Individual tool identifiers are not stated in the supplied README.
  • Known limitation: Advanced routing and remote authentication require separate documentation.
  • General Windsurf troubleshooting lives in the /clients/windsurf guide.

MCP for Unity — details. Windsurf guide

Frequently asked questions

Windsurf reads MCP for Unity under mcpServers in ~/.codeium/windsurf/mcp_config.json on macOS/Linux; Windows uses %USERPROFILE%\.codeium\windsurf\mcp_config.json.

Windsurf's unity-mcp example uses stdio.

MCP for Unity's Windsurf configuration invokes openupm. MCP for Unity's openupm add command installs a Unity package. Follow the upstream editor setup before expecting a stdio connection in Windsurf.

No. The README describes compatibility with any MCP client and names Claude, Codex, VS Code, local LLMs, and others.

No. The project describes itself as an independent, open-source Unity Editor tool licensed under MIT.