# Frequently Asked Questions

Answers to the most common questions about installing AI Game Developer, authenticating with the MCP endpoint, supported Unity versions and render pipelines, traffic statistics, and the privacy/local-first data model.

_Last updated: 2026-06-17_

## Installation

### How do I install the Unity MCP plugin?

The Unity MCP plugin is installed via the Unity Package Manager using a Git URL (or, more simply, the unity-mcp-cli). Open Unity 2021.3 LTS or later, go to Window > Package Manager, click + → Add package from git URL, paste the Unity-MCP package URL, and click Add. See the Quickstart guide for the full walkthrough.

### My AI client cannot connect to Unity. What should I do?

- Ensure the Unity Editor is running and the MCP plugin is active (check the MCP status indicator in the Unity toolbar).
- Verify your AI client configuration points to the correct MCP endpoint URL.
- Check that no firewall or proxy is blocking the configured port.
- Restart both Unity and your AI client, then try again.

### Which operating systems are supported for installation?

The Unity MCP plugin works on Windows, macOS, and Linux — anywhere Unity Editor runs. The remote MCP endpoint at ai-game.dev/mcp is platform-independent since AI clients connect over HTTP.

## Authentication

### How do I get an authentication token?

Authentication tokens are created through the remote MCP endpoint admin API. The raw bearer token is shown exactly once at creation — copy and store it immediately, it cannot be retrieved later.

### My authentication token is not working. What should I check?

- Expired or revoked token — tokens can be revoked by an administrator; request a new one.
- Missing Bearer prefix — ensure your config includes the full "Bearer <token>" format in the Authorization header.
- Wrong endpoint — verify you are connecting to the correct remote MCP endpoint URL, not a local server.

### Do I need authentication for local development?

No. When running the MCP server locally (via the Unity plugin's built-in server), authentication is disabled by default. Tokens are only required when connecting through the remote endpoint at ai-game.dev/mcp, where MCP_AUTHORIZATION is set to required.

## Unity Versions

### What is the minimum Unity version required?

The Unity MCP plugin requires Unity 2021.3 LTS or later. We recommend the latest LTS release for the best compatibility and stability. Older versions may lack required .NET APIs.

### Which render pipelines are supported?

All Unity render pipelines: Built-in (default), Universal Render Pipeline (URP), and High Definition Render Pipeline (HDRP). The MCP integration operates at the editor level and does not interact with rendering.

## Traffic Stats

### What does "tool calls" mean on the Dashboard?

A tool call is a single MCP operation executed by an AI client through the server — for example, reading a scene hierarchy, modifying a GameObject, or querying project assets. Each discrete operation counts as one tool call.

### What does "active sessions" mean?

An active session represents a live connection between an AI client and the MCP server. A session starts when a client connects and ends when it disconnects or times out.

## Privacy

### What data does the MCP server collect?

The remote MCP endpoint logs minimal operational data: request timestamps and tool call types (for traffic stats), authentication token usage (for access control), and connection metadata (session count, duration). No Unity project content (scenes, scripts, assets) is stored on the remote server.

### Is my Unity project code sent to remote servers?

No. The architecture is local-first. In local mode the MCP server runs inside your Unity Editor and all communication is on localhost. In remote mode the endpoint acts as a relay that forwards MCP protocol messages without inspecting, storing, or logging payload content — only metadata.

### How long is operational data retained?

Operational metadata (request logs, session records) is retained for diagnostic and traffic-reporting purposes. No project content is ever stored. Token records persist until explicitly revoked by an administrator.

---

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