Quickstart

Get up and running in 10 minutes

Install Unity MCP Plugin

Install the Unity MCP plugin into your Unity project using the CLI. Requires Unity 6000.x or later.
npx unity-mcp-cli install-plugin ./MyProject

Open Unity & Verify Plugin

Open your Unity project and verify the plugin is installed. Navigate to Window → AI Game Developer and confirm the panel opens without errors.
npx unity-mcp-cli open ./MyProject

Connect AI Client

Configure your AI client to connect to the Unity MCP server. Choose your client below and add the configuration.
{
  "mcpServers": {
    "unity": {
      "url": "https://ai-game.dev/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_TOKEN"
      }
    }
  }
}
{
  "mcpServers": {
    "unity": {
      "url": "https://ai-game.dev/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_TOKEN"
      }
    }
  }
}

Confirm Tools Working

Ask your AI client to list available MCP tools. You should see Unity-specific tools like scene management, object creation, and component manipulation. If tools appear, your setup is complete!

Common Issues

Tools not appearing in AI client

Cause: MCP server not reachable or wrong URL
Verify the URL is https://ai-game.dev/mcp and check your network connectivity. Ensure the AI client config file is saved and the client has been restarted.

Unity plugin not visible in Window menu

Cause: Plugin not installed correctly or unsupported Unity version
Re-run npx unity-mcp-cli install-plugin ./MyProject and verify Unity is version 6000.x or later. Check the Unity Console for any package import errors.

Connection refused or timeout

Cause: Firewall blocking the connection, VPN interference, or server maintenance
Check your firewall rules allow outbound HTTPS to ai-game.dev. Try disabling VPN temporarily. Verify server status at the homepage.

Authentication error (401 Unauthorized)

Cause: Missing or invalid bearer token in client configuration
Generate a new API token from your ai-game.dev dashboard. Ensure your config includes "Authorization": "Bearer YOUR_TOKEN" in the headers.