很多人第一次给模型接外部能力时,手里同时躺着 SDK 文档和一份 MCP 服务器清单,结果两边都动了一点,最后不清楚是哪一层出了问题。这篇不重复概念定义,专门讲两者的分工边界:什么活该走 API,什么活交给 MCP 更省事,混着用的时候按什么顺序排,以及配置填错时先查哪一格。
给模型接外部能力,第一次动手的人最容易卡在同一个地方:左手一份 API 文档,右手一份 MCP 服务器清单,两边都配了一点,跑起来报错却不知道是哪一层的问题。说白了,这不是谁替代谁的关系,而是两层活儿,混着用的时候得先想清楚哪层管哪段。
这篇不铺概念,直接讲分工边界。什么活走 API 更省事,什么活交给 MCP 才划算,两边一起上按什么顺序接,配置填错了先翻哪一格。下面提到的具体数字,价格去 /price-watch 看,测速去 /tools/speed-test 跑一遍,别照抄别人给的。
先分清谁在调谁,别把两层混成一层
API 是能力和数据的出口。你写代码去请求它,协议、鉴权、参数结构、超时重试,全都得自己管。它不关心谁在调,程序也好脚本也好,只要请求格式对就行。这层的好处是确定性强,坏处是每接一个服务就得读一遍文档、写一遍适配。
MCP 是另一回事。它是一层约定,让模型侧按统一格式发现有哪些工具、每个工具吃什么参数,再决定调不调。省掉的是「每个工具单独写一套对接代码」这件事,不是省掉底下的网络请求。实际用下来,MCP 底下往往还是去调某个 API。
- 谁发起
- API 是你代码发起请求;MCP 是模型在对话里决定要不要用某个工具
- 适配成本
- API 接一个新服务写一次;MCP 把工具描述一次写好,多个客户端能复用
- 出错特征
- API 侧多半是连通性和鉴权;MCP 侧多半是工具没列出来或参数对不上
什么情况下该上哪个:一张对照表先过一遍
| 你的场景 | 更合适的选择 | 理由 |
|---|---|---|
| 固定流程、定时跑批、结果落自己库 | 直接调 API | 加一层 MCP 只是多绕一步,还多一个要维护的进程 |
| 同一套工具要给多个模型或多个客户端用 | MCP | 工具描述写一次,换客户端不用重写适配 |
| 需要模型临场判断调哪个工具、带什么参数 | MCP | 模型自己看工具清单做选择,适合开放式任务 |
| 团队没人维护长连接和工具清单 | 先只用 API | 工具清单会腐化,没人管的话故障面比收益大 |
最后一行值得多说一句。MCP 有个隐性成本:工具会增减、描述会过期,得有人盯着。一家 5 人小团队如果没有明确的维护人,工具列表半年后大概率是半坏的,模型选到旧工具还照样发请求,报错又很难追。这种时候老老实实调 API,反而少折腾。
反过来,如果你要做的是一个通用助手,工具会持续加,还要换着模型试,那 MCP 的价值才真正显出来。判断标准就一条:同一个工具会不会被两种以上的调用方用到。会,上 MCP;不会,先别装。
真要两边一起用,按这个顺序接线
同时接 API 和 MCP 最常见的翻车方式,是一次性把所有东西配好再跑,报错时无法定位。稳妥做法是分层验证,一层通了再动下一层,每层留一条失败记录。
- 先把 API 单独跑通用最简请求验证 key、base URL、超时都正常。这一步不和任何 MCP 服务混在一起,确认返回结构是你预期的。
- 再起 MCP 服务先只看工具能不能被列出来,这一步不执行。列不出来,问题在服务本身或配置路径。
- 让它执行一次最简单的调用挑参数最少的那个工具跑一遍,参数手动填死,先排除模型因素。
- 最后才把模型接进来观察模型选的工具和参数是否符合预期。模型选错工具,多半是工具描述太笼统,不是模型笨。
每一步都留一条失败记录,写清楚报错原文出现在哪一层。这看着琐碎,实际排错时能省一半时间。没有记录的话,两天后回来看只会记得「当时跑不通」。
调不通的时候,按这个顺序查
报错来了先别急着改代码,先分清它来自哪一层。这是最省时间的一步,也是最容易被跳过的一步。网络超时、鉴权被拒、返回结构不对,问题基本在 API 那侧;工具「不存在」、参数名对不上、模型说找不到工具,问题基本在 MCP 那侧。分错层,后面全白查。
- 看工具描述是不是写得太笼统,模型选错工具通常出在这,不是模型能力问题
- 用接口测速先量出延迟基线,判断是慢还是根本没通,到 /tools/speed-test 跑一遍
- 把请求参数逐个打印出来,别靠猜哪一格填错,尤其是嵌套结构的字段名
- 检查 MCP 服务的工具清单是不是缓存的旧版本,改了描述却还在用老的
- 确认 key 和 base URL 没有填到另一层的配置里,混用时这格最容易填串
有一种情况不适用上面的顺序:如果报错是间歇性的、时通时不通,先别查配置,先查是不是有多个进程抢同一个端口或者长连接被中间层掐断。这类问题按静态配置去查会一直查不出来。
还有一点,别把「能跑通」当成「配对了」。模型偶尔选对工具可能只是碰巧,让它连续跑几个不同类型的任务,看选择稳不稳定。不稳定的话,回去改工具描述,不是改代码。
下一步先把你要接的工具按上面那张表过一遍,判断该走哪层;然后到站内中转站页面看你选的服务可信度和当前情况,再动手配,能少踩不少坑。→常见问题
有了 API 还需要 MCP 吗?
看你是否希望模型自己决定调什么。流程固定、由程序驱动的场景,API 就够了;要让对话里的模型临场挑工具、多个客户端复用同一套工具时,MCP 才值得加。加之前先确认有人能维护工具清单。
MCP 是不是替代 API 的?
不是。它俩不在一个层面上,MCP 底下通常还是走 API 或本地程序。把 MCP 当成一层工具约定更准确,它解决的是发现和调用格式统一,不解决数据从哪来。
第一次接工具,从哪个开始比较稳?
先从单个 API 跑通开始,把 key、地址、超时、错误码都摸一遍,再去接 MCP。顺序倒过来,出问题时你分不清是工具没起来还是请求本身就没通。