保存你的 SSH 连接，
直接在远程机器上运行 AI 代理

我的 AI 代理如何访问我的 SSH 连接？

通过 AgentsRoom MCP。你保存的连接会以五个 MCP 工具的形式提供给每个代理：ssh_list 返回当前项目中可用的服务器（SSH、AWS SSM 和 WinRM 一视同仁），ssh_exec 在服务器上运行一条命令并返回输出（在 WinRM 主机上是一行 PowerShell，除非你允许写入，否则为只读；写入可以逐条确认、仅在有风险时确认或从不确认，由你选择），ssh_transfer 把一个文件传到服务器或从服务器取回，ssh_connect 把服务器作为真正的终端标签页打开，ssh_connection_new 则提议一台你尚未保存的服务器。所以当你对代理说“连到 prod 读一下日志”或“列出 Exchange 的发送连接器”时，它不必猜主机名，也不必手写命令：它会读取你的连接列表，在正确的机器上工作。

这种 SSH 访问刻意不涉及任何密钥信息。ssh_list 只返回元数据：名称、主机、端口、用户、认证方式和作用域。密码与私钥口令始终加密保存在系统钥匙串里，私钥留在你的磁盘上，注入终端的动作由应用本身完成。代理只是指名一个连接，从不接触凭据。

代理用 ssh_connect 打开的会话是可见的终端标签页：你可以查看、输入，随时关闭。它用 ssh_exec 执行的命令会连同退出码回到它的对话里，所以你始终看得到执行了什么、机器回了什么。文件的传递方式也一样：代理用 ssh_transfer 从服务器取回一份数据库转储或日志，或者把文件推送到服务器，走的是同一条无凭据通道，拿到的是你机器上的一个路径，而不是被粘贴进对话里的文件内容。连接既可以只保存在某个项目里，也可以保存为全局，让代理只看到有意义的服务器。命令行只能在已打开的会话中使用的网络设备也同样支持，例如 WatchGuard 防火墙以及许多交换机和路由器：ssh_exec 会打开会话，等待设备提示符出现，然后逐条输入命令。

代理在服务器上工作时，你可以实时看着它。它用 ssh_exec 执行的每条命令都会连同输出一起出现在右侧面板的“活动”标签页中，每台服务器一份日志；代理的头像会显示在“服务器”按钮上，并带着“代理工作中”徽章显示在你的服务器列表中。以编码形式发送的命令会以解码后的形式显示。你也可以在手机上跟进，就在移动应用的代理卡片里。这些内容只在你的电脑和手机之间传输，端到端加密，机密信息会被遮蔽：你的机器上运行的任何内容都不会保存在服务器上。

创建也可以完全交给代理。ssh_connection_new 保留经过审核的路径：它打开创建表单，并用代理在 compose 文件、部署脚本或你的文档里找到的信息预先填好，而审核、输入凭据、保存的人是你。除非你关闭“代理可以管理连接”（设置，默认开启），ssh_connection_save 会把连接直接写入，而即便到那时，凭据也不会经过对话：代理只说出密钥库中某个机密的名称，由桌面端复制值。这个关闭开关写在设置里，而不是在提示词里请求来的，因为一个代理能背着你注册的连接就是一个后门。