zai-org / zai-org/feedback

[建议 / Feature] 插件远程 MCP 服务器静默连接失败:无授权入口、无状态展示、无错误提示

Open
#601 3 comments 0 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

priority: P2 status: 待评估 type: 功能建议
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
  1. 插件详情页展示每个 MCP 服务器的连接状态(已连接 / 待授权 / 失败 + 原因);
  2. 首次使用插件提供的 MCP 工具时,自动弹出 OAuth 授权流程(浏览器跳转 + 回调);
  3. 连接失败时在会话和设置中明确报错(例如"缺少环境变量 GITHUB_PERSONAL_ACCESS_TOKEN");
  4. 官方文档(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

Open the contributing guide

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. 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

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.