MCP 도구 검색(MCP Tool Search)

보라색 도서 목록함에서 서랍 하나만 열려 두꺼운 설명서 한 권이 나오고 나머지 서랍은 닫혀 있는 그림.

무엇인가요

도구 검색은 의 자리를 아끼는 방식입니다. MCP 는 도구를 많이 가져올 수 있고, 도구마다 라는 긴 설명이 있습니다. 시작할 때 는 도구 이름과 서버 안내만 읽습니다. 가 어떤 도구를 쓰기로 정하면 그때 그 도구의 전체 스키마를 가져오므로, 쓰지 않는 서버는 를 거의 차지하지 않습니다.

어떻게 돌아가나요

세션은 도구 이름만 들고 시작합니다
Claude 에게 어떤 MCP 도구가 필요해집니다
Claude 가 찾아서 스키마를 불러옵니다
Claude 가 평소처럼 도구를 부릅니다

이렇게 씁니다

/context

무엇이 자리를 쓰는지 보여 주고, 미뤄 둔 도구에는 deferred·loaded on-demand 표시가 붙습니다.
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 가 그 안내를 보고 언제 도구를 찾을지 정하기 때문입니다.

원문과 공식 문서

이 페이지는 용어를 쉬운 말로 풀어 쓴 것입니다. 기준은 원문이니, 다르면 원문을 따르세요.

취소할 대기 예약을 선택하세요. 각 예약은 확인 후 취소됩니다.

내 :

닫기

알림

알림을 켜는 방법

무엇인가요

어떻게 돌아가나요

이렇게 씁니다

주의할 점

원문과 공식 문서

무엇인가요

어떻게 돌아가나요

이렇게 씁니다

주의할 점

함께 보면 좋은 용어

원문과 공식 문서