MCP 集成
MCP 服务器为你的自定义编码 AI 代理提供了一个便捷的故障排查工具包。
👉 支持的功能
在以下情况下使用我们的 MCP 服务器：
将你的游戏服务器容器化 - 你的代理会根据 Edgegap 的要求为你的构建编写 Dockerfile（或检查你现有的 Dockerfile），然后将镜像推送到你的私有 Edgegap 容器注册表。
部署专用服务器 - 创建应用和版本，将其部署到靠近玩家的位置，并获取连接详情。
构建 CI/CD 流水线 - 在构建系统中测试你的部署和销毁流程。
排查游戏服务器问题 使用你自己的编码代理：检查应用版本和部署状态、读取容器日志，或复现失败的部署。
运行主机-客户端游戏 - 如果你的游戏采用一名玩家作为主机的架构，则创建中继会话。参见 专用服务器还是中继？ 先。
示例提示
"为我的 three.js 服务器构建编写一个 Dockerfile，然后将其推送并在我附近部署一台服务器。"
"检查我的 Dockerfile 是否符合 Edgegap 要求，并修复任何问题。"
"我的部署失败了。请阅读日志并告诉我原因。"
"我的游戏使用主机-客户端网络。请为两名玩家设置一个 Edgegap 中继。"
🚀 安装
MCP 服务器安装非常简单：
生成并附加一个 API 令牌，供你的代理与我们的 MCP 服务器一起使用：
在 Edgegap API 中生成（并查看）你的密钥令牌 仪表板 - 用户设置 / 令牌.
在每次 API 请求中将你的密钥令牌作为 HTTP 头添加（包含单词 令牌):
Authorization: token xxxxxxxx-e458-4592-b607-c2c28afd8b62
常用代理
在你偏好的智能代理 IDE 中安装 Edgegap MCP 服务器：
Claude Code
ChatGPT Codex
mcp.json
大多数智能代理 IDE 也支持通过粘贴 JSON 配置进行集成：
自定义集成
官方仓库是我们 MCP 服务器自定义集成的唯一权威来源：
在你的代理虚拟化环境中安装远程 Edgegap MCP 服务器（切勿安装到你的项目中！）：
🚨 故障排查
查看常见错误代码，了解如何解除你的集成限制。
401 未授权
你的 MCP 集成很可能没有正确包含 Authorization 标头。
403 禁止访问
你的 MCP 集成很可能使用了模板令牌或已删除的令牌。请确认你的集成所使用的令牌值与仪表板中显示的令牌完全一致。
424 无法拉取镜像
Edgegap 无法拉取你的容器镜像。请检查仓库、镜像名称和标签，并确认该标签已推送（让你的代理列出注册表标签）。对于 Edgegap 注册表中的镜像，镜像名称必须包含你的项目，例如 my-project/my-game-server.
无法获取注册表凭据
如果你的代理无法检索注册表凭据， 请在仪表板中 容器注册表，或推送到 Edgegap 可以拉取的其他注册表（Docker Hub、GitHub、AWS ECR、GCP、GitLab）。参见 外部注册表.
服务器可在本地启动但在 Edgegap 上不能启动
请让你的代理验证服务器配置，或生成一个新的 Dockerfile。最常见的原因是镜像在 Apple Silicon 上构建时没有使用 docker build --platform linux/amd64，服务器监听的端口与版本暴露的端口不同，或者将 UDP 传输配置成了 TCP。
其他 API 错误
请查阅我们的 API 参考 以了解各个 API 端点可能返回的错误响应。
最后更新于
这有帮助吗？