Claude Code의 MCP Tool Search 기능 완벽 가이드
🎧 Voice Briefing
📅 Generated: 2026. 1. 15. 오전 11:25:42
⏱️ Duration: ~69s
Claude Code의 MCP Tool Search 기능
🎯 한눈에 보는 핵심 요약
3줄 요약
-
MCP 도구가 너무 많으면 Claude의 "기억 공간(Context)"을 많이 차지함
-
Tool Search는 필요한 도구만 그때그때 불러오는 스마트한 방식
-
결과: 더 빠르고, 더 효율적인 Claude Code 사용 가능!
🤔 Context(컨텍스트)가 뭐예요?
비유: Claude의 "작업 책상"
Claude Code를 사용할 때, Claude에게는 제한된 크기의 작업 책상이 있다고 생각해보세요.
┌─────────────────────────────────────────────────────────┐
│ Claude의 작업 책상 │
│ (Context Window) │
│ ┌─────────┐ ┌─────────┐ ┌─────────┐ ┌─────────┐ │
│ │ 대화 │ │ 파일 │ │ MCP │ │ 시스템 │ │
│ │ 내용 │ │ 내용 │ │ 도구들 │ │ 설정 │ │
│ └─────────┘ └─────────┘ └─────────┘ └─────────┘ │
│ │
│ 💡 책상이 꽉 차면? → 오래된 정보부터 잊어버림! │
└─────────────────────────────────────────────────────────┘
Context = Claude가 한 번에 기억할 수 있는 정보의 총량
- 여러분과의 대화 내용
- 읽은 파일 내용
- 사용 가능한 도구 설명
- 시스템 설정 등
이 모든 것이 하나의 제한된 공간에 들어가야 합니다!
😰 문제 상황: MCP 도구가 책상을 다 차지해버림!
MCP란?
Model Context Protocol - Claude가 외부 도구들(Notion, 웹 브라우저, 데이터베이스 등)과 소통하는 방법입니다.
문제 발생!
pie title Context 사용량 (Tool Search 적용 전)
"MCP 도구 설명" : 67
"실제 대화/작업" : 33
실제 사례
어떤 사용자는 7개 이상의 MCP 서버를 연결했더니...
67,000+ 토큰이 도구 설명에만 사용됨! 😱
👉 정작 중요한 대화나 파일 분석에 쓸 공간이 부족해짐
비유로 이해하기: 도서관 사서
| 상황 | Before (기존 방식) | After (Tool Search) |
|---|---|---|
| 비유 | 모든 책을 책상 위에 올려놓음 | 필요한 책만 서가에서 가져옴 |
| 결과 | 책상이 꽉 참 📚📚📚 | 책상이 깔끔함 📖 |
| 효율 | 낮음 ❌ | 높음 ✅ |
✨ 해결책: Tool Search 기능
작동 방식
flowchart TD
A[Claude Code 시작] --> B{MCP 도구들이 Context의<br>10% 이상 차지?}
B -->|아니오| C[기존 방식 유지<br>모든 도구 미리 로드]
B -->|예| D[Tool Search 활성화!]
D --> E[도구 설명을 검색 인덱스로 저장]
E --> F[사용자 요청 분석]
F --> G[필요한 도구만 검색해서 로드]
G --> H[작업 수행]
style D fill:#10b981,color:#fff
style G fill:#3b82f6,color:#fff
비유: 스마트 도구 창고
Before vs After 비유
🔴 Before (기존 방식)
목수가 작업할 때 모든 도구를 작업대 위에 올려놓음
- 망치, 톱, 드라이버, 드릴, 줄자, 수평계, 끌, 대패...
- 작업대가 너무 복잡해서 정작 나무 올려놓을 공간이 없음!
🟢 After (Tool Search)
도구는 정리된 창고에 두고, 필요할 때만 가져옴
- "못 박아야지" → 망치만 꺼냄 🔨
- "나사 조여야지" → 드라이버만 꺼냄 🪛
- 작업대는 항상 깔끔! 나무 작업에 집중 가능!
📊 Claude Code 사용자를 위한 Context 관리 인사이트
Context가 중요한 이유
Context = Claude의 단기 기억
인간도 한 번에 7±2개의 정보만 기억할 수 있듯이,
Claude도 Context Window 안의 정보만 활용할 수 있습니다.
Context 효율성 공식:
┌────────────────────────────────────────────────┐
│ │
│ 유용한 작업 공간 = 전체 Context - 고정 오버헤드 │
│ │
│ 📈 고정 오버헤드가 줄면 → 실제 작업 공간 증가! │
│ │
└────────────────────────────────────────────────┘
실전 팁: Context 최적화 방법
Claude Code Context 최적화 5가지 팁
-
🔧 Tool Search 활용 - MCP 도구가 많다면 자동 활성화됨
-
📁 필요한 파일만 열기 - 관련 없는 파일은 Context를 낭비
-
🗑️ 대화 정리 -
/clear로 오래된 대화 정리 -
📝 명확한 지시 - 짧고 명확한 프롬프트가 효율적
-
🎯 작업 분할 - 큰 작업은 작은 단위로 나누기
Context 사용량 비교
| 구분 | Tool Search 없음 | Tool Search 있음 | 절약량 |
|---|---|---|---|
| MCP 도구 7개 | 67,000 토큰 | ~6,700 토큰 | 90% 절약! |
| 실제 작업 공간 | 33% | 93% | +60%p |
| 응답 품질 | 제한적 | 향상됨 | ⬆️ |
🛠️ 개발자를 위한 참고사항
MCP 서버 개발자라면?
server instructions 필드 활용하기
Tool Search가 활성화되면, server instructions 필드가 더 중요해집니다.
- Claude가 언제 여러분의 도구를 검색해야 하는지 알려주는 역할
- Skills 시스템과 유사하게 작동
MCP 클라이언트 개발자라면?
ToolSearchTool 구현 권장
공식 문서: Tool Search Tool 문서
Claude Code는 커스텀 검색 함수로 이를 구현했습니다.
🔮 앞으로의 발전 방향
Programmatic Tool Calling
MCP 도구들을 코드로 조합하는 기능도 실험 중이지만,
우선 Context 사용량 감소가 더 시급한 문제라서 Tool Search를 먼저 출시했습니다.
💬 마무리
┌─────────────────────────────────────────────────────────┐
│ │
│ 🎉 Tool Search = Claude Code의 "스마트 정리 도우미" │
│ │
│ ✅ 도구가 많아도 OK │
│ ✅ Context 효율 극대화 │
│ ✅ 더 긴 대화, 더 큰 파일 분석 가능 │
│ │
└─────────────────────────────────────────────────────────┘
핵심 메시지
Context는 Claude의 가장 귀중한 자원입니다.
Tool Search는 이 자원을 현명하게 사용하도록 도와줍니다.
마치 좋은 정리 습관이 생산성을 높이듯이,
효율적인 Context 관리가 AI 활용 능력을 높여줍니다! 🚀
🔗 관련 링크
📜 원문 (Original)
Tool Search now in Claude Code
Today we're rolling out MCP Tool Search for Claude Code. As MCP has grown to become a more popular protocol and agents have become more capable, we've found that MCP servers may have up to 50+ tools and take up a large amount of context.
Tool Search allows Claude Code to dynamically load tools into context when MCP tools would otherwise take up a lot of context.
How it works: - Claude Code detects when your MCP tool descriptions would use more than 10% of context - When triggered, tools are loaded via search instead of preloaded Otherwise, MCP tools work exactly as before.
This resolves one of our most-requested features on GitHub:
. Users were documenting setups with 7+ servers consuming 67k+ tokens. If you're making a MCP server Things are mostly the same, but the "server instructions" field becomes more useful with tool search enabled. It helps Claude know when to search for your tools, similar to skills If you're making a MCP client We highly suggest implementing the ToolSearchTool,
. We implemented it with a custom search function to make it work for Claude Code. What about programmatic tool calling? We experimented with doing programmatic tool calling such that MCP tools could be composed with each other via code. While we will continue to explore this in the future, we felt the most important need was to get Tool Search out to reduce context usage.
Tell us what you think here or on Github as you see the ToolSearchTool work.