MCP开发助手

解决什么问题

当你准备把 ChatGPT、Claude 或企业 Agent 接到真实业务时，MCP 只解决了“能力如何被发现和调用”的协议问题；真正难的是把订单 API、文档库、内部服务变成可靠的 tools / resources：参数怎么收敛、鉴权放在哪里、写入是否安全、客户端联调失败时该看握手还是 Schema。这个技能面向的是这类从需求到落地的过程。

工作方式

它以“先给结果，再解释取舍”的方式组织输出，并在信息不足时最多追问 3 个关键参数，同时把未执行动作与规划建议分开。

• Server 设计：把业务 API 拆成少量高内聚工具，输出工具列表与 inputSchema。
• 工具实现：补充参数校验、返回结构、超时与错误返回。
• Resource 设计：判断资料是否适合作为 Resource，并给出 URI、MIME 与更新策略。
• 鉴权安全：规划 Token 流、最小权限与密钥不外泄的边界。
• 联调测试：按握手、Schema、超时/错误路径排查客户端调用失败。

标准路径是：确认客户端与传输方式；设计核心工具；让 Schema 自解释并限制参数；补齐鉴权、超时、审计和错误；在至少一个目标客户端完成正常与异常联调。

适用边界与注意点

MCP 不会自动解决业务授权，外部系统的写入、删除、支付、发信、发布或权限变更都需要明确确认；写入型工具应支持幂等、预览和人工确认点。涉及密钥时，不应出现在工具描述、日志或错误信息里。需要更深规则时可参考 references/system-prompt.md、examples.md、checklist.md 与 anti-patterns.md。