AI Agent Engineering · Week 04
04-02|MCP:把外部能力标准化给 AI 使用
理解 MCP Host、Client、Server、Tool 与 Resource 的关系,以及标准化发现和调用解决了哪一层连接问题。
当第二个 AI 应用也要查询订单
V0.3 的订单 Tool 直接注册在当前 Agent Runtime 内。如果客服工作台、IDE Agent 和内部运营助手都要使用这项能力,每个应用分别实现发现、参数描述、连接和结果解析,会产生多套重复集成。
MCP 提供一套 AI 应用与外部能力、上下文交换的标准协议。它定义 Host 如何连接 Server、发现能力并发起调用。它不规定模型怎样推理,也不替业务系统保存订单。
Host、Client 与 Server
客服 AI 应用:管理模型、权限体验与多个连接
连接订单 Server
连接知识 Server
Host 是用户正在使用的 AI 应用。Client 是 Host 内连接某个 Server 的协议组件。Server 可以在本机通过 stdio 运行,也可以通过 Streamable HTTP 远程提供服务;“Server”描述角色,不等于一定是一台远程机器。
Tool、Resource 与 Prompt
可调用的查询或动作,例如 get_order_summary。
可读取的上下文数据,例如公开的字段说明或政策版本。
由应用选择何时读取和放入 Context。可复用的交互模板。
适合用户或应用选择的任务入口,不是业务权限。Server 通过发现机制告诉 Client 自己支持哪些能力。Client 可以列出 Tools,再按 Schema 发起 tools/call。标准化的是发现、描述、调用和返回的协议形状,不是背后的业务实现。
MCP 与业务 API 的关系
AI Host
↓ MCP
Order MCP Server
↓ Provider Adapter
Shopify / ERP API
↓
Order Database
MCP 不自动授予订单访问权。远程连接仍要认证;Server handler 仍要按可信身份做授权;Tool Result 仍要校验和脱敏。一个声明为只读的 Tool 也不能只靠描述保证安全,执行层必须真正限制副作用。
当前规范与长期概念
长期稳定的是 Host / Client / Server 分层、能力发现与结构化调用。到 2026-10-18,官方文档当前使用 2026-07-28 规范;TypeScript SDK v2 是稳定线,包拆分为 @modelcontextprotocol/server 与 @modelcontextprotocol/client。这些包名和具体方法属于当前实现,后续可能继续演化。
Failure Lab
“用了 MCP,就不用写 API 集成”
为什么诱人: MCP Server 看起来已经提供统一接口。
为什么失败: Server 内仍要调用 Shopify、ERP 或数据库,并处理供应商认证、字段与限流。
更合理设计: MCP 负责 AI 连接层;Provider Adapter 继续负责业务 API 集成。
把每条订单都暴露成 Resource
为什么诱人: Host 可以随时读取,似乎很方便。
为什么失败: 资源枚举与缓存可能扩大敏感数据暴露,权限边界也更难审计。
更合理设计: 敏感业务查询优先使用受控 Tool,并按请求身份返回最小结果。
相信 Tool 描述能阻止越权
为什么诱人: 描述里已经写了“只查当前客户”。
为什么失败: 描述影响模型选择,不构成服务端强制规则。
更合理设计: Server 从认证上下文取得身份,handler 每次执行授权检查。
实践:给 V0.3 画 MCP 边界
标出 Host、Client、Order MCP Server、Provider Adapter 和订单 API。为 get_order_summary 写出发现信息、模型参数、可信身份来源、业务响应和失败出口。
Acceptance Criteria
- ☐ Host、Client 与 Server 没有混用。
- ☐ Tool、Resource、Prompt 的控制方式和用途清楚。
- ☐ MCP Server 背后仍保留 Provider Adapter 与业务 API。
- ☐ 可信身份不由模型参数提供。
- ☐ 本地 stdio 与远程 HTTP 只是传输选择,不改变业务权限。
- ☐ 当前 SDK 实现与长期协议概念明确分开。
主动回忆
- 一个 Host 连接两个 Server 时会有几个 Client?
- MCP 标准化了哪一层,又没有标准化哪一层?
- 为什么敏感订单查询更适合 Tool 而非批量 Resource?
- Tool 描述为什么不能承担 Authorization?
下一课比较直接 API 与 MCP 的决策成本:哪些场景多一层协议能带来复用,哪些场景只会增加运维负担。
延伸阅读 / Sources
核查日期:2026-10-18。
- MCP 官方文档:Architecture overview。用于核对 Host、Client、Server、传输与 primitives。
- MCP Specification 2026-07-28。用于核对当前协议版本与规范边界。
- MCP TypeScript SDK v2。用于核对当前稳定 SDK 包和实现入口。
长期有效的原理: 能力发现、协议边界、最小权限与服务端授权。当前实现方式: 协议版本、SDK 包、transport API 和扩展会变化,编码前必须重新核对官方版本与迁移说明。