至少输入两个字母,即可搜索文档的所有页面。

↑ ↓ 导航 ↵ 打开 esc 关闭

使用 rdev

连接 AI 助手

将笔记本电脑上的 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 工具一样,助手在批准、拒绝或停止任何内容之前会先询问您。

创建令牌

  1. 在面板中打开设置 > 已连接的应用。
  2. 在连接 AI 助手下,为令牌起一个您日后能认出的名称,例如“我 MacBook 上的 Claude Code”,然后选择创建令牌。
  3. 复制其下方显示的命令或配置。令牌只显示一次;如果丢失,请创建新的。

每个令牌都会连同上次使用时间列在已连接的应用下。断开会立即吊销它。每个助手和每台笔记本电脑使用一个令牌,这样您可以吊销其中一个而不影响其他。

请像对待密码一样对待令牌:任何拥有它的人都可以查看您的服务器并批准部署。不要把它放进会提交到仓库的项目文件中。

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;请创建新令牌并更新客户端的配置。