MCP 工具搜索(MCP Tool Search)
只在需要时才加载 工具的详细信息。用图和例子讲清它是什么、怎么运作、怎么用，以及要注意什么。
它是什么
工具搜索为节省空间。可能带来很多工具，每个工具都有一段叫 的长描述。一开始 只加载工具名和说明。等 决定用某个工具时，才去获取那个工具的完整 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(在新窗口中打开)