远程 MCP：让 AI Agent 使用 DStatus

把 DStatus 接到 Codex、Claude 等 AI 后，它可以帮你看节点状态、告警，并在你指定的一台服务器上执行明确的运维命令。

需要 DStatus 2.26.07.010 及以上、管理员账号，以及 Agent 能访问的 HTTPS 实例地址。
授权后的 Agent 拥有完整管理员 MCP 能力——只连接你信任的客户端。

接入方式

1. 管理后台 → 设置中心 → 连接与授权 → 远程 MCP → 启用
2. 点 复制，把提示词发给 AI
3. 在浏览器用管理员账号登录并点 允许

提示词会自动带上你的地址，形如：

请给我安装 DStatus 远程 MCP，先读取这个地址返回的接入说明：https://你的实例域名/mcp

其中的 MCP 地址取自后台配置的站点网址；请先确保它是 Agent 可访问的 HTTPS 地址。

这个 MCP 地址本身会返回完整的机器可读接入说明，AI 不需要另找安装文档。

你只负责：复制 → 发送 → 点允许。其余由 AI 协助完成。

适合不走「复制提示词」、自己在 MCP 客户端里加连接的情况。

1. 启用并复制地址

设置中心 → 连接与授权 → 远程 MCP → 启用，复制：

https://你的实例域名/mcp

2. 认证

默认使用浏览器登录授权（OAuth）：客户端打开浏览器 → 登录 → 点允许；可在同一页撤销，无需手动处理或长期保存密钥。

只有客户端无法完成浏览器授权时，才展开后台的「Token 备用连接」生成专用 Token。

3. 写入客户端

连接类型选 Streamable HTTP，地址用上面的 MCP 地址。

Codex

codex mcp add dstatus --url https://你的实例域名/mcp
codex mcp login dstatus

Claude Code

claude mcp add --scope user --transport http dstatus https://你的实例域名/mcp

首次按客户端提示完成浏览器登录授权。

其他客户端
添加 Streamable HTTP + MCP 地址，并使用客户端提供的浏览器授权流程。

若客户端明确不支持 OAuth，再使用后台「Token 备用连接」提供的 Bearer Token；不要把 Token 写进代码、共享脚本或 Git。

它能做什么 / 不能做什么

能	不能
读节点、告警、通知、分组、运行状态	改 DStatus 配置
对单台节点执行一条非交互命令	交互式 Shell、一次操作多台、浏览文件

长命令会返回执行编号，可继续查状态和输出。与前台公开/私有访问模式无关。

安全要点

1. 只授权信任的 Agent 和设备。
2. 命令会真实打到目标机：先确认节点选对；不要让它打印密码、私钥、Token。
3. 不用时在「远程 MCP」页吊销对应授权或 Token。
4. 若用 Token：一设备/一任务一枚，便于单独撤销。

常见问题

找不到 MCP 地址
先确认已启用，再复制设置页上的地址。远程连接需要 HTTPS 域名。

浏览器已登录，客户端仍未连上
回到发起连接的客户端等它收尾。仍无效：在「远程 MCP」页撤销该授权后重连。

Token 丢了
无法找回。吊销旧的，再生成新的。

终端命令没有马上结束
可能还在排队或运行。让 AI 用返回的执行编号继续查，不要反复提交同一条。