Skip to content

docs(skill): MCP 注册键位修正 — 通用 client 的 mcpServers 与 zcode 配置的 mcp.servers 区分 - #25

Merged
tizerluo merged 2 commits into
mainfrom
docs/skill-mcp-key
Aug 31, 2026
Merged

tizerluo merged 2 commits into
mainfrom
docs/skill-mcp-key

Conversation

@tizerluo

Copy link
Copy Markdown
Owner

摘要

终审 grep 发现的残留失真:SKILL.md「模式三:注册到 MCP client」把通用 MCP client 的格式(Claude Code .mcp.json / Cursor 用顶层 mcpServers 键——生态标准)与 zcode 自身配置~/.zcode/cli/config.json 读嵌套 mcp.servers)混写,且旧注记「mcpServers 键在 0.16.1 实测仍受支持」与 0.16.5 bundle 证据矛盾。

修正

  • 改写为 A/B 两场景:A 通用 MCP client(顶层 mcpServers,保留完整示例);B zcode 自身(嵌套 mcp.servers,新增加套示例)
  • 弃用旧注记,替换为 bundle 三处证据(设置键映射 McpServers:"mcp.servers"、分层合并、诊断枚举均只读 mcp.servers;顶层键字符串仅见于 plugin manifest/请求载荷)
  • 引言补「及 zcode 自身」,与 A/B 结构及 README 口径对齐

Review 流程

  • coder 实施 + P3 引言行对齐
  • code-reviewer APPROVE(无 P0/P1/P2)
  • simplifier 两条 shrink 建议经裁决不采纳(skill 需自包含可即贴;勘误句对无 git 历史的部署副本有价值)
  • 测试 414 passed(docs-only)

@tizerluo
tizerluo merged commit 2c1f4ad into main Aug 31, 2026
4 checks passed
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