# Quickstart

The Quickstart walks you from zero to your first AI-driven action inside Unity in about five minutes: install the Unity MCP plugin via the CLI, open Unity and verify the plugin, connect your AI client, and confirm the tools are working.

_Last updated: 2026-06-17_

## 1. Install Unity MCP Plugin

Install the Unity MCP plugin into your Unity project using the CLI. Requires Unity 6000.x or later.

```bash
npx unity-mcp-cli install-plugin ./MyProject
```

## 2. 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.

```bash
npx unity-mcp-cli open ./MyProject
```

## 3. Connect AI Client

Configure your AI client to connect to the Unity MCP server. Add the configuration below for Claude Desktop or Cursor.

```json
{
  "mcpServers": {
    "unity": {
      "url": "https://ai-game.dev/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_TOKEN"
      }
    }
  }
}
```

## 4. 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 — MCP server not reachable or wrong URL. Verify the URL is https://ai-game.dev/mcp, check connectivity, save the config, and restart the client.
- Unity plugin not visible in Window menu — plugin not installed correctly or unsupported Unity version. Re-run `npx unity-mcp-cli install-plugin ./MyProject` and verify Unity is 6000.x or later.
- Connection refused or timeout — firewall, VPN, or maintenance. Allow outbound HTTPS to ai-game.dev, try disabling VPN, verify server status.
- Authentication error (401 Unauthorized) — missing or invalid bearer token. Generate a new API token and ensure the Authorization: Bearer YOUR_TOKEN header is present.

---

Source (HTML): https://ai-game.dev/docs/quickstart