> For the complete documentation index, see [llms.txt](https://docs.edgegap.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.edgegap.com/zh/docs/mcp-ji-cheng.md).
# MCP 集成
通过 MCP 服务器将 AI 编码代理连接到 Edgegap，提供用于排查游戏服务器部署问题的工具集。
MCP 服务器为你的自定义编码 AI 代理提供了一个便捷的故障排查工具包。
## 👉 支持的功能
{% hint style="success" %}
**新用户 - 从** [Unity](/zh/unity.md)**,** [Unreal Engine](/zh/unreal-engine.md)**，或** [Godot](/zh/godot.md)**.** 只有在你已将可正常运行的容器化游戏服务器上传到容器注册表后，才建议使用 MCP 服务器。
{% endhint %}
在以下情况下使用我们的 MCP 服务器：
* **将你的游戏服务器容器化** - 你的代理会根据 Edgegap 的要求为你的构建编写 Dockerfile（或检查你现有的 Dockerfile），然后将镜像推送到你的私有 Edgegap 容器注册表。
* **部署专用服务器** - 创建应用和版本，将其部署到靠近玩家的位置，并获取连接详情。
* **构建 CI/CD 流水线** - 在构建系统中测试你的部署和销毁流程。
* **排查游戏服务器问题** 使用你自己的编码代理：检查应用版本和部署状态、读取容器日志，或复现失败的部署。
* **运行主机-客户端游戏** - 如果你的游戏采用一名玩家作为主机的架构，则创建中继会话。参见 [专用服务器还是中继？](https://github.com/edgegap/edgegap-mcp#dedicated-servers-or-relays) 先。
{% hint style="warning" %}
MCP 不在范围内/不支持：构建服务器 Linux 可执行文件；配置匹配；服务器浏览器；大厅；托管集群；私有舰队；中继；或计费。
{% endhint %}
{% hint style="info" %}
如果你需要帮助， [请通过 Discord 联系我们](https://discord.gg/MmJf8fWjnt)。关于实时游戏支持，请查看我们的 [工单系统](https://edgegap.atlassian.net/servicedesk/customer/portal/3).
{% endhint %}
### 示例提示
* *"为我的 three.js 服务器构建编写一个 Dockerfile，然后将其推送并在我附近部署一台服务器。"*
* *"检查我的 Dockerfile 是否符合 Edgegap 要求，并修复任何问题。"*
* *"我的部署失败了。请阅读日志并告诉我原因。"*
* *"我的游戏使用主机-客户端网络。请为两名玩家设置一个 Edgegap 中继。"*
## 🚀 安装
MCP 服务器安装非常简单：
1. 为 [#popular-agents](#popular-agents "mention") 或使用 [#custom-integration](#custom-integration "mention").
2. 生成并附加一个 API 令牌，供你的代理与我们的 MCP 服务器一起使用：
在 Edgegap API 中生成（并查看）你的密钥令牌 [仪表板 - 用户设置 / 令牌](https://app.edgegap.com/user-settings?tab=tokens).
在每次 API 请求中将你的密钥令牌作为 HTTP 头添加（包含单词 `令牌`):
`Authorization: token xxxxxxxx-e458-4592-b607-c2c28afd8b62`
{% hint style="danger" %}
**不要将 Edgegap API 端点集成到游戏客户端中，因为你的 API 令牌可让你无限制地访问你的账户。参见** [集成](/zh/docs/api/ji-cheng.md) **用于安全的面向客户端 API 端点和功能。**
{% endhint %}
{% hint style="success" %}
如果你的密钥令牌被泄露或被盗，请在仪表板中删除并重新创建它们。
{% endhint %}
### 常用代理
在你偏好的智能代理 IDE 中安装 Edgegap MCP 服务器： CursorVS Code
#### Claude Code
```bash
claude mcp add --transport http edgegap https://mcp.edgegap.dev/mcp \
-H "Authorization: token xxxxxxxx-e458-4592-b607-c2c28afd8b62" --scope user
```
#### ChatGPT Codex
```bash
codex mcp add edgegap --url https://mcp.edgegap.dev/mcp
```
#### mcp.json
大多数智能代理 IDE 也支持通过粘贴 JSON 配置进行集成：
{% code title="mcp.json" %}
```json
{
"mcpServers": {
"Edgegap": {
"type": "http",
"url": "https://mcp.edgegap.dev/mcp",
"headers": {
"Authorization": "token xxxxxxxx-e458-4592-b607-c2c28afd8b62"
}
}
}
}
```
{% endcode %}
### 自定义集成
官方仓库是我们 MCP 服务器自定义集成的唯一权威来源：
{% embed url="" %}
在你的代理虚拟化环境中安装远程 Edgegap MCP 服务器（切勿安装到你的项目中！）：
{% code title="使用 npx 包的 node" %}
```json
{
"command": "npx",
"args": ["-y", "mcp-remote", "https://mcp.edgegap.dev/mcp", "--transport", "http-only"]
}
```
{% endcode %}
{% code title="使用 uvx 包的 python" %}
```json
{
"command": "uvx",
"args": ["mcp-proxy", "--transport", "streamablehttp", "https://mcp.edgegap.dev/mcp"]
}
```
{% endcode %}
## 🚨 故障排查
查看常见错误代码，了解如何解除你的集成限制。
### 401 未授权
你的 MCP 集成很可能没有正确包含 Authorization 标头。
### 403 禁止访问
你的 MCP 集成很可能使用了模板令牌或已删除的令牌。请确认你的集成所使用的令牌值与仪表板中显示的令牌完全一致。
### 424 无法拉取镜像
Edgegap 无法拉取你的容器镜像。请检查仓库、镜像名称和标签，并确认该标签已推送（让你的代理列出注册表标签）。对于 Edgegap 注册表中的镜像，镜像名称必须包含你的项目，例如 `my-project/my-game-server`.
### 无法获取注册表凭据
如果你的代理无法检索注册表凭据， [请在仪表板中 **容器注册表**](https://app.edgegap.com/registry-management/repositories/list)，或推送到 Edgegap 可以拉取的其他注册表（Docker Hub、GitHub、AWS ECR、GCP、GitLab）。参见 [外部注册表](https://docs.edgegap.com/docs/tools-and-integrations/docker/external-registries).
### 服务器可在本地启动但在 Edgegap 上不能启动
请让你的代理验证服务器配置，或生成一个新的 Dockerfile。最常见的原因是镜像在 Apple Silicon 上构建时没有使用 `docker build --platform linux/amd64`，服务器监听的端口与版本暴露的端口不同，或者将 UDP 传输配置成了 TCP。
### 其他 API 错误
请查阅我们的 [API 参考](/zh/docs/api.md) 以了解各个 API 端点可能返回的错误响应。
{% hint style="info" %}
如果你需要帮助， [请通过 Discord 联系我们](https://discord.gg/MmJf8fWjnt)。关于实时游戏支持，请查看我们的 [工单系统](https://edgegap.atlassian.net/servicedesk/customer/portal/3).
{% endhint %}