API 和 MCP 选择标准:先看这条链路归谁管,再决定接哪个

入门与上手

把 API 和 MCP 的选择拆成几件能核对的事:谁提供能力、谁负责编排、出错时找谁,配一份开工前的对照清单。

很多人第一次同时碰到 API 和 MCP,是在给一个助手接外部能力的时候:一边要填 Key 和 base_url,一边又要配 server 和工具列表,两套东西长得不像,文档还各说各的。这篇不讲名词定义,只讲怎么判断你这一层该用哪种、接之前要核对哪几格,以及什么情况下这套标准不适用。

给助手接外部能力的时候,很多人第一次同时撞上 API 和 MCP:一边要填 Key、base_url,一边又要配 server、列工具,两套东西长得完全不像,文档也各写各的。这时候最容易犯的错是先挑「哪个更先进」,而不是先问一句——这条链路到底归谁管。

这篇不定义名词,只讲怎么判断你这一层该接哪种、动手前核对哪几格、出问题先查哪一段。判断标准都有边界,后面会写清什么情况下不适用,别照抄。

先分清你要的是「一个能力」还是「一套工具目录」

只调一次、输入输出固定的活,比如翻译一段文本、生成一张图、把一段话转成结构化字段,走 API 更直接。你写死请求体,拿到响应就解析,整条链路短,出错也容易定位。这类需求硬上 MCP,等于给一个不需要决策的动作加了编排层,麻烦多过收益。

只有当你想让模型自己决定调哪个工具、调几次、拿到结果后要不要再来一轮,MCP 这套才有意义。它解决的是「工具目录怎么挂载、怎么描述给模型看」的问题,不是「怎么发一个 HTTP 请求」的问题。两件事别混。

  • 动作固定、参数几乎不变:直接走 API,把请求写死最省心
  • 模型需要在几个工具之间自己挑:考虑 MCP,工具描述就是给模型看的说明书
  • 两种都能做时,看工具列表谁来维护:你自己在代码里写死,就用 API;希望外部动态挂载、增删工具不改代码,才轮到 MCP
  • 团队里没人愿意跟进 server 版本和依赖:先用 API 把能力跑通,别为了架构好看给自己挖坑

说到底,这一层的判断标准是「谁负责维护工具清单」。清单写在你仓库里,就是 API 的事;清单挂在外部、要能被动态发现,才需要 MCP 那套机制。反过来,如果你只是想要一个稳定输出,别被「协议更新」这类说法带跑。

三层拆开看:通道、协议、编排

把整条链路拆成三层,后面的排查才有落点。通道层是 base_url、Key、鉴权头这堆东西,协议层管请求长什么样、响应怎么解析,编排层才是模型要不要自己挑工具、拿到结果后要不要再问一轮。MCP 主要落在编排层,别把它当成通道方案。

层管什么出问题时的典型表现
通道层地址、Key、鉴权头、代理401、403、404,请求根本没到对的地方
协议层请求体格式、响应结构、字段命名能通但解析报错,字段名或嵌套层级对不上
编排层模型挑工具、多轮往返、上下文管理工具调了但结果胡来,或同一件事时好时坏

实际用下来,八成的「接不上」都卡在通道层,剩下的大半在协议层。真正需要动编排逻辑的,往往是功能已经跑通、想让它更聪明的时候。所以排查顺序建议从下往上:先确认请求发出去了,再看格式对不对,最后才怀疑编排。

动手前照着核对的几格

  1. 确认地址和 Key 的来源是官方直连还是走中转,写在配置里别散落在代码各处;中转的话,出错时先看服务商的状态说明,别一上来就改自己的代码
  2. 确认模型支不支持工具调用不支持的话,MCP 那条路直接不用考虑,省掉后面所有折腾。查模型资料时到 /models 看能力说明,别凭印象
  3. 先读一遍工具调用的返回示例字段名、嵌套层级、有没有空值,照着示例写解析,别等跑起来再猜
  4. 定好超时和重试放在哪一层工具调用比普通请求更容易卡在中间态,重试放在通道层还是编排层要提前说清,否则会重复执行
  5. 留一条降级路径工具那层不可用时,能不能直接退回固定 API 调用,这个开关在开工前就该留好

这份清单不适用于一种情况:你接的是完全托管的第三方服务,地址和鉴权都由对方封装好,那你只需要核对返回结构,通道层那几格可以跳过。判断依据是你手里有没有 Key 和 base_url 的控制权。

出问题时,先判断是哪一层坏了

报错信息经常误导人。请求根本没发出去,先查地址、端口、代理,还有 Key 有没有多余空格——这个坑很常见,复制粘贴时带了个换行,报的却是鉴权失败。请求发出去了但返回结构不对,多半是协议格式不匹配,不是模型笨。

