본문으로 건너뛰기
T

dsh-dots (dsh-dot-mcp)

tests4gptplay/dsh-dots/packages/dsh-dot-mcp

Connect your ChatGPT Dot to DeepSeek Harness with 17 MCP tools for direct native API, plugin and tool execution, visible workspace conversations, Secure MCP Tunnel management, event notifications, and Dots web access with Desktop login persistence.

설치

dsh plugin --profile web add github:tests4gptplay/dsh-dots

이 플러그인은 저장소의 packages/dsh-dot-mcp 하위 디렉터리에 있습니다.

README

DSH Dot MCP 1.0.1

在 DSH 里使用 Dot,让 Dot 调用 DSH 完成工作。

English · 完整配置指南 · 2.0.0 更新记录与实机展示 · 问题反馈

独立 MCP 版 1.0.1: Dot 与 DSH 通过 MCP 协作,包含完整工具调用、Secure MCP Tunnel、主动通知和原生工作区操作;与简洁版 Dots 使用不同的插件安装身份。

Dot MCP 1.0.1 正式发行说明 · 原 2.0.0 实机说明

DSH Dot MCP 将 ChatGPT Dots 带入 DeepSeek Harness。你可以在 DSH 内与自己的 Dot 对话,也可以开启 MCP,让 Dot 使用 DSH 的 AI 会话、工具和工作区,提交任务并取回结果。

Dot MCP 提供的功能

这一版从网页入口扩展到 Dot 与 DSH 之间的双向协作:在 DSH 中使用 Dot,同时让 Dot 调用这台电脑上的 DSH。

新能力可以怎样使用
MCP 连接将 DSH 注册为 Dot 可用的工具服务,在对话中下达任务。
会话与任务管理创建或继续会话、查看结果和取消执行;MCP 创建的会话进入对应工作区,命令和回复在普通会话中完整显示。
工作区与工具Dot 优先直接使用已启用的 DSH 原生 API、插件和工具,完成文件、命令和图片等操作。
同页设置在「设置 → Dot MCP」管理 MCP 开关、连接地址、调用状态和登录保持。
完整接入引导复制实际连接信息、检查本地服务,并通过官方指南完成注册和首次调用。

MCP 默认关闭,按需开启。 开关状态和连接设置随当前 DSH 配置保存,重启后继续生效。关闭 MCP 会结束外部接入;已经交给 DSH 的任务继续执行,取消任务则使用单独的取消操作。

原有体验继续保留:启动预加载、切换面板时保留页面、明暗主题适配、中英文界面、刷新、外部浏览器打开,以及 Desktop 登录保持的检查、应用和恢复。顶部增加网页后退按钮,点击 Dots 图标与名称可返回 Dot 首页。

安装 DSH Dot MCP 1.0.1

在 DSH「插件 → 添加插件」中输入固定发行版本:

github:Tests4gptplay/dsh-dots#dsh-dot-mcp-v1.0.1

本版 npm 包为 dsh-dot-mcp@1.0.1,GitHub Release 附带 dsh-dot-mcp-1.0.1.tgz。简洁版 Dots 保留在 1.0.12 分支,可输入 github:Tests4gptplay/dsh-dots#1.0.12 安装。

安装与连接步骤见下方 完整配置指南,设置页底部也提供可折叠的五步引导。

安装后,从侧栏打开 Dot,在 ChatGPT 官方页面登录。登录保持与 MCP 均在 DSH → 设置 → Dot MCP 中管理。

本版采用统一的 Dots 设置页设计,完整连接指南位于三块设置区域下方,隧道启停选择会在 DSH 重启后恢复。详细画面与验证见本版更新记录。

选择性主动通知 Dot

在 DSH → 设置 → Dot MCP → 主动通知 Dot 中,可以独立打开或关闭主动通知。首次安装默认关闭;先选定允许通知的 Session ID(每行一个),再勾选“会话轮次结束”或“会话执行错误”并保存。Dot 按 OpenAI MCP Events 官方流程 对选定会话建立订阅后,DSH 才通过已验证的官方 Webhook 回调发送对应状态事件。关闭开关会撤销当前订阅;不在允许列表中的会话不会触发通知。

