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

↑ ↓ 导航 ↵ 打开 esc 关闭

使用 rdev

MCP 工具

您服务器上的每个智能体都通过 MCP(Model Context Protocol)连接到 rdev,这是 AI 智能体使用工具的标准方式。因此智能体不只是写代码:它会设置代码所需的一切,检查能否运行,并修复出问题的地方,无需让您打开终端或面板。

为何重要

  • 智能体会把工作做完。 写完一个队列任务后,它会添加队列工作进程;功能需要 Redis 或数据库时,它会安装并连接;composer 要求某个 PHP 扩展时,它会安装该扩展。您得到的是能用的功能,而不是一份需要手动执行的步骤清单。
  • 它基于事实调试,而不是靠猜。 智能体会读取 Laravel 日志的末尾、最近的错误、工作进程的输出以及应用发出的邮件,然后修复根本原因。
  • 有风险的更改可以撤销。 智能体会在大的更改之前创建检查点,并且可以恢复它。
  • 每个智能体都获得同样的工具。 Claude Code、Codex、opencode、Qwen Code、GitHub Copilot CLI、Gemini CLI、Cursor CLI 和 Antigravity CLI 都获得相同的 MCP 工具和相同的规则,因此您可以切换智能体而无需重新设置任何东西。
  • 数据不会离开您的服务器。 MCP 服务器在您的环境内运行,直接与智能体通信。您的代码、日志和数据永远不会发送到 rdev.cloud。
  • 控制权在您手中。 与任何 MCP 工具一样,Claude Code 会在首次使用某个工具前询问您。如果您的许可证到期,添加项目或站点、安装新版本的工具会被拒绝;其他一切照常工作。

智能体能做什么

领域 工具 作用
项目 rdev_project_add, rdev_project_service 添加项目(空项目、来自 Git 仓库或来自配方),并为其提供 MySQL、PostgreSQL、Redis、Meilisearch 或 S3 存储等服务,同时填好 .env
站点 create_site, link_site, list_sites, set_site_secure, add_domain, add_proxy 创建和链接 .dev.test 站点,开启 HTTPS,添加域名以及到开发服务器的代理
PHP list_php, install_php, set_site_php, set_default_php, install_php_extension, set_php_setting 安装 PHP 版本,为每个站点选择版本,添加 mongodb 等扩展,更改 php.ini 设置
其他语言 rdev_node_*, rdev_lang_*, rdev_system_install 安装 Node.js、Python、Ruby、Go、.NET、Java 或 Flutter 版本,为每个项目选择版本,安装库所需的系统软件包
数据库和服务 create_database, list_databases, list_services 创建数据库并查看哪些服务正在运行
进程和计划 rdev_jobs, rdev_process, rdev_cron, rdev_job_logs 添加、更改、重启和移除队列工作进程、Horizon、Reverb 和计划任务,并读取它们的输出
日志和邮件 rdev_app_log, list_mails, get_mail, list_dumps 读取应用日志的末尾或最近的错误、应用发出的邮件以及 dump() 输出
错误 rdev_errors 从本地错误跟踪读取项目的未解决错误
检查点 rdev_checkpoint 列出、创建和恢复项目的检查点
预览 rdev_preview 在您要求时,将站点以受密码保护的临时预览形式分享
健康状况 rdev_backup_status, rdev_license_status, diagnose, status 检查夜间备份、许可证和环境

rdev_app_log 返回项目应用日志的末尾;加上 last_error 则只返回最后一个错误及其堆栈跟踪。Laravel 开箱即用(storage/logs 中最新的文件)。它还会读取 Symfony 的 var/log/dev.log、WordPress 的 wp-content/debug.log(在 wp-config.php 中开启 WP_DEBUG 和 WP_DEBUG_LOG;文件不存在时工具会告诉你怎么做)以及 Rails 的 log/development.log。对于由 rdev 运行开发服务器的项目(Node.js、Python、Ruby、Go、.NET、Java 等),它读取开发服务器的输出,last_error 能识别 Python traceback、JavaScript、Java、.NET 和 Ruby 的堆栈跟踪以及 Go 的 panic。命令行中同样可用:rdev project logs <name> --app 或 --last-error。 在 tailnet 中的浏览器里,https://rdev-logs.dev.test 会为每个项目显示同样的内容,并在有新行时刷新。

进程和计划任务和检查点在各自的页面中有说明。

示例

用平常的话提出要求,智能体会自己选择工具:

  • “添加一个通过队列发送欢迎邮件的新闻订阅功能。”智能体编写代码,添加队列工作进程,发送一次测试订阅,并读取捕获到的邮件。
  • “结账页面返回 500,修好它。”智能体读取日志中最近的错误,修复后再次检查页面。
  • “新建一个名为 shop 的 Laravel 项目,使用 PostgreSQL 和 Redis。”智能体添加项目、服务和站点。
  • “把这个给客户看看。”智能体创建预览链接,并告诉您地址和密码。

设置

无需设置。安装程序和 rdev agents install 会为其安装的每个智能体注册 rdev 的 MCP 服务器(rdev mcp)。您自行安装的智能体也可以使用它:在其设置中将 rdev mcp 添加为本地(stdio)MCP 服务器,并让它指向 AGENTS.md。

面板的 MCP 服务器

还有第二个独立的 MCP 服务器,位于 https://rdev.cloud/mcp,供您笔记本电脑上的 AI 助手使用。它不在某个环境内工作,而是展示您所有服务器上的账户情况(健康状况、智能体会话、失败的任务、等待批准的部署)。请参阅连接 AI 助手。