AI Agent Engineering · Week 04
04-03|API vs MCP:到底什么时候用哪个
用连接数量、复用范围、治理成本与业务边界判断直接 API、应用内 Tool 和 MCP Server 的选择。
两个问题处在不同层
API 回答“一个软件怎样调用另一个软件”。MCP 回答“AI Host 怎样用统一方式发现并调用外部能力与上下文”。很多 MCP Server 内部依然调用 API,因此二者经常同时出现。
选择的关键不是哪一个更先进,而是连接是否需要跨 Host 复用,以及团队是否愿意承担新的协议、部署和治理边界。
一个应用拥有明确后端;Tool handler 直接调用供应商 API。
链路短、控制直接、应用耦合较高。多个 AI Host 需要以相同协议发现和调用一组能力。
复用和发现更强,多出 Server 生命周期与治理成本。直接 API 就够的情况
- 只有一个应用和一个受控 Runtime 使用能力。
- Tool 数量少,接口由同一团队维护。
- 延迟和故障面需要尽量小。
- 能力不会被其他 AI Host 动态发现。
V0.3 的单一客服 Agent 使用两个内部 Tool,就是合理起点。先证明订单查询有业务价值,再决定是否建立共享连接层。
MCP 值得增加的情况
- 客服工作台、运营助手和开发 Agent 都要使用相同订单能力。
- 希望 Host 能标准发现 Tool、Resource 与 Schema。
- Server 需要独立版本、审计和团队所有权。
- 能力提供方不想为每个 Host 编写专用插件。
谁需要这项能力?
↓
应用内 Tool + API Adapter
除非有其他强约束,否则先停在这里
评估 MCP Server
验证发现、权限、部署和运维收益
用四笔账做架构决定
| 维度 | 直接 API | MCP |
|---|---|---|
| 连接复用 | 每个应用自行集成 | 多个 Host 使用共同协议 |
| 能力发现 | 应用静态注册 | 协议发现与列表 |
| 运行成本 | 链路较短 | 多一个 Server 与版本边界 |
| 权限责任 | 应用后端与 API | Host、MCP Server、API 都要明确 |
Support Host Operations Host
↘ ↙
Order MCP Server
↓
Stable Tool Contract
↓
Provider Adapter → Shopify / ERP API
V0.4 的选择
课程为了学习可复用连接层,将订单查询包装成教学 MCP Server。底层仍使用安全 Mock 或 Adapter,不连接生产 Shopify。我们会验证 Server 能被独立 Client 发现和调用,同时确保模型不能提供 tenantId 或 customerId。
Failure Lab
看到 AI 项目就默认上 MCP
为什么诱人: 统一协议看起来能一次解决未来所有集成。
为什么失败: 单应用的小系统多出部署、连接、版本和授权故障面,却没有复用收益。
更合理设计: 从调用方数量、所有权和复用证据出发;直接 Tool + API 足够时保持简单。
把内部 API 原样映射成几十个 MCP Tools
为什么诱人: 自动生成快,覆盖面大。
为什么失败: 模型难以选择,内部字段和高风险动作也被一起暴露。
更合理设计: 按用户任务设计少量 Tool,返回最小业务结果,并保留 Adapter 层。
因为使用 MCP 就跳过威胁模型
为什么诱人: 标准协议给人“已经安全”的感觉。
为什么失败: Server 仍处理认证、授权、凭证、敏感数据和潜在副作用。
更合理设计: 分别审查 Host、transport、Server handler 和下游 API 的信任边界。
实践:做一份连接方式 ADR
分别为“只有客服 Agent 使用订单查询”和“客服、运营、开发三个 Host 共用订单能力”写出选择。记录调用方、能力所有者、授权位置、部署成本、失败影响和退出方案。
Acceptance Criteria
- ☐ 没有把 API 与 MCP 写成二选一替代关系。
- ☐ 单应用场景能说明直接 API 的优势。
- ☐ 多 Host 场景能说明 MCP 的具体复用收益。
- ☐ 新增 Server 的部署、版本和授权成本被计算。
- ☐ Tool Contract 不直接复制供应商全部 API。
- ☐ 方案保留从 MCP 回退到应用内 Adapter 的可能。
主动回忆
- 为什么 MCP Server 内部常常仍需要 API?
- 什么证据能支持多一层 MCP?
- 自动把所有 API endpoint 变成 Tool 会产生什么问题?
- V0.4 哪些边界保持不变?
下一课把决定落地:将 V0.3 的订单查询能力包装为教学 MCP Server,并用独立 Client、失败测试和权限断言完成 V0.4 验收。
延伸阅读 / Sources
核查日期:2026-10-18。
- MCP 官方文档:Architecture overview。用于核对 MCP 的参与者、传输与协议范围。
- MCP TypeScript SDK v2。用于核对当前 Server / Client 实现边界。
- IETF RFC 9110:HTTP Semantics。用于核对 MCP 背后 HTTP API 仍遵循的长期语义。
长期有效的原理: 从复用收益、责任边界和故障成本选连接方式。当前实现方式: MCP 规范和 SDK 仍在演化,ADR 必须记录核查版本与迁移成本。