在 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 環境中安全、便捷地調用啓信慧眼數據的場景。