将笔记本电脑上的 AI 助手(例如 Claude Code、Claude Desktop、Cursor 或 Codex)连接到您的 rdev 面板。之后它可以回答诸如“我的服务器有问题吗?”“上一个任务为什么失败?”或“哪个智能体在等我?”之类的问题,并在您要求时处理部署或智能体会话。
这是面板自带的 MCP 服务器,地址为 https://rdev.cloud/mcp。它与您的智能体在服务器本身上拥有的 MCP 访问是分开的(参见 AI 智能体):后者管理环境内的站点、数据库和服务,而这个展示的是您所有服务器上的账户情况。
助手能做什么
| 工具 | 功能 |
|---|---|
list_servers |
您的服务器,包括在线状态、rdev 版本、项目、CPU、内存和磁盘使用情况,以及警报(离线、需要重启、安全更新、磁盘几乎已满、服务失败) |
server_details |
一台服务器的服务、PHP 和 Node.js 版本、进程、计划任务及其上次退出码,以及备份存储位置 |
agent_sessions |
最近的智能体会话及其状态:工作中、等待您处理、已完成或因错误停止 |
recent_tasks |
面板发送到您服务器的最近任务及其结果;可以只列出失败的任务 |
deploy_requests |
您拥有或管理的团队中等待审批的团队部署 |
approve_deploy、reject_deploy |
对等待中的部署做出决定,规则与团队页面相同:仅限所有者和管理员,且须在请求后一小时内 |
stop_agent_session |
停止正在运行的智能体会话,与智能体会话页面的操作相同 |
助手只能看到您在面板中可以更改的服务器:您自己的服务器,以及在 Team 套餐中,您拥有或管理的团队的主环境。它永远不会获得许可证密钥、环境变量值、加密密码或令牌。与任何会更改内容的 MCP 工具一样,助手在批准、拒绝或停止任何内容之前会先询问您。
创建令牌
- 在面板中打开设置 > 已连接的应用。
- 在连接 AI 助手下,为令牌起一个您日后能认出的名称,例如“我 MacBook 上的 Claude Code”,然后选择创建令牌。
- 复制其下方显示的命令或配置。令牌只显示一次;如果丢失,请创建新的。
每个令牌都会连同上次使用时间列在已连接的应用下。断开会立即吊销它。每个助手和每台笔记本电脑使用一个令牌,这样您可以吊销其中一个而不影响其他。
请像对待密码一样对待令牌:任何拥有它的人都可以查看您的服务器并批准部署。不要把它放进会提交到仓库的项目文件中。
Claude Code
在笔记本电脑的终端中运行面板中的命令:
claude mcp add --transport http --scope user rdev https://rdev.cloud/mcp --header "Authorization: Bearer <token>"
--scope user 使该服务器在每个项目中都可用。可使用 claude mcp list 或在 Claude Code 中使用 /mcp 检查连接。
Cursor 和其他 MCP 客户端
大多数客户端读取相同的 JSON。在 Cursor 中,将其添加到 ~/.cursor/mcp.json(所有项目)或项目中的 .cursor/mcp.json:
{
"mcpServers": {
"rdev": {
"type": "http",
"url": "https://rdev.cloud/mcp",
"headers": {
"Authorization": "Bearer <token>"
}
}
}
}
该服务器使用 MCP 的 Streamable HTTP 传输,并通过 Authorization: Bearer 标头进行认证,因此任何支持带自定义标头的远程服务器的客户端都可以使用。
Codex
将令牌放入环境变量,例如在 shell 配置文件中写入 export RDEV_MCP_TOKEN=<token>,然后将以下内容添加到 ~/.codex/config.toml:
[mcp_servers.rdev]
url = "https://rdev.cloud/mcp"
bearer_token_env_var = "RDEV_MCP_TOKEN"
Claude Desktop
Claude Desktop 的自定义连接器使用 OAuth 登录,而面板暂不提供。请改为通过 mcp-remote 桥接连接(需要笔记本电脑上安装 Node.js)。在设置 > 开发者 > 编辑配置中添加:
{
"mcpServers": {
"rdev": {
"command": "npx",
"args": ["-y", "mcp-remote", "https://rdev.cloud/mcp", "--header", "Authorization: Bearer ${RDEV_MCP_TOKEN}"],
"env": { "RDEV_MCP_TOKEN": "<token>" }
}
}
}
然后重启 Claude Desktop。
限制
一个助手每分钟最多可发出 120 个请求;一个问题通常只需几个。已吊销或输入错误的令牌会收到 401 Unauthorized;请创建新令牌并更新客户端的配置。