很多人是这么卡住的:LangChain 那边的链已经跑通了,想再加个工具调用,看到 MCP 就顺手装进来,结果两边都在管工具,谁调谁说不清,报错还不在同一层。这篇不谈概念科普,就讲接之前先核对哪几件事、出问题先看哪一层、哪些场景根本不用把两者绑一起。
很多人是这么卡住的:LangChain 那条链已经跑通了,想再加个工具调用,看到 MCP 就顺手装进来。装完发现两边都在管工具,谁调谁说不清,报错还不在同一层——LangChain 那边报参数缺失,MCP 服务本身是好的;或者反过来,服务端日志干干净净,链那边说工具不存在。这篇不谈概念科普,就说接之前先核对哪几件事、出问题先看哪一层、哪些场景根本不用把两者绑一起。
先把一句话记住:MCP 是把外部能力暴露成标准工具的那一层,LangChain 是编排调用顺序、拼上下文的那一层。两边都能注册工具,但同一套流程里只能有一边是真相来源。这个定不下来,后面每加一个工具都要重新吵一次。
先把「谁管工具」这件事定下来
判断标准其实不复杂:这个工具要不要被多个客户端复用?要,就走 MCP,让服务端成为唯一声明者,LangChain 侧只做发现和调用。只在这条链里用一次、以后也不打算给别人用,那就直接写 LangChain tool,别为了「架构统一」多搭一层。中间态最容易出问题——同一个工具在两边各注册一遍,名字还不完全一样。
实际用下来,混着用的误判几乎都长一个样:MCP 服务端声明的是 search_docs,LangChain 侧注册成了 search,模型拿到两套描述,调用时挑了个不存在的名字。调不通的时候你去看哪边日志?两边都像没问题。所以先定归属,再动手写代码。
- 真相来源
- 工具名、参数 schema、描述文本由哪一边说了算,另一边只读取不覆盖
- 复用范围
- 工具是否需要被多个客户端调用;是则归 MCP,否则归 LangChain
- 注册方式
- LangChain 侧尽量用自动发现,不要手抄一份 schema 维护
接之前照着核一遍
- 确认传输方式对得上先看这个 MCP 服务是本地进程还是远程 HTTP。LangChain 侧能接的是哪一种,要到 MCP 服务器大全(/mcp) 看该服务器的说明,别照着别的服务器的教程直接抄配置。
- 核对工具名和参数 schema把服务端声明的描述和 LangChain 侧注册后实际拿到的描述打出来对照。字段名、类型、必填项有一处不一致,模型就会瞎填参数,而且报错往往发生在很后面。
- 给工具加白名单和步数上限别等跑飞了才回头改。哪些工具允许这条链调用、最多连续调几次,写在配置里。这块思路可以直接借用 agent 跑飞的护栏做法,站内指南中心有相关整理,去 指南中心(/guides) 找当时的版本。
- 先跑一个最简单的工具挑参数最少、无副作用的那一个,完整走一次往返:模型发起调用、LangChain 转发、MCP 服务返回、结果回到上下文。这一步过了再叠业务逻辑,不然出错时你分不清是接入问题还是逻辑问题。
出问题时的排查顺序
报错不可怕,可怕的是不知道往哪层看。下面这个顺序是我建议的默认路径,从下往上,一层不过就别往上走。远程 MCP 和本地进程的失败表现差别很大,这一点在第四步会体现得很明显。
| 顺序 | 查什么 | 不过关的典型表现 |
|---|---|---|
| 第一步 | 绕开 LangChain,单独测 MCP 服务通不通 | 连接超时、握手失败、工具列表为空 |
| 第二步 | LangChain 侧注册后的工具描述是否完整 | 工具名对不上、参数类型不符、必填项丢失 |
| 第三步 | 模型输出是真调了工具,还是把调用意图写成了文本 | 回复里出现类似调用的字样但没有任何工具执行记录 |
| 第四步 | 鉴权与超时 | 远程服务返回鉴权错误,本地进程则表现为卡住不动或直接退出 |
第三步特别容易误判。模型有时候会把「我准备调用某某工具」写成一段话,看起来像在调,其实什么也没发生。判断方法很简单:看链的执行记录里有没有对应的工具节点。没有,就是没调,别去改工具参数,先改提示词里对调用格式的约束。
第四步要分开看。远程 MCP 的鉴权失败通常会明确返回错误码,配置里那一格 token 填错或者过期一眼能看出来;本地进程没配好则往往是静默卡住,日志里什么都没有。这两种情况别用同一套排查动作。
这几种情况别硬凑
- 只有一个工具、只在一个流程里用:直接写个函数最省事,MCP 带来的复用收益抵不过多一层要调的东西,出问题时还多一个变量
- LangChain 那条链本身还没稳定:先把链跑顺,再加外部能力。两个变量一起动,定位成本翻倍
- 团队里没人维护 MCP 服务端:工具描述会逐渐跟真实接口脱节,模型调用失败率反而比手写函数更高
- 流程对延迟敏感、又只需要本地能力:进程间多一跳是实打实的开销,先算清楚再决定
还有一种情况值得单独说:工具本身有副作用,比如发消息、改数据。这种工具接进来之前,先把幂等和重试策略想清楚。MCP 那边返回超时,LangChain 这边重试一次,可能就发了两条。这跟用不用 MCP 没关系,但混着用时更容易漏掉,因为你会以为重试是另一层在处理。
下一步接之前先把这个 MCP 服务的传输方式和工具声明看清楚,再决定它归哪一边管;站内收录了各家服务器的说明和接入注意点,对照着核一遍比事后调日志省事。→常见问题
MCP 和 LangChain 是不是必须一起用?
不是。MCP 解决的是工具怎么标准化暴露给不同客户端,LangChain 解决的是链怎么编排。只有一个应用、工具不多的时候,直接在 LangChain 里写工具最省事,多一层协议只增加排查成本。
工具调不通,先查哪边?
先绕开 LangChain 单独调 MCP 服务,确认服务本身返回正常。这一步过了再回来看 LangChain 侧注册的工具描述对不对,最后才怀疑模型。顺序反了会在一堆无关日志里绕很久。
两边都注册了工具会怎样?
模型可能拿到两份描述不完全一样的同名工具,选哪个不确定,参数填错也查不出来源。约定一边是唯一来源,另一边只做透传或不注册。