[建议 / Feature] 插件远程 MCP 服务器静默连接失败:无授权入口、无状态展示、无错误提示
Nobody has claimed this yet.
- Dominant language
- No language data
- Stars
- 22
- Forks
- 1
- PR merge metrics
- No merged PRs in 30d
Description
提交前确认 · Pre-submission checklist
- 我已搜索过现有 issue,确认这不是重复提议 / I searched existing issues and confirmed this isn't a duplicate.
- 我已阅读 CONTRIBUTING.md / I've read CONTRIBUTING.md.
问题类别 · Category
工具调用 / MCP · Tool use / MCP
涉及的 Agent 框架 · Agent framework
ZCode Agent(自研)
使用场景 · Use case
通过插件市场安装了带远程 MCP 服务器的插件(Canva、Figma、Vercel、Cloudflare、Expo、Context7、GitHub)。插件显示"已启用",其技能(skills)能正常加载进会话,但 .mcp.json 中定义的远程 MCP 服务器工具从未出现在会话中,核心能力完全不可用。
例如:@Canva 让 AI 做一张海报,Canva 的技能都能调,但模板搜索、自动填充这些 MCP 工具一个都没有,最终只能绕过 Canva 本地完成。这类远程 MCP(mcp.canva.com、mcp.figma.com 等)首次连接需要 OAuth 授权,但插件设置里只有"立即试用"和"卸载",找不到任何授权入口;连接失败也完全静默,桌面日志(~/.zcode/v2/logs/)里没有任何 MCP 连接尝试的记录。另外 GitHub 插件依赖 GITHUB_PERSONAL_ACCESS_TOKEN 环境变量,未配置时同样没有任何提示。
建议方案 · Proposal
- 插件详情页展示每个 MCP 服务器的连接状态(已连接 / 待授权 / 失败 + 原因);
- 首次使用插件提供的 MCP 工具时,自动弹出 OAuth 授权流程(浏览器跳转 + 回调);
- 连接失败时在会话和设置中明确报错(例如"缺少环境变量 GITHUB_PERSONAL_ACCESS_TOKEN");
- 官方文档(zcode-guide 的 diagnosing-plugins 指南)补充插件远程 MCP 的授权配置说明,目前完全没覆盖这一环。
预期价值 · Expected value
插件市场的核心卖点是这些插件的 MCP 能力,现在用户装了插件却不知道为什么用不了、也不知道该去哪配置,插件形同虚设。有了状态展示和一键授权后,用户无需排查配置文件和日志就能自助完成连接,大幅降低插件生态的使用门槛。
你认为的优先级 · Your perceived priority
中 · Medium
你使用的 ZCode 版本 / 环境 · ZCode version / environment
v3.11.2 / Desktop / Windows 10 x64
补充材料 · Additional context
复现方式:安装 canva/figma 任一插件 → 启用 → 新会话中让 AI 列出可用 MCP 工具 → 无任何该插件服务器的工具;插件设置中无授权入口,日志中无连接记录。
Contributor guide
First steps
- Read the whole issue, then the project's contributing guide.
- Comment on the issue to say you are picking it up — it saves two people doing the same work.
- Fork the repository and make your change on a branch.
- Open a pull request that references the issue number.
Research direction
Start by reproducing the Canva or Figma plugin flow on Desktop/Windows, checking the plugin settings, new-session tool list, and ~/.zcode/v2/logs/. Review the zcode-guide diagnosing-plugins guide mentioned in the report. The issue names no implementation files or tests; done would require the proposed authorization, connection status, error reporting, and documentation coverage to be defined and verified.
Written by the indexing model from the issue text.
Assessment
- Domain
- authentication, desktop, documentation
- Issue type
- Feature
- Difficulty
- 5/5
- Estimated time
- Over a week
- Activity status
- Active
- Clarity
- Mostly clear
- Newbie friendliness
- 35/100