MCP 工具搜索(MCP Tool Search)
只在需要时才加载 工具的详细信息。用图和例子讲清它是什么、怎么运作、怎么用,以及要注意什么。
它是什么
工具搜索为节省空间。MCP 可能带来很多工具,每个工具都有一段叫 的长描述。一开始 只加载工具名和服务器说明。等 决定用某个工具时,才去获取那个工具的完整 schema,所以你没在用的服务器只占很少的。
它怎么工作
-
会话开始时只有工具名
-
Claude 需要某个 MCP 工具
-
Claude 搜索并加载 schema
-
Claude 照常工具
怎么使用
-
/context显示是什么在占空间;加载的工具会标为 deferred 或按需加载。
-
ENABLE_TOOL_SEARCH=false claude关掉工具搜索,一开始就加载所有 MCP 工具。
-
ENABLE_TOOL_SEARCH=auto:5一开始就加载工具,直到超过上下文窗口的 5%,然后改用搜索。
-
"alwaysLoad": true写在服务器的
.mcp.json条目里,让这个服务器的工具一直可见。
注意
工具搜索默认是打开的,但只在较新的上有效,比如 Claude Opus 4、Sonnet 4、Haiku 4.5 及之后的模型;在旧模型上所有工具都会一开始就加载。用 alwaysLoad 预先加载的每个工具每一轮都占上下文,所以只给少数工具用。服务器作者应该把说明写得清楚简短,因为 Claude 靠读它来判断什么时候去搜索这些工具。
相关术语
原文和官方文档
本页用简单的话解释这个术语。以原文为准:如果两者不同,请按原文。
- 在原文中查看这个术语Claude Code Docs — Glossary Anthropic · 确认于 2026-10-19
- Anthropic — Claude Code docs: Connect Claude Code to tools via MCP — Scale with mcp tool search(在新窗口中打开)
- Anthropic — Claude Code docs: Connect Claude Code to tools via MCP — Configure tool search(在新窗口中打开)
- Anthropic — Claude Code docs: How Claude Code works — When context fills up(在新窗口中打开)
加载中…
加载中…
请选择要取消的待付款预约。每次取消都需要确认。
你所在国家的时间: