在 DeepSeek Harness（DSH）的插件生态中，接入企业级数据源（如启信慧眼）通常涉及繁琐的 API Key 配置或服务地址设置。dsh-qixin-insight-mcp-oauth 插件通过 OAuth 2.1 (PKCE) 标准授权流程，将启信慧眼的 MCP 服务端挂载进 Harness，让模型能够直接查询企业工商、股权、司法与风险等智能数据。
核心定位¶
这是一个 DeepSeek Harness 插件，由 qixin-ai-data 维护，分类为“联网工具”。它解决了传统 MCP 接入需要手动配置 API Key 和服务地址的问题，通过浏览器端的一键授权，将启信慧眼的工具挂载进对话。
安装与启用¶
插件已发布在 npm，安装命令如下：
dsh plugin --profile web add dsh-qixin-insight-mcp-oauth
安装完成后，需要重启 dsh 进程才能生效。
典型用法¶
插件通过对话工具进行操作，主要有三个命令：
- 连接服务
对话中输入“连接启信慧眼mcp”。
触发工具qixin_insight_mcp_connect：插件会发起授权，打开浏览器让用户登录，完成后自动挂载 MCP 工具。如果已有有效授权，会直接复用。 - 查看状态
对话中输入“启信慧眼mcp连上了吗”。
触发工具qixin_insight_mcp_status：返回连接状态、受众绑定、Token 过期时间以及已挂载的工具前缀。 - 断开服务
对话中输入“断开启信慧眼mcp”。
触发工具qixin_insight_mcp_disconnect：执行 RFC 7009 吊销 refresh_token，卸载工具并删除本地凭证。
技术细节与注意事项¶
凭证管理¶
- 无需配置文件存储：插件不将 API Key 或 Token 写入
cordis.yml等配置文件。 - 存储位置：凭证存储于 DSH 凭证服务（
ctx.credentials），保证了跨进程写入的安全性和互斥性。 - 自动刷新：Token 过期前会自动刷新，重启宿主后自动恢复连接。
- 吊销支持：断开时支持 RFC 7009 吊销 refresh_token。
环境要求¶
- Node.js 版本：要求
^22.19.0 || >=24.0.0。
已知限制¶
- 无 UI 设置页：仅通过对话工具操作，没有图形化的设置页面。
- 卸载清理：卸载插件后，必须先执行断开命令（
qixin_insight_mcp_disconnect），否则 DSH 凭证服务中仍会保留 grant 记录，refresh_token 依然有效。 - 工具抖动：Token 过期轮换时，会有一次
tools/list往返的短暂工具抖动。 - 单端点限制：一个插件条目对应一个 MCP 端点。
总结¶
该插件利用 OAuth 2.1 和 PKCE 标准简化了企业数据源的接入流程，将凭证管理交由 DSH 凭证服务统一处理，适合需要在 DSH 环境中安全、便捷地调用启信慧眼数据的场景。