能调工具但结果胡来,看工具描述写没写清参数含义和适用边界。描述里只写「查询数据」,模型当然不知道查哪张表、时间范围怎么传。同一件事时好时坏,先怀疑编排层的轮次限制或上下文被截断,而不是换模型。

  • 请求没到对端:查地址、端口、代理、Key 的空格和换行
  • 能通但解析报错:对照示例看字段名和嵌套层级
  • 工具调了但参数错:回去改工具描述,把参数含义和边界写具体
  • 结果时好时坏:查轮次上限、上下文长度、有没有并发写同一份状态
  • 换了供应商后集体报错:先看协议格式差异,别逐个功能排查

哪些场景别急着上 MCP

只有一两个固定动作、参数几乎不变的小工具,写成普通函数调用更省事。加一层编排,换来的是更多配置、更多故障点和更长的调试时间,收益对不上。团队里没人愿意维护 server 的版本和依赖,上了也是负担,过两个月就没人敢动。

对延迟敏感、每次都要多轮工具往返的场景,先算清楚多出来的往返成本再决定。工具调用天然比单次请求多几个来回,如果你的用户等不了,那就把决策提前到代码里,而不是交给模型现场判断。

这条不适用的边界也要说清:如果你的工具数量会持续增长、而且需要不同团队各自挂载,那前期多花点配置成本是值得的,别被上面这段话劝退。判断依据是工具清单的增长速度,不是当前数量。

换方案时真正要重写的是哪部分

换供应商或换接入方式,最怕的是一改全崩。把三层边界在代码里分开,通道层换供应商,改动集中在地址、Key 和报错处理;协议层换格式,改动集中在请求体和响应解析;编排层换思路,改动最大,工具描述和提示词都要重写一遍。

实际做的时候,建议先把请求构造和响应解析抽成独立函数,别和业务逻辑搅在一起。这样以后换哪一层,改的都是同一小块地方。听起来是常识,但赶工期时最先省掉的就是这步,后面还债的也是这步。

价格和额度这类会变的东西,别写进代码注释里当结论。要看当时的数字,到 /price-watch 核对,免得几个月后有人拿着过期信息做决策。

一个五人小团队可以照着走的顺序

  1. 先用 API 把单个能力跑通挑一个最刚需的动作,确认输入输出稳定,报错可复现,再谈扩展
  2. 把需要模型决策的部分单独拎出来列一下哪些环节是「固定动作」,哪些是「看情况挑」,后者才可能用到工具编排
  3. 写一份工具清单再动手接每个工具写清名字、干什么、参数含义、失败时怎么回,这份清单同时是给模型看的描述和给同事看的文档
  4. 接入后留一条降级路径工具层不可用时直接走固定 API,保证核心功能不中断
  5. 定期回头看工具描述业务变了,工具描述没跟上,模型就会按老规则调,这类问题不会报错,只会慢慢变差

这套顺序不追求一步到位,重点是每一步都有可验证的结果。先把一个能力跑稳,再考虑编排,比一上来就搭全套工具目录要靠谱得多。

下一步想知道各家通道的可用性和延迟表现,可以到 /tools/speed-test 自己跑一遍,比看别人的结论更贴近你的网络环境。

常见问题

API 和 MCP 是不是必须二选一?

不是。实际项目里常见的是底下用 API 提供具体能力,上面用 MCP 那套方式让模型决定什么时候调用。判断标准是:能力本身固定就走 API,调用顺序需要模型自己拿主意才需要后者。

只看文档能不能判断一个 MCP server 靠不靠谱?

文档能看出参数写得清不清楚、有没有失败示例,但看不出稳定性。可以先拿一两个真实请求试,记录响应时间和返回结构是否稳定,再决定要不要接进主流程。

模型不支持工具调用,还能用 MCP 吗?

基本用不上,因为这套方式的前提就是模型能输出结构化的调用意图。这种情况要么换支持工具调用的模型,要么把流程写死成固定顺序的 API 调用。

报错时怎么快速定位是 API 侧还是编排侧?

先把同一请求用最简单的方式手动发一次,比如用工具直接请求接口。能通说明通道没问题,问题在编排;不通就沿地址、Key、参数顺序往下查。

小团队一定要自己维护 MCP server 吗?

不一定。工具数量少、变化不频繁时,自己写一层薄封装反而更可控。只有当工具来源分散、需要多方共用同一套描述时,维护 server 才划算。

本文依据各平台公开文档与官方公告整理,只做中文归纳;具体做法、参数与限制以官方文档为准。