MCP 服务器 URL
https://serverprism.com/api/mcp
传输方式:Streamable HTTP。登录方式:OAuth 2.1,你的应用会在浏览器中打开 ServerPrism,由你批准。脚本也可以改为发送 Authorization: Bearer YOUR_TOKEN,令牌来自你的 API 凭据。
你可以这样问
像和一位帮你打理服务器的朋友聊天一样和助手说话。它会选择合适的工具并把它们串起来使用。
- “我的 Minecraft 服务器在线吗?它现在用了多少内存?”
- “创建一个名为 before-update 的备份,等它完成后再重启服务器。”
- “把 Steve 和 Alex 加入我生存服务器的白名单,并通知所有在线玩家。”
- “我的服务器老是崩溃。检查它的状态,并附上详情提交一个支持工单。”
- “我的服务器里哪些本周续费?每个要多少钱?”
- “每周五 18:00,在我所有服务器的聊天里公布活动。”
像周五公告这样的定时任务,需要能按计划运行的助手(例如在定时任务中运行的 Claude Code 或 Codex)。服务器只会执行你的助手提出的请求。
2 分钟完成设置
把服务器 URL 添加到你的助手,在它提示时登录 ServerPrism 并批准即可。无需复制令牌。你需要一个已验证邮箱的 ServerPrism 账户。
将 Claude 连接到 ServerPrism
- 在 claude.ai 或 Claude Desktop 中,打开 Customize,然后打开 Connectors。
- 点击 Add,然后点击 Add custom connector。
- 将其命名为 ServerPrism,并粘贴服务器 URL:https://serverprism.com/api/mcp
- 保留建议的登录设置,点击 Add,然后点击 Connect。
- 登录 ServerPrism 并点击 Approve。
自定义连接器适用于所有 Claude 套餐(Free 套餐允许一个)。在 Team 和 Enterprise 中,需要先由 owner 在 Organization settings 下添加该连接器。
将 ChatGPT 连接到 ServerPrism
- 在 ChatGPT 的设置中开启 Developer mode。Plus、Pro、Business、Enterprise 和 Edu 套餐都可使用。
- 创建一个新应用(连接器),并粘贴服务器 URL:https://serverprism.com/api/mcp
- 选择 OAuth 作为认证方式,然后登录 ServerPrism 并点击 Approve。
- 在新对话中,从 + 菜单开启 ServerPrism 应用。
OpenAI 会不时调整这些菜单的位置。如果找不到,请在 ChatGPT 帮助中搜索 "developer mode"。
将 Claude Code 连接到 ServerPrism
- 在终端中运行一次以下命令:
然后启动 claude,输入 /mcp,选择 serverprism 并登录。添加 --scope user 可让它在所有项目中可用。
claude mcp add --transport http serverprism https://serverprism.com/api/mcp
将 Cursor 连接到 ServerPrism
- 将以下内容添加到 ~/.cursor/mcp.json(或项目中的 .cursor/mcp.json):
打开 Settings,然后打开 MCP,点击 serverprism 旁边的 Connect 登录。在 Agent 模式下提问。
{
"mcpServers": {
"serverprism": {
"url": "https://serverprism.com/api/mcp"
}
}
}
将 VS Code 连接到 ServerPrism
- 将以下内容添加到 .vscode/mcp.json:
点击服务器上方的 Start,并在 VS Code 提示时登录。ServerPrism 工具随后会出现在 Copilot Chat 的 Agent 模式中。
{
"servers": {
"serverprism": {
"type": "http",
"url": "https://serverprism.com/api/mcp"
}
}
}
将 Gemini CLI 连接到 ServerPrism
- 将以下内容添加到 ~/.gemini/settings.json:
在 Gemini CLI 中运行 /mcp auth serverprism 登录,然后运行 /mcp 检查工具是否已连接。
{
"mcpServers": {
"serverprism": {
"httpUrl": "https://serverprism.com/api/mcp"
}
}
}
将 API 令牌 连接到 ServerPrism
- 对于脚本和不支持登录的客户端,请在 Account 下的 API Credentials 中创建令牌。只想让 AI 查看?只选择 servers:read。
- 把它作为 bearer 令牌发送。例如在 Codex CLI 中,把以下内容添加到 ~/.codex/config.toml,并在 shell 中导出 SERVERPRISM_TOKEN:
其他任何客户端:将其指向服务器 URL,作为远程 HTTP 服务器,并带上请求头 Authorization: Bearer YOUR_TOKEN。
[mcp_servers.serverprism]
url = "https://serverprism.com/api/mcp"
bearer_token_env_var = "SERVERPRISM_TOKEN"
使用其他客户端?把 https://serverprism.com/api/mcp 添加为远程 HTTP 服务器。如果它支持 OAuth,会打开登录页面;否则请使用 API 令牌标签页。
你的助手可用的工具
你的助手只能看到被授权使用的工具。通过登录连接的应用可使用全部工具;API 令牌只能使用其 scope 允许的工具。每个工具的功能与对应的 REST API 接口完全一致,限制也相同。
服务器
| 工具 | 功能 | Scope |
|---|---|---|
list_servers |
列出此 ServerPrism 账户下的游戏服务器(运行中和已暂停),包含 ID、名称、游戏、版本和续费日期。从这里开始查找服务器 ID。 | servers:read |
get_server |
单个游戏服务器的详情:连接地址、端口、套餐限制和实时状态(运行/离线、内存、CPU、磁盘、运行时间)。 | servers:read |
send_power_signal |
向游戏服务器发送电源信号。"start" 启动,"stop" 正常关闭,"restart" 两者都做,"kill" 不保存直接强制终止(最后手段)。Stop、restart 和 kill 会让所有正在游戏的玩家掉线,所以请先向用户确认。 | servers:control |
send_console_command |
在运行中服务器的控制台执行一条命令,与在面板控制台中输入完全一样(Minecraft 例如:"say Restarting in 5 minutes"、"whitelist add Steve"、"time set day";无需前导斜杠)。仅限一行。输出显示在服务器控制台中;此工具只确认命令已发送。 | servers:control |
备份
| 工具 | 功能 | Scope |
|---|---|---|
list_backups |
列出服务器的备份(名称、状态、大小、日期)以及账户的备份名额。备份名额由账户下所有服务器共用。 | servers:read |
create_backup |
为服务器创建新备份(占用一个备份名额)。备份在后台运行:反复调用 list_backups,直到状态为 "completed"。建议在更新、切换版本或大幅修改之前执行。 | backups:create |
账单与账户
| 工具 | 功能 | Scope |
|---|---|---|
get_account |
账户的名称、邮箱地址和创建日期。 | account:read |
list_services |
账户下的所有服务及其账单详情:价格、币种、计费周期、状态、下次续费日期以及任何待处理的取消。 | billing:read |
list_invoices |
账户的账单,最新的在前,包含总额、币种和支付状态。 | billing:read |
get_invoice |
一张账单及其明细项目和付款记录。 | billing:read |
支持
| 工具 | 功能 | Scope |
|---|---|---|
list_tickets |
账户的支持工单,最近更新的在前。 | tickets:read |
get_ticket |
一个支持工单及其完整对话。 | tickets:read |
open_ticket |
向 ServerPrism 团队提交一个新的支持工单。会由真人或我们的支持助手回复,客户会收到邮件。仅在用户要求联系支持时才提交。问题与某台服务器有关时请附上 server_id。 | tickets:write |
reply_to_ticket |
为账户下已有的支持工单添加一条回复。 | tickets:write |
一切由你掌控
每个应用都由你批准
应用必须在你登录并批准后才能接入,你也可以随时断开它。只需要只读权限?请使用只包含所需 scope 的 API 令牌。
只能访问你自己的服务器
已连接的应用或令牌只能访问你自己账户下的服务器。你作为子用户在他人服务器上的权限不包含在内。
高风险操作需要确认
Stop、restart、kill 和控制台命令都被标记为破坏性操作,因此支持该功能的助手会在执行前先询问你。
不能删除,不能付款
AI 不能删除服务器、文件或备份,不能取消服务,也不能支付账单。它所做的每项更改都会连同执行更改的应用或令牌一起记录。
关于 MCP 服务器的常见问题
什么是 MCP 服务器?
MCP(Model Context Protocol)是一种开放标准,让 AI 助手可以使用其他服务提供的工具。我们的 MCP 服务器为 Claude、Cursor 和 GitHub Copilot 等助手提供一套针对你 ServerPrism 账户的安全工具,你只需用日常语言提问,就能管理游戏服务器,不必在面板里一路点击。
哪些 AI 助手可以使用?
任何支持远程(Streamable HTTP)服务器的 MCP 客户端:Claude(claude.ai 和 Claude Desktop)、开发者模式下的 ChatGPT、Claude Code、Cursor、搭配 GitHub Copilot 的 VS Code、Gemini CLI、Codex CLI、Windsurf 等。其中大多数通过浏览器登录,无需复制任何内容。不支持登录的客户端可以改用 API 令牌。
需要额外付费吗?
不需要。MCP 服务器包含在每个 ServerPrism 套餐中,和我们的 REST API 一样。你只需为自己的 AI 助手付费(如果它是付费的)。
支持哪些游戏?
全部支持。电源、状态和备份适用于我们托管的每台服务器:Minecraft Java 版和基岩版、FiveM、Rust、Palworld、ARK、Valheim、Terraria、Discord 机器人等。控制台命令取决于该游戏的控制台接受什么。
让 AI 控制我的服务器安全吗?
一切由你掌控。应用必须在你登录 ServerPrism 并批准后才能接入,你也可以随时在 API Credentials 中断开它。停止服务器或执行命令的工具都被标记为破坏性操作,因此好的客户端会在使用前询问你。AI 只能访问你自己的服务器,它所做的每项更改都会被记录。想要只读权限?请使用只包含 "servers:read" 的 API 令牌。
AI 能删除我的服务器、文件或备份吗?
不能。MCP 服务器被有意设计为不能删除服务器、文件或备份,不能取消或升级服务,也不能付款。这些操作都保留在面板中,你可以在确认前清楚看到将会发生什么。
AI 能读取我的控制台输出吗?
目前还不能。它可以发送命令,并查看状态、内存、CPU 和运行时间,但控制台日志暂时仍只在面板中提供。
我需要 API 令牌吗?
通常不需要。Claude、ChatGPT、Claude Code、Cursor、VS Code 和 Gemini CLI 都通过浏览器登录:你登录 ServerPrism,查看应用的权限,然后点击 Approve。只有脚本和无法登录的客户端才需要令牌。请在 Account 下的 API Credentials 中创建,并立即复制:我们只显示一次。
如何断开 AI 应用?
打开 Account,然后打开 API Credentials。你批准过的每个应用都列在 Connected AI apps 下,旁边有 Disconnect 按钮,点击后它会立刻失去访问权限。令牌也在同一页面撤销。
面向开发者
服务器通过 Streamable HTTP 提供 MCP(协议版本最高到 2025-11-25),且无状态:每次向 https://serverprism.com/api/mcp 发送的 POST 携带一条 JSON-RPC 消息,并返回一个 JSON 响应。没有 SSE 流,也没有会话 ID。 工具结果包含 structuredContent,失败时会以带有 isError: true 和机器可读的 error 代码的工具结果返回,方便模型自行纠正。
登录遵循 MCP 授权规范:服务器返回的 401 会指向 https://serverprism.com/.well-known/oauth-protected-resource/api/mcp,授权服务器元数据位于 https://serverprism.com/.well-known/oauth-authorization-server,客户端通过 dynamic client registration 或 client ID metadata document 注册。 仅支持带 PKCE(S256)的 authorization code。 访问令牌有效期为一小时,可刷新长达 90 天,并且只能用于 MCP 服务器,不能用于 REST API。
工具调用与 REST API 共用 API 速率限制。更喜欢用普通 HTTP 编写自己的脚本?REST API 文档 涵盖了相同的操作。
curl https://serverprism.com/api/mcp \
-H "Authorization: Bearer YOUR_TOKEN" \
-H "Content-Type: application/json" \
-d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"list_servers","arguments":{}}}'
选一个游戏,2 分钟内服务器就绪。
MCP 服务器可以立即配合使用。