首页 / 接入笔记 / MCP / 工具调用

MCP 第一个工具接进来:四步跑通

2026-11-12 · MCP · 工具调用 · 接入

MCP 常被当成一个需要读完规范才能碰的东西,实际上第一个工具只需要四步,半小时内就能看到模型真的在调它。

第一步:把工具写成一份可被发现的描述

工具描述决定了模型会不会用、用得对不对。要点只有三个:名字是动词短语、描述里写清「什么时候该用」、参数逐个写类型与取值范围。描述里不要写实现细节,模型不需要知道背后是哪家模型。

第二步:确定调用通道

工具调用的结果最终还是要回到一次模型请求上。聊天走 POST /v1/chat/completions(Bearer 鉴权),需要长上下文与原生工具块时走 POST /v1/messages(x-api-key 加 anthropic-version: 2023-06-01)。同一个 Key 同时具备两条通道,是 MCP 场景最省事的配置。

第三步:把工具的返回压缩到可读长度

这是最容易被忽略、也最贵的一步。工具的原始返回经常是几十 KB 的 JSON,直接塞回模型会让输入 token 暴涨。正确的做法是先裁剪字段、再摘要、最后才交给模型,只保留决策所需的字段。

第四步:给调用加边界

至少要三条:单轮最多调用几次工具、单次返回的字符上限、调用失败后的降级路径。没有边界的 Agent 会在一次任务里把同一把工具调到十几次。

验证清单

  1. 模型能在没有额外提示的情况下选中这个工具。
  2. 参数填错时模型会自我修正一次,而不是直接放弃。
  3. 工具返回超长内容时,输入 token 没有翻倍。
  4. 工具超时后,整轮对话仍能给出可用答复。

更完整的协议写法对照见 四协议对照表,工具调用的重试与幂等见 失败重试与幂等。