Skip to content
Agentmart
Submit a tool

How to connect Unity to Claude Code

Unity MCP, published by IvanMurzak, is a local server that Claude Code starts through Docker. The listing names no API key. This guide checks Docker, registers the server by command or a project .mcp.json, and confirms the connection, based on the listing's install data and Claude Code's documentation.

Updated Oct 26, 2026 · Built from catalog data; how we rank and grade

Checked against Claude Code's documentation on Oct 26, 2026. Commands and config blocks are generated from the same install data as each listing page.

Before you start

  • Claude Code installed and able to start.
  • Docker (the server starts with docker).
  • No API key is listed for Unity MCP.

  1. 1. Check what you need

    Docker is the launcher for Unity MCP, so it has to be installed before Claude Code can start the server.

    Check that it is installed
    docker --version
    • The listing names no required key.

  2. 2. Add Unity MCP to Claude Code

    Claude Code stores a docker run command and runs it when needed. The command form is personal and the file form is shared with the project.

    Add it for you in every project
    claude mcp add --transport stdio --scope user unity-mcp -- docker run -i --rm -e UNITY_MCP_PORT -e UNITY_MCP_PLUGIN_TIMEOUT -e UNITY_MCP_CLIENT_TRANSPORT docker.io/ivanmurzakdev/unity-mcp-server:0.17.1
    Or share it with the project: put this in .mcp.json at the project root.mcp.json
    {
  "mcpServers": {
    "unity-mcp": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "UNITY_MCP_PORT",
        "-e",
        "UNITY_MCP_PLUGIN_TIMEOUT",
        "-e",
        "UNITY_MCP_CLIENT_TRANSPORT",
        "docker.io/ivanmurzakdev/unity-mcp-server:0.17.1"
      ]
    }
  }
}

  3. 3. Restart or reload if it does not appear

    If Unity MCP is not listed, see the notes for reconnecting and for approving project servers.

    • The docs do not say a restart is needed after claude mcp add. Servers connect at startup and can be reconnected from the /mcp menu.
    • In an interactive session Claude Code asks you to approve servers from a project .mcp.json before it uses them; claude mcp reset-project-choices resets those answers.

Check that it works

Check for Unity MCP in the server list. The listing has no tool count, so its status is what to read.

claude mcp list
  • Run claude mcp list from the shell, or /mcp inside a session. The list shows each server as Connected, Needs authentication, Failed to connect, or Pending approval.

Troubleshooting

Error: MCP server has a "url" but no "type"
Add "type": "http" (or sse) to the entry in the JSON file. Source
MCP server already exists in local config
Remove it from the other scope first with claude mcp remove <name> --scope <scope>, then add it again. Source
A ${VAR} in the config stays literal
The variable is unset. Export it before starting Claude Code or give it a default with ${VAR:-default}; claude mcp list shows a warning. Source
Server shows disconnected in a session
Open /mcp and reconnect it. Source

Reported by other users

Issues in the server's repository (IvanMurzak/Unity-MCP) about installing or starting it, as of Oct 26, 2026. They are links, not fixes: open one to see whether it was resolved.

Security notes

  • Publisher: IvanMurzak, not listed as the vendor's own server; license Apache-2.0.
  • It runs on your machine with your user account's permissions, so it can reach any file or network resource you can. Read its source before you give it access: https://github.com/IvanMurzak/Unity-MCP.
  • The listing declares no required keys; use a token with the narrowest scope if the service asks for one.
  • This listing has no security grade: Agent Market has not published security grades yet, so the choice is yours to make from the source and the permissions.

How we grade security · Trust policy

Servers and skills in this guide

Other Unity servers, comparisons and the general Claude Code guide are linked.

  1. 1
    Unity MCP

    IvanMurzak

    Make 3D games in Unity Engine with AI.

    ★ 4.5KLast active Oct 24, 2026Local (stdio)Claude Code, Codex, VS Code, Cursor +2

Related

Sources

Cite this page

How to connect Unity to Claude Code. Agent Mart. https://agentmart.dev/guides/connect-unity-to-claude-code (last updated 2026-10-26)