MCP和LangChain注意事项,第一次上手最容易卡在职责分不清

接入与开发

讲清 MCP 和 LangChain 在同一套工程里的分工边界,给出接之前要核对的清单、卡住时的排查顺序,以及什么情况下不该硬凑在一起。

很多人是这么卡住的:LangChain 那边的链已经跑通了,想再加个工具调用,看到 MCP 就顺手装进来,结果两边都在管工具,谁调谁说不清,报错还不在同一层。这篇不谈概念科普,就讲接之前先核对哪几件事、出问题先看哪一层、哪些场景根本不用把两者绑一起。

很多人是这么卡住的:LangChain 那条链已经跑通了,想再加个工具调用,看到 MCP 就顺手装进来。装完发现两边都在管工具,谁调谁说不清,报错还不在同一层——LangChain 那边报参数缺失,MCP 服务本身是好的;或者反过来,服务端日志干干净净,链那边说工具不存在。这篇不谈概念科普,就说接之前先核对哪几件事、出问题先看哪一层、哪些场景根本不用把两者绑一起。

先把一句话记住:MCP 是把外部能力暴露成标准工具的那一层,LangChain 是编排调用顺序、拼上下文的那一层。两边都能注册工具,但同一套流程里只能有一边是真相来源。这个定不下来,后面每加一个工具都要重新吵一次。

先把「谁管工具」这件事定下来

判断标准其实不复杂:这个工具要不要被多个客户端复用?要,就走 MCP,让服务端成为唯一声明者,LangChain 侧只做发现和调用。只在这条链里用一次、以后也不打算给别人用,那就直接写 LangChain tool,别为了「架构统一」多搭一层。中间态最容易出问题——同一个工具在两边各注册一遍,名字还不完全一样。

实际用下来,混着用的误判几乎都长一个样:MCP 服务端声明的是 search_docs,LangChain 侧注册成了 search,模型拿到两套描述,调用时挑了个不存在的名字。调不通的时候你去看哪边日志?两边都像没问题。所以先定归属,再动手写代码。

真相来源
工具名、参数 schema、描述文本由哪一边说了算,另一边只读取不覆盖
复用范围
工具是否需要被多个客户端调用;是则归 MCP,否则归 LangChain
注册方式
LangChain 侧尽量用自动发现,不要手抄一份 schema 维护

接之前照着核一遍

  1. 确认传输方式对得上先看这个 MCP 服务是本地进程还是远程 HTTP。LangChain 侧能接的是哪一种,要到 MCP 服务器大全(/mcp) 看该服务器的说明,别照着别的服务器的教程直接抄配置。
  2. 核对工具名和参数 schema把服务端声明的描述和 LangChain 侧注册后实际拿到的描述打出来对照。字段名、类型、必填项有一处不一致,模型就会瞎填参数,而且报错往往发生在很后面。
  3. 给工具加白名单和步数上限别等跑飞了才回头改。哪些工具允许这条链调用、最多连续调几次,写在配置里。这块思路可以直接借用 agent 跑飞的护栏做法,站内指南中心有相关整理,去 指南中心(/guides) 找当时的版本。
  4. 先跑一个最简单的工具挑参数最少、无副作用的那一个,完整走一次往返:模型发起调用、LangChain 转发、MCP 服务返回、结果回到上下文。这一步过了再叠业务逻辑,不然出错时你分不清是接入问题还是逻辑问题。

出问题时的排查顺序

报错不可怕,可怕的是不知道往哪层看。下面这个顺序是我建议的默认路径,从下往上,一层不过就别往上走。远程 MCP 和本地进程的失败表现差别很大,这一点在第四步会体现得很明显。

顺序查什么不过关的典型表现
第一步绕开 LangChain,单独测 MCP 服务通不通连接超时、握手失败、工具列表为空
第二步LangChain 侧注册后的工具描述是否完整工具名对不上、参数类型不符、必填项丢失
第三步模型输出是真调了工具,还是把调用意图写成了文本回复里出现类似调用的字样但没有任何工具执行记录
第四步鉴权与超时远程服务返回鉴权错误,本地进程则表现为卡住不动或直接退出

第三步特别容易误判。模型有时候会把「我准备调用某某工具」写成一段话,看起来像在调,其实什么也没发生。判断方法很简单:看链的执行记录里有没有对应的工具节点。没有,就是没调,别去改工具参数,先改提示词里对调用格式的约束。

第四步要分开看。远程 MCP 的鉴权失败通常会明确返回错误码,配置里那一格 token 填错或者过期一眼能看出来;本地进程没配好则往往是静默卡住,日志里什么都没有。这两种情况别用同一套排查动作。

这几种情况别硬凑

  • 只有一个工具、只在一个流程里用:直接写个函数最省事,MCP 带来的复用收益抵不过多一层要调的东西,出问题时还多一个变量
  • LangChain 那条链本身还没稳定:先把链跑顺,再加外部能力。两个变量一起动,定位成本翻倍
  • 团队里没人维护 MCP 服务端:工具描述会逐渐跟真实接口脱节,模型调用失败率反而比手写函数更高
  • 流程对延迟敏感、又只需要本地能力:进程间多一跳是实打实的开销,先算清楚再决定

还有一种情况值得单独说:工具本身有副作用,比如发消息、改数据。这种工具接进来之前,先把幂等和重试策略想清楚。MCP 那边返回超时,LangChain 这边重试一次,可能就发了两条。这跟用不用 MCP 没关系,但混着用时更容易漏掉,因为你会以为重试是另一层在处理。

下一步接之前先把这个 MCP 服务的传输方式和工具声明看清楚,再决定它归哪一边管;站内收录了各家服务器的说明和接入注意点,对照着核一遍比事后调日志省事。

常见问题

MCP 和 LangChain 是不是必须一起用?

不是。MCP 解决的是工具怎么标准化暴露给不同客户端,LangChain 解决的是链怎么编排。只有一个应用、工具不多的时候,直接在 LangChain 里写工具最省事,多一层协议只增加排查成本。

工具调不通,先查哪边?

先绕开 LangChain 单独调 MCP 服务,确认服务本身返回正常。这一步过了再回来看 LangChain 侧注册的工具描述对不对,最后才怀疑模型。顺序反了会在一堆无关日志里绕很久。

两边都注册了工具会怎样?

模型可能拿到两份描述不完全一样的同名工具,选哪个不确定,参数填错也查不出来源。约定一边是唯一来源,另一边只做透传或不注册。

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