主动事件只携带会话 ID 与事件状态。需要读取任务成果时,Dot 继续使用原有 MCP 工具。MCP 工具连接和主动通知使用独立开关;主动通知不改变 17 个现有工具的能力。

请求内的 DSH 原生事件流

dsh_api_subscribe 在 MCP 工具调用期间,使用 notifications/progress 连续传递 DSH 原生事件;支持该通知的 MCP 客户端可用 progressToken 接收,取消请求就会释放订阅。dsh_api_snapshot 继续提供单次快照。

ChatGPT Dot 的主动事件触发采用官方 MCP Events 的 Webhook 协议(events/list、events/subscribe、events/unsubscribe)。两种通道用途不同;本版提供请求内事件流,不把它标作 Dot 的后台事件订阅。

本轮修复: 关闭 MCP 时即使官方隧道进程停止报错,仍会保存 MCP 关闭状态并显示实际错误。下载新版隧道客户端后,设置页会提示“待切换”;用户点击「启动隧道」时,停止旧进程并启动新客户端。

连接自己的 Dot

  1. 开启 MCP。 在「设置 → Dot MCP」打开 MCP,点击「检查本地连接」。
  2. 创建官方 Tunnel。 打开页面中的 Tunnel 设置。名称填 DSH-Dots,描述填 Connect ChatGPT Dot to DeepSeek Harness,选择自己的组织与工作区。本指南的个人连接方式保持 Restrict client network access 未勾选;有组织网络策略时按管理员配置。创建后复制完整 Tunnel ID,并在 Runtime API Keys 准备运行密钥。
  3. 在插件里完成本地连接。 在 OpenAI Secure MCP Tunnel 区域确认默认安装目录,或选择自己的位置;点击 下载并安装官方客户端。已有客户端可直接填写可执行文件完整路径。填入 Tunnel ID 与 Runtime API Key,点击 启动隧道,再点击 刷新隧道状态。本地 MCP 地址自动填入官方客户端配置,无需复制命令或保持 PowerShell 窗口。安装位置和 Tunnel ID 会保存;运行密钥保存在当前 DSH 用户配置目录的独立权限受限文件中,用于自动恢复隧道。

客户端更新: 每次点击下载,都会从 OpenAI 官方 GitHub Releases 查询最新发行版、核对 SHA-256 后安装。插件内不包含隧道客户端二进制;安装目录只保留当前版本及一份上一版。若上一版仍在运行,会在停止后清理更早的版本。 4. 在 ChatGPT 注册和安装。 网页版 Plugins → + / Add → Add custom MCP server,Connection 选择 Tunnel 并填写完整 Tunnel ID,Authentication 选择 No authentication;确认官方提示后点击 Create as a plugin,在个人 Plugins 中安装。然后到 Dot 的 Customize → Plugins 启用连接。 5. 做一次实际调用。 让 Dot 调用 dsh_status 并列出会话;返回 DSH 点击「刷新状态」,核对最近一次工具调用。

使用已有 HTTPS 转发时,可直接填写上方转发地址并在 ChatGPT 选择 Server URL,无须运行隧道。MCP 完整地址中带有访问密钥;截图或反馈日志时隐藏该地址。

本版更新与验证 · 官方隧道指南 · 官方 MCP 注册指南

日常使用

连接完成后,可以让 Dot「在指定工作区读取数据,整理成报告并保存」,也可以在同一会话中追加要求、查看执行结果或取消任务。可用工具由这台 DSH 的配置决定。

在 DSH 内嵌页面或手机 ChatGPT 中使用 Dot,都可以通过已配置的远程连接访问同一台 DSH;远程使用时,保持电脑上的 DSH 和隧道或 HTTPS 服务运行。

更新与反馈

实机截图、原生环境验证和两轮文件任务实验,集中在 2.0.0 更新记录。其他版本见 更新记录索引。

遇到问题可在 Issues 提交 DSH 版本、系统和错误提示;连接密钥请从截图与日志中移除。

支持项目

感谢支持 DSH Dots 的开发与维护。捐赠与赞助 · GitHub Sponsors · Ko-fi · 支付宝

관련 플러그인