跳到主要内容
← 返回AI Agent Engineering|12 周从 Demo 到真实 Agent 系统

AI Agent Engineering · Week 04

04-03|API vs MCP:到底什么时候用哪个

用连接数量、复用范围、治理成本与业务边界判断直接 API、应用内 Tool 和 MCP Server 的选择。

API · MCP · Architecture Decision

两个问题处在不同层

API 回答“一个软件怎样调用另一个软件”。MCP 回答“AI Host 怎样用统一方式发现并调用外部能力与上下文”。很多 MCP Server 内部依然调用 API,因此二者经常同时出现。

选择的关键不是哪一个更先进,而是连接是否需要跨 Host 复用,以及团队是否愿意承担新的协议、部署和治理边界。

直接 API / 应用内 Adapter

一个应用拥有明确后端;Tool handler 直接调用供应商 API。

链路短、控制直接、应用耦合较高。
MCP Server

多个 AI Host 需要以相同协议发现和调用一组能力。

复用和发现更强,多出 Server 生命周期与治理成本。
图 1|MCP 增加的是 AI 连接层复用;它没有消除后端 API 和业务 Adapter。

直接 API 就够的情况

  • 只有一个应用和一个受控 Runtime 使用能力。
  • Tool 数量少,接口由同一团队维护。
  • 延迟和故障面需要尽量小。
  • 能力不会被其他 AI Host 动态发现。

V0.3 的单一客服 Agent 使用两个内部 Tool,就是合理起点。先证明订单查询有业务价值,再决定是否建立共享连接层。

MCP 值得增加的情况

  • 客服工作台、运营助手和开发 Agent 都要使用相同订单能力。
  • 希望 Host 能标准发现 Tool、Resource 与 Schema。
  • Server 需要独立版本、审计和团队所有权。
  • 能力提供方不想为每个 Host 编写专用插件。

谁需要这项能力?
↓

单一应用
应用内 Tool + API Adapter
除非有其他强约束,否则先停在这里
多个独立 AI Host
评估 MCP Server
验证发现、权限、部署和运维收益
图 2|“多个调用方”只是进入评估的信号;复用收益还要覆盖新增治理成本。

用四笔账做架构决定

维度直接 APIMCP
连接复用每个应用自行集成多个 Host 使用共同协议
能力发现应用静态注册协议发现与列表
运行成本链路较短多一个 Server 与版本边界
权限责任应用后端与 APIHost、MCP Server、API 都要明确

Support Host Operations Host
↘    ↙
Order MCP Server
↓
Stable Tool Contract
↓
Provider Adapter → Shopify / ERP API

图 3|V0.4 复用 V0.3 Contract;MCP 只改变对外连接方式,不改变订单事实与授权归属。

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 的可能。

主动回忆

  1. 为什么 MCP Server 内部常常仍需要 API?
  2. 什么证据能支持多一层 MCP?
  3. 自动把所有 API endpoint 变成 Tool 会产生什么问题?
  4. V0.4 哪些边界保持不变?

下一课把决定落地:将 V0.3 的订单查询能力包装为教学 MCP Server,并用独立 Client、失败测试和权限断言完成 V0.4 验收。

延伸阅读 / Sources

核查日期:2026-10-18。

长期有效的原理: 从复用收益、责任边界和故障成本选连接方式。当前实现方式: MCP 规范和 SDK 仍在演化,ADR 必须记录核查版本与迁移成本。