Tool Search 와 똑똑하게 일하기
Claude Code가 수십 개의 MCP 서버로도 빠르게 유지되는 방법
⏱ 예상 ~4분
01 · 읽기
예상 못 한 문제: MCP 서버를 많이 추가할수록 Claude가 느려져요.
왜요? 각 MCP 서버가 도구를 노출하고 - 각 도구에는 Claude가 읽어야 할 설명이 있어요. 서버가 10 개고 각각 15 개의 도구를 가지면, 질문을 던지기 전부터 150 개의 도구 설명이 Claude 의 컨텍스트 윈도우에 로드돼요. 그게 실제 대화를 위한 공간을 잡아먹어요.
회의에 들어가는데 모두가 프로젝트를 논의하기 전에 다른 사람의 전체 이력서를 읽어야 한다고 상상해 봐요.
핵심 정리
- 각 MCP 도구에는 컨텍스트 토큰을 소비하는 설명이 있어요
- 더 많은 서버 = 더 많은 도구 설명 = 더 적은 대화 공간
- 10+ 개의 서버는 컨텍스트의 상당 부분을 소비할 수 있어요
- 이게 Tool Search 가 해결하는 문제예요
02 · 읽기
Tool Search 가 Claude Code의 해법이에요. 모든 서버의 모든 도구를 미리 로드하는 대신, 미뤄요. 질문을 하면 Claude가 검색 도구로 어떤 MCP 도구가 관련 있는지 찾고, 그것만 로드하고, 진행해요.
자동이에요 - 설정할 필요가 없어요. Tool Search 는 MCP 도구 설명이 컨텍스트 윈도우의 10% 를 넘을 때 활성화돼요.
결과는요? 쓸데없는 도구로 컨텍스트를 낭비하지 않고 수십 개의 MCP 서버를 연결할 수 있어요.
핵심 정리
- Tool Search 는 MCP 도구를 미리가 아니라 필요할 때 로드해요
- 도구가 컨텍스트의 10% 를 넘을 때 자동으로 활성화돼요
- Claude 의 현재 작업에 실제로 필요한 도구만 로드해요
- 성능 비용 없이 많은 MCP 서버를 돌릴 수 있게 해줘요
03 · 코드 예제
Tool Search 는 기본적으로 켜져 있지만 조정할 수 있어요. ENABLE_TOOL_SEARCH 환경변수가 동작을 제어해요.
기본값 (auto - 컨텍스트의 10% 사용 시 활성화)
claude
커스텀 임계값 (5% 에서 활성화)
ENABLE_TOOL_SEARCH=auto:5 claude
완전 비활성화 (모든 도구 미리 로드)
ENABLE_TOOL_SEARCH=false claude
대부분의 사용자는 이걸 바꿀 필요가 없어요 - 기본 auto 모드가 잘 작동해요. 서버가 많으면 임계값을 낮춰요. 도구 발견에 문제가 있어서 디버그할 때만 꺼요.
04 · 읽기
Claude Code 안에서 /mcp 명령은 MCP 서버를 위한 컨트롤 패널이에요. /mcp 를 타이핑하면 연결된 모든 서버와 상태를 봐요.
녹색은 연결됨이에요. 서버에 인증이 필요하면 (GitHub 나 Sentry 처럼), /mcp 가 OAuth 로그인을 안내해요 - 브라우저를 열고, 로그인하면, Claude가 접근 권한을 받아요.
인증을 지우거나, 에러를 보거나, 각 서버가 제공하는 도구를 볼 수도 있어요. /mcp 를 모든 MCP 연결의 대시보드라고 생각해 봐요.
핵심 정리
- /mcp 는 모든 서버와 연결 상태를 보여줘요
- OAuth 서버 인증에 사용해요 (GitHub, Sentry 등)
- 필요할 때 'Clear authentication' 으로 접근 권한 초기화
- MCP 서버가 작동하지 않을 때 가장 먼저 확인하는 곳
05 · 퀴즈
MCP 서버를 20 개 설정했는데 Claude가 느려진 것 같아요. 어떤 기능이 자동으로 컨텍스트 사용량을 줄이고 도구를 필요할 때 로드할까요?
- MCP 캐싱
- Server batching
- Tool Search
- Context 압축
06 · 빈칸 채우기
Claude Code 안에서 /_____ 를 타이핑하면 모든 MCP 서버 상태를 보고 OAuth 서비스와 인증할 수 있어요.
⚠ 전체 인터랙티브 경험에는 JavaScript가 필요해요. JavaScript를 켜고 새로 고침해 주세요.
※ 이 사이트는 독립 운영되는 교육 프로젝트로, Anthropic의 공식 제품이 아니에요. Claude™ 는 Anthropic, PBC 의 상표예요.