MCP 服务构建指南

把 MCP Server 当作面向模型的产品接口，而不是把上游 API 端点机械地转发出来。目标是让模型能够发现正确的工具、提交受约束的输入、理解结构化结果，并在失败时知道下一步怎么做。

0. 先确定边界

开始前记录：

• 用户任务、目标外部服务、预期客户端和 MCP 协议/SDK 版本；
• 传输方式（本地 STDIO 或远程 Streamable HTTP）、认证主体、租户边界和凭据来源；
• 每项能力的读、写、删除、执行、通信、计费或网络副作用；
• 速率、分页、超时、部署、日志、监控、测试和回滚约束；
• 明确的假设、未知项和不在本次 MVP 内的内容。

不要因为“API 有这个 endpoint”就暴露它；每个工具必须对应一个清晰的用户动作，避免万能代理和过宽的管理权限。

1. 调研协议与服务