# MCP 端点 — AI Game Developer

通过 ai-game.dev 把任意 MCP 客户端连接到 Unity、Unreal Engine 或 Godot：端点 URL、OAuth 登录、项目密钥、令牌，以及 Claude、Cursor、Copilot、Gemini 等客户端的配置。

本页由英文机器翻译而成。[阅读英文原文](https://ai-game.dev/mcp-endpoint-info)。

MCP 端点

把任意兼容 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 的配置，改为通过浏览器登录。桌面应用在设置项目时也是同样的做法。

```bash
# 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](https://ai-game.dev/zh-hans/engines/unreal) · [Unity](https://ai-game.dev/zh-hans/engines/unity) · [Godot](https://ai-game.dev/zh-hans/engines/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。更多内容见[身份验证指南](https://ai-game.dev/docs/auth)。

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

如果要在 CI 中使用，或客户端无法打开浏览器，可在[访问令牌页面](https://ai-game.dev/app/api-keys)创建个人访问令牌，并作为 bearer 令牌发送。

## 一个请求长什么样

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

```bash
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": {}
  }'
```

`Authorization` `Bearer YOUR_PERSONAL_ACCESS_TOKEN` 个人访问令牌或项目密钥；OAuth 客户端发送自己的令牌

`Accept` `application/json, text/event-stream` 两种类型都要：响应可能以流式返回

`Content-Type` `application/json` JSON-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。

14

```text
Settings → Connectors → Add custom connector
Name: ai-game-dev
URL:  https://ai-game.dev/mcp
```

[↗ 打开 Claude Desktop](https://claude.ai/download)

**端点已上线。** [/api/status](https://ai-game.dev/api/status) 会报告该端点当前的运行状态。

---

Source (HTML): https://ai-game.dev/zh-hans/mcp-endpoint-info

Machine-translated (zh-Hans) from the English page: https://ai-game.dev/mcp-endpoint-info