前言¶

给 WorkBuddy 接一个新平台时，绕不开手写 mcp.json。这类配置的麻烦在于：字段名拼写、必填项有没有填、服务器地址与鉴权参数放哪一层，往往要对着官方文档逐条核对，改错了还要反复重启连接器重试。

MCP 服务器配置师（@user_af163eaa/z-mcp-config-helper）就是为这一步准备的：你给出想接的平台名或官方文档链接，它按 WorkBuddy 的 mcp.json 格式生成配置片段，标注必填项与安全要点，并指引到连接器管理页启用。

这是什么¶

一句话定位：一个社区发布的 Skill，把「查文档、写 mcp.json、启用连接器」这件事收敛成一条指令。

• 出品方：user_af163eaa（community 来源）
• 版本：1.0.0
• 分类：dev-programming
• 平台数据：SkillHub 评分 100000，下载 1476，安装 0
• 不需要额外 API Key（requires_api_key=false）

核心功能¶

下面介绍的几项能力均来自官方页面。

1、生成配置片段。按 WorkBuddy 的 mcp.json 格式产出可直接使用的 YAML/JSON 片段，不用自己猜字段结构。
2、标注必填项。哪些字段缺失会导致连接失败，会在配置里标出来。
3、安全要点。涉及鉴权 token、服务器地址等敏感项时给出注意事项。
4、指引启用。生成后引导你到 WorkBuddy 连接器管理页完成启用，而不是到此为止。
5、可选真实写入。未开启「允许完全访问」时只产出配置草稿；开启后，在你确认的情况下可以真正写入 mcp.json 生效。

安装与启用¶

安装命令如下，把 agent 参数换成你本机 Agent 的标识即可：

skillhub use @user_af163eaa/z-mcp-config-helper --agent claude-code

如果用 Cursor，改成对应的 agent 标识：

skillhub use @user_af163eaa/z-mcp-config-helper --agent cursor

Codex CLI 同理，传对应的标识。SkillHub 支持 Cursor、Claude Code、Codex CLI 三类标识，具体写法以你本机安装说明为准。

装完后按触发场景唤起即可。页面列出的触发说法包括「MCP配置」「接入平台」「配个连接器」「mcp.json怎么写」「接个MCP」「服务器配置」「连接配置生成」「怎么连新平台」。

典型用法¶

官方页面给出的示例提示词，可直接照抄改写：

帮我把 Notion 接进 WorkBuddy
mcp.json 怎么写能接 Linear
把官方文档 https://docs.example.com 的 MCP 服务器配置生成一下

三种问法对应三种输入：平台名、需求描述、文档链接。Skill 会从中提取配置要素，产出 mcp.json 片段，并说明哪些是必填项。

流程上分两步：

1、先产出草稿。未开启「允许完全访问」时，Skill 只给出配置草稿和启用指引，改动落在你手上。
2、确认后再写入。开启「允许完全访问」后，经你确认，Skill 可以直接写 mcp.json，之后到连接器管理页启用。

适用场景与注意¶

适合谁：需要把外部平台以 MCP 形式接进 WorkBuddy，且不想反复翻文档核对 mcp.json 字段的人；或者说，刚接入新平台、还没摸清楚配置结构的阶段。

注意几点：

• 写入依赖权限。想要「直接写 mcp.json」而不是「只给草稿」，必须先开启智能体平台的「允许完全访问」权限；不开启就只能走草稿 + 手动粘贴的流程。
• 来源为 community。发布者是 user_af163eaa 而非官方团队，平台数据（评分 100000、下载 1476、安装 0）可作参考，安装数为 0 意味着实际使用反馈样本还很少，生成的配置建议自己核对一遍再启用。
• 配置以平台方官方文档为准。Skill 是格式化与指引工具，服务器地址、鉴权方式的权威性来自你提供的官方文档，冲突时以官方文档为准。
• 涉及安全要点时别略过。鉴权 token、内网地址这类配置，生成后按标注逐项确认。

结尾¶

这个 Skill 的价值不在替官方文档做背书，而在把 mcp.json 的格式、必填项和启用路径一次性理清，省掉反复试错的时间。如果你正好要接新平台，可以装一个试试。

官方地址：https://api.skillhub.cn/user_af163eaa/z-mcp-config-helper
页面地址：https://www.skillhub.cn/skills/user_af163eaa/z-mcp-config-helper