# 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-hant/engines/unreal) · [Unity](https://ai-game.dev/zh-hant/engines/unity) · [Godot](https://ai-game.dev/zh-hant/engines/godot)

## 登入

### OAuth 2.1——瀏覽器登入，無需貼上任何內容

支援 MCP 授權的用戶端會在首次連線時透過瀏覽器登入（授權碼搭配 PKCE 與動態用戶端註冊），之後會保有自己的權杖。設定中只會包含 URL。各引擎 CLI 內建的 `login` 指令則改用裝置碼流程：它會印出一組代碼，讓你在瀏覽器核准。

### 專案金鑰——setup-mcp 寫入的內容

專案金鑰（`agd_pk_…`）屬於單一專案，會搭配綁定的 URL 以 Bearer 權杖傳送。`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-hant/mcp-endpoint-info

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