本页由英文机器翻译而成。阅读英文原文。

MCP 端点

一个 URL,连接所有 AI 客户端

把任意兼容 MCP 的 AI 客户端指向 https://ai-game.dev/mcp,它就能连上你正打开的游戏引擎——Unity、Unreal Engine 或 Godot。工具、提示词和资源在客户端连接时自动协商,无需复制任何结构定义。

端点 URL
https://ai-game.dev/mcp
传输方式
Streamable HTTP
登录
OAuth 2.1 授权项目密钥访问令牌
协议
MCP · JSON-RPC 2.0

最快的方式:让 setup-mcp 帮你写好

每个引擎 CLI 都会为你的客户端写入正确的配置文件:项目专属 URL 加项目密钥,客户端立刻就能连上,无需任何登录。加上 --oauth 则生成只含 URL 的配置,改为通过浏览器登录。桌面应用在设置项目时也是同样的做法。

# Unity — writes the pinned URL + a project key for Claude Code
unity-mcp-cli setup-mcp claude-code ./MyUnityProject

# Unreal Engine (the project path is a flag)
unreal-mcp-cli setup-mcp cursor --path ./MyUnrealProject

# Godot, URL-only config that signs in over OAuth
godot-cli setup-mcp gemini ./MyGodotProject --oauth

安装指南,内含每个客户端的确切命令: Unreal Engine · Unity · Godot

登录

OAuth 2.1 —— 浏览器登录,无需粘贴任何内容

支持 MCP 授权的客户端会在首次连接时通过浏览器登录(授权码 + PKCE 与动态客户端注册),之后各自保存令牌。配置里只有 URL。引擎 CLI 自带的 login 命令则使用设备码流程:它打印一个验证码,你在浏览器中确认即可。

项目密钥 —— setup-mcp 写入的就是它

项目密钥(agd_pk_…)属于单个项目,作为 bearer 令牌随固定 URL 一起发送。setup-mcp 会创建它并写入客户端配置,客户端因此无需浏览器登录即可使用。从账户中移除项目后,该密钥随即失效。

/mcp 或 /mcp/p/<pin>

https://ai-game.dev/mcp 是基础端点:服务器会路由到你已连接的某个编辑器。https://ai-game.dev/mcp/p/<pin> 固定到单个项目,始终连到该项目的编辑器,即使同时打开了多个项目。setup-mcp 写入的是固定 URL。更多内容见身份验证指南。

个人访问令牌 —— 用于 CI 和脚本

如果要在 CI 中使用,或客户端无法打开浏览器,可在访问令牌页面创建个人访问令牌,并作为 bearer 令牌发送。

一个请求长什么样

每个请求都是通过 Streamable HTTP 传输的 JSON-RPC 2.0 消息。较大或渐进式的响应会以 Server-Sent Events 流式返回,所以 Accept 中要同时写入这两种内容类型。下面这条 curl 用访问令牌列出你所连接编辑器的工具:

curl -N -X POST "https://ai-game.dev/mcp" \
  -H "Authorization: Bearer YOUR_PERSONAL_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "tools/list",
    "params": {}
  }'
AuthorizationBearer YOUR_PERSONAL_ACCESS_TOKEN个人访问令牌或项目密钥;OAuth 客户端发送自己的令牌
Acceptapplication/json, text/event-stream两种类型都要:响应可能以流式返回
Content-Typeapplication/jsonJSON-RPC 请求体
method"initialize" | "tools/list" | "tools/call" | …标准 MCP 方法

你的客户端配置

选择你的客户端并复制对应配置。第一个标签页通过 OAuth 登录;访问令牌标签页用于 CI。凡是支持 MCP 的都能用——这里共列出 14 个客户端。

下面所有 URL 都是基础地址 https://ai-game.dev/mcp。要把客户端固定到某个项目,请使用 https://ai-game.dev/mcp/p/<pin> —— setup-mcp 会为你写入固定 URL。

Settings → Connectors → Add custom connector
Name: ai-game-dev
URL:  https://ai-game.dev/mcp
端点已上线。 /api/status 会报告该端点当前的运行状态。