1. 为什么要在 Unity 里接 MCPMCP 全称 Model Context Protocol是 Anthropic 提出的模型上下文协议你可以把它理解成「AI 和外部工具之间的一套标准插座」。Unity 官方基于这套协议做了 MCP for Unity 插件包装上之后AI 助手就能直接读取场景层级、创建 GameObject、挂组件、改 Inspector 参数、建预制体甚至播放暂停游戏。适合谁适合每天在 Unity 里重复拖拽、手动挂脚本、反复调 Tag 和 Layer 的开发者尤其是已经在用 Claude Code 命令行版的人。传统流程里你想让场景里多一个带 Rigidbody 的立方体得手动右键创建、改名字、拖组件、设质量。MCP for Unity 把这些动作变成一句自然语言描述AI 通过 MCP 工具调用直接落到编辑器里。它内置了 24 种功能覆盖 GameObject 操作、组件管理、场景编辑、脚本创建、资源导入、编辑器控制等。本文以 Claude Code 为例从零走一遍配置链路Unity 端装包、本地 Python 环境、MCP 服务端配置、Claude Code 侧 settings.json、启动验证、报错排查。照着做完你就能在 Claude Code 里用 指令操控 Unity 编辑器。需要提前说明的是MCP for Unity 不是替代 Unity 编辑器它是给编辑器加了一层「AI 可调用的遥控器」。你的项目文件、编译、运行仍然在 Unity 里AI 只是帮你把重复操作自动化。理解这一点后面配置时就不会期待它去改引擎底层。2. 前置准备TaoToken 与本地环境Claude Code 要跑起来需要一个能访问模型 API 的入口。我这边用的是 TaoToken官网在 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content API 地址是 https://taotoken.net/api 。它的作用是给 Claude Code 这类命令行工具提供模型调用能力你不需要在本地折腾模型权重配好 Key 就能用。先去控制台建一个 API Key地址是 https://taotoken.net/console?utm_sourcetaotoken_aicg_blog_endutm_contentconsoleutm_campaignrewrite 。建好之后复制出来后面写进 Claude Code 的配置里。如果你还没决定用哪种接入方式可以先看接入文档 https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_contentdocutm_campaignrewrite 里面把不同客户端的配置方式列得比较清楚。本地环境这边需要两样东西Unity 项目2021.3 LTS 以上比较稳以及 Python 环境。MCP for Unity 的服务端是 Python 写的官方推荐用 uv 来管理uv 是 Rust 写的包管理器装依赖比 pip 快很多。Windows 下可以用 PowerShell 装 uvmacOS 用 brew 或官方脚本。装完 uv 后uv --version能输出版本号就说明好了。另外确认一下你的 Unity 项目能正常打开、能编译。MCP for Unity 会往项目里写脚本和资源如果项目本身有编译错误AI 操作时容易卡住。建议先在一个干净的小项目里试通再往主力项目上搬。3. 可复制配置Unity 端 MCP 服务端3.1 Unity 端装 MCP for Unity 包打开 Unity进 Window Package Manager左上角切换到 Unity Registry搜索 MCP for Unity。找到官方包后点 Install。装完在菜单栏会出现 MCP 相关入口通常在 Tools 或 Window 下。打开 MCP 设置面板你会看到两个关键参数协议类型HTTP / STDIO和端口号。HTTP 模式默认监听本地某个端口STDIO 模式则是通过标准输入输出和客户端通信。Claude Code 命令行版两种都支持我这边用 HTTP 模式配置直观、排查方便。在 MCP 设置面板里记下端口比如 8080 或它自动分配的端口。同时确认「Enable MCP Server」是勾选状态。如果面板里有「Start Server」按钮先点一下让 Unity 端处于监听状态。这一步做完Unity 就已经是一个可以被 MCP 客户端连接的服务端了。3.2 用 uv 拉起 MCP 服务端MCP for Unity 的服务端代码在包目录里你需要用 uv 把它跑起来。先进入包目录路径类似Packages/com.unity.mcp/Server具体以你安装的版本为准。然后执行cd Packages/com.unity.mcp/Server uv sync uv run server.pyuv sync会根据 pyproject.toml 把依赖装好uv run server.py启动服务。启动成功后终端会打印监听地址和协议信息。如果你用的是 STDIO 模式这一步不需要手动跑Claude Code 会自己拉起进程HTTP 模式则需要保持这个终端窗口开着。注意如果你在 Unity 里改了端口这里启动的服务端也要对应改配置两边端口必须一致否则连不上。3.3 Claude Code 侧 settings.json 片段Claude Code 的 MCP 配置写在 settings.json 里。文件位置一般在用户目录下的.claude/settings.json或者项目根目录的.claude/settings.json。用编辑器打开加入 mcpServers 段{ mcpServers: { unity: { type: http, url: http://127.0.0.1:8080/mcp } } }如果你用 STDIO 模式改成这样{ mcpServers: { unity: { command: uv, args: [ --directory, Packages/com.unity.mcp/Server, run, server.py ] } } }同时Claude Code 本身要能访问模型 API所以在同一个 settings.json 或环境变量里配置 TaoToken 的接入信息。API 地址用 https://taotoken.net/api Key 用你在控制台建的那个。具体字段名以接入文档为准不同版本可能略有差异。配好后保存重启 Claude Code。4. 验证请求与成功结果重启 Claude Code 后先确认 MCP 服务被识别。在对话里输入/mcp或类似命令不同版本命令可能不同应该能看到 unity 这个 server 处于 connected 状态。如果显示 failed先回到第 5 节排查。接着做一次最小验证在 Claude Code 里输入unity 读取当前场景的层级结构。如果配置正确AI 会调用 MCP 工具返回场景里所有 GameObject 的树状列表。这一步成功说明链路通了。再试一个写操作unity 创建一个名为 TestCube 的 GameObject位置在 (0,1,0)并挂上 Rigidbody 组件。执行后切回 Unity 编辑器场景里应该出现一个立方体Inspector 里有 Rigidbody。如果 AI 还自动生成了对应的 C# 代码说明自动代码生成也生效了。实测下来读取操作几乎秒回写操作会稍慢一点因为要等 Unity 编辑器响应。如果 Unity 处于播放模式部分操作可能被限制建议在编辑模式下做结构修改。5. 本篇常见错排查连接被拒绝Claude Code 报 connection refused先看 Unity 端 MCP Server 是否启动、端口是否一致。HTTP 模式下浏览器访问http://127.0.0.1:8080/mcp看有没有响应。没有的话回 Unity 面板点 Start Server。uv 命令找不到终端提示 uv: command not found说明 uv 没装好或没进 PATH。重新装一遍或者用绝对路径调用。依赖装不上uv sync卡住或报错多半是网络问题。可以换源或者检查 Python 版本是否符合要求。MCP for Unity 一般要求 Python 3.10 以上。Claude Code 看不到 unity serversettings.json 格式错了比如多了逗号、少了引号。用 JSON 校验工具过一遍。另外确认文件位置对用户级和项目级配置别放混。AI 操作后 Unity 没反应切到 Unity 看 Console 有没有报错。常见的是脚本编译失败导致 MCP 工具调用被阻塞。先把编译错误清掉再试。权限问题某些操作比如构建发布需要额外权限AI 调用时可能被 Unity 拦截。这类操作建议手动做或者看 MCP 文档里有没有对应开关。6. 接下来怎么用链路通了之后你可以把日常重复操作逐步交给 AI。比如批量给场景里的物体设置 Tag 和 Layer或者按命名规则创建一组预制体。Claude Code 里用 指令调用 MCP 工具描述清楚需求就行。如果你打算长期在编码和 Agent 场景里用可以了解下 Coding Plan https://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_contentcoding-planutm_campaignrewrite 它更适合高频调用。想先试试模型对话效果可以走模型对话入口 https://taotoken.net/chat?utm_sourcetaotoken_aicg_blog_endutm_contentchatutm_campaignrewrite 。Key 的管理和新建在 API Keys 页面 https://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_contentapi-keysutm_campaignrewrite 接入细节看文档 https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_contentdocutm_campaignrewrite 。Claude Code 相关的配置说明在 https://taotoken.net/claude-code?utm_sourcetaotoken_aicg_blog_endutm_contentclaudecodeutm_campaignrewrite Anthropic 接入参考 https://taotoken.net/anthropic?utm_sourcetaotoken_aicg_blog_endutm_contentanthropicutm_campaignrewrite 。我自己的习惯是先把场景搭建类的重复活交给 AI脚本逻辑还是自己写这样既省时间又不失控。你可以从一个小场景开始跑通之后再扩大范围。