文档

快速开始 + 每部分每设备的功能说明(持续更新中)

MCP / AI 接入

SSH Everywhere 内置了标准的 MCP(Model Context Protocol) 接口,让你的 AI 助手(WorkBuddy / Claude / Cursor 等)能用自然语言帮你管理名下所有服务器。

> 一句话理解:MCP 是 AI 调用外部工具的「USB 接口」。SSH Everywhere 通过 MCP 把自己变成「AI 操作服务器的手」——你只对 AI 说人话,AI 通过 SSH Everywhere 去操作服务器,全程不碰密码、不碰命令行。

---

工作原理

你(自然语言) → AI Agent → SSH Everywhere(跳板 · 凭据托管) → 服务器群
  • 服务器密码只存在面板里,AI 助手只拿到一个 Token,接触不到密码。
  • 你名下所有服务器(云主机、内网设备、安卓机),AI 都能通过 SSH Everywhere 这个跳板统一操作。

---

三步接入

第 1 步:安装面板

安装脚本会自动装好 MCP 服务,无需额外配置:

curl -fsSL https://ssheverywhere.com/install.sh | bash

第 2 步:复制接入地址

登录面板,点开始菜单里的「🤖 MCP / AI 接入」,就能看到:

  • 接入地址(含令牌的完整 URL)
  • 接入令牌(Token)
  • 各 AI 助手的现成配置

一键复制即可,不用手填、不用问任何人。

第 3 步:粘贴到 AI 助手

把地址粘贴到 WorkBuddy(或其他支持 MCP 的 AI 助手),保存。看到绿色连接成功标识,就完成了。

---

6 大运维工具

接入后,AI 助手能帮你做这些:

工具做什么
list_servers列出所有服务器
run_command在服务器上执行命令
list_files列目录
read_file读文件内容
write_file写 / 修改文件
get_system_info查看 CPU / 内存 / 磁盘

---

使用示例

配置好后,直接对 AI 助手说人话:

  • 「帮我看看我有几台服务器」
  • 「在博客服务器上跑一下 df -h」
  • 「读一下生产服务器的 nginx 配置」
  • 「看看 NAT 那台设备的 /var/log 下有什么」

AI 助手会自动调用对应的工具,替你到目标服务器上执行,把结果整理成人话告诉你。

---

各 AI 助手配置

WorkBuddy(腾讯)

侧边栏 → 插件 → MCP 服务器 → 配置 MCP,选 HTTP 类型,粘贴面板上复制的接入地址,保存即可。

Claude Desktop

编辑 claude_desktop_config.json,粘贴面板上复制的配置:

{
  "mcpServers": {
    "ssh-everywhere": {
      "type": "http",
      "url": "http://<面板上复制的地址>"
    }
  }
}

Cursor

Settings → MCP → Add new MCP server,选 HTTP 类型,粘贴接入地址。

其他 AI 助手

任何实现了 MCP(Streamable HTTP)的工具都能接入,方法类似:添加一个 HTTP 类型的 MCP 服务器,填面板上复制的地址即可。

---

安全说明

  • 凭据托管:服务器密码只存在面板里,AI 助手只拿 Token,从头到尾接触不到密码。
  • 双层 Token:Agent → MCP 用「MCP 令牌」,MCP → 面板用「API 令牌」,两层隔离。
  • 令牌等同管理权限:请勿把接入地址 / 令牌泄露出去,也不要截图外传。