Skip to content

feat(mcp): add QCC OAuth connector using native on-demand discovery - #305

Draft
duhu2000 wants to merge 4 commits into
OpenBMB:mainfrom
duhu2000:feat/qcc-mcp-connector
Draft

duhu2000 wants to merge 4 commits into
OpenBMB:mainfrom
duhu2000:feat/qcc-mcp-connector

Conversation

@duhu2000

@duhu2000 duhu2000 commented Nov 4, 2026

Copy link
Copy Markdown

目的

增加企查查 MCP OAuth 卡片:一个统一入口发现账号可用的企业/历史数据工具,复用 StaffDeck 原生按需能力发现,无需复制 API Key,也不使用固定五资源接入方案。

依赖通用 OAuth PR #304。 为便于两个功能分别讨论,本 PR 单独提交。由于依赖分支尚未进入上游,当前 GitHub 对 main 的完整 diff 包含 #304;企查查卡片增量只有提交 f9d34cb。请先审核/合并 #304,之后我会同步基线,保持卡片 PR 只含增量。

最终行为

  • 工具页企查查卡片,管理员添加幂等的 qcc_company Server,固定资源 https://agent.qcc.com/mcp/company/stream。
  • 发现同名但不同 URL/transport/headers 的配置时拒绝覆盖;不改已有手动连接和 API Key。
  • 每个用户通过通用 OAuth 入口独立授权;卡片无 API Key 输入框。客户端名称 StaffDeck。
  • 授权后管理员发现/更新目录,再为员工绑定工具。使用已有 MCP 分页发现、工具权限和 Harness 冻结授权快照。
  • 原生 capability_search 搜索、capability_describe 加载所选 schema,再调用具体工具。不会将全部 186 个 schema 一次塞入模型,也没有绕过单工具权限的代理调用。
  • 目录数量动态显示,取决于服务端准入与账号权限,不硬编码 186,不声称 OAuth 自动开放额外数据权限。

验证与限制

  • 组合后端测试 70 passed,包括 OAuth/存储/MCP API/执行/stdio/错误脱敏、卡片和能力按需发现。
  • 卡片 fixture 模拟 186 项目录含历史工具,验证同步、初始模型清单不展开外部工具 schema、历史工具搜索和带个人凭据调用。
  • 前端授权入口/卡片 5 passed;TypeScript/Vite build、i18n:check、config:check、git diff --check 通过。
  • 新增 Python 文件 Ruff 通过,应用可导入,未登录访问 OAuth 状态端点返回 401。
  • 保留 Draft:未完成正式桌面包/浏览器角色 UI 验收、真实短信 OAuth、真实 186 工具或历史数据查询验收。这里的 186 是模拟测试,不是生产验收结果。
  • 通用 OAuth 的 DCR/PKCE、单进程刷新锁、提前 401 需重授权等限制见 feat(mcp): add personal OAuth authorization for remote MCP servers #304 和 MCP_OAUTH.md。

本 PR 不修改生产准入,不包含账号、凭据、原始查询结果或用户截图。请维护者确认原生按需能力路线与卡片位置;之后补真实产品验收并转 Ready。

This branch has not been deployed

No deployments
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant