MCP 智能体

MCP 让 Codex、Claude Code 或 Antigravity CLI 能够使用 DR-Terminal 的工具。智能体可以查看会话和已保存的连接、打开连接、读取终端输出、键入命令、传输文件，以及在应用内导航。MCP 模式在有效试用期内和 Pro 版中可用。

将 DR-Terminal 添加到智能体

  1. 点击 DR-Terminal 标题栏中的 MCP。
  2. 选择 Add to Codex、Add to Claude 或 Add to Antigravity。这会创建一个用户级的 dr-terminal 条目，用于运行已安装 DR-Terminal 自带的桥接程序；客户端配置中不会存储任何令牌或端点。Antigravity 2.0、Antigravity IDE 和 agy 共用 ~/.gemini/config/mcp_config.json 中的同一条目。
  3. 选择打开，或以正常方式打开客户端。第一次连接会将 DR-Terminal 窗口置于前台，并请你选择 Allow 或拒绝。
  4. 允许连接后，粘贴第一条提示词并发送。
显示我当前活动的 DR-Terminal 会话。

所选 CLI 必须已安装且可在 PATH 中找到。仅支持从已安装的 DR-Terminal 软件包进行安装；从 Gradle 或 IDE 启动的开发运行会刻意不创建持久条目。Remove 只删除确认归 DR-Terminal 所有的条目，并会要求确认。已存在的其他 dr-terminal 条目会被报告为冲突，绝不会被覆盖。

实用提示词

当打开了多个会话时，请指明会话名称或标识符。如果智能体报告不存在任何会话，请在 DR-Terminal 中打开一个连接，或先让智能体列出已保存的连接。

批准与指示

读取会话元数据和终端输出通常不会打断你的工作。键入文本、按键、传输文件和断开连接等敏感操作需要你的批准。

需要批准时，MCP 标识会脉动闪烁，确认对话框会获得键盘焦点。检查目标会话和要发送的内容，然后选择允许一次、本会话内允许或拒绝。操作执行期间，受影响的会话标签页会显示静态的 MCP 标记；标识的颜色反映 MCP 的全局状态。

智能体绝不会收到 DR-Terminal 保存的密码或私钥。针对某个会话的批准仅在当前 MCP 服务器运行期间有效。

本地连接安全

MCP 服务器只在回环接口上监听，因此不会暴露到网络。每个请求仍需一个 bearer 令牌，该令牌存放在仅所有者可访问的本地文件中。标题栏的弹出面板绝不会显示或复制该令牌。

端点仅在端点和最近操作下显示，用于诊断。不要分享令牌文件，也不要把它的内容复制到提示词、聊天消息、日志或屏幕截图中。

停止 MCP

在 MCP 弹出面板中选择停止，即可拒绝所有待处理的批准请求、停止接受工具调用，并关闭由当前 MCP 运行启动的客户端。再次启动 MCP 会创建一次全新的运行；先前的会话批准不会沿用。

点击 MCP 徽标只会打开弹出面板，绝不会隐式启动服务器。手动运行请使用明确的 Start MCP 操作；已注册的客户端也可以通过可见的连接批准流程启动它。

故障排除

未找到 CLI

安装所选的 Codex、Claude Code 或 Antigravity CLI（agy），并确保其可执行文件可在 PATH 中找到。更改 shell 环境后重启 DR-Terminal，然后选择重新检查。

端口已被占用

另一个进程正在使用所配置的 MCP 端口。停止该进程，或在设置 → MCP 模式下选择其他端口，然后重新启动 MCP。

没有活动会话

请先打开一个 SSH、Telnet、串口或本地终端会话。你也可以让智能体显示已保存的连接，并在你批准该操作后打开其中一个。

客户端在运行但 MCP 未确认

CLI 进程已启动，但 DR-Terminal 尚未收到任何 MCP 工具调用。请在新终端标签页中检查登录、配置或握手错误，然后重新发送示例提示词。正在运行描述的是本地进程，而不是已确认的 MCP 连接。

有批准对话框在等待

回到 DR-Terminal，查看获得焦点的对话框。在你允许或拒绝之前，智能体无法继续该敏感操作。停止 MCP 会拒绝待处理的请求。

Previous
Telnet