Claude Code의 도구 선택 성능 저하 원인과 해결책: MCP 서버 관리

실용적 조언

사용자는 Claude Code에서 도구 선택 오류가 잦아지자 모델 성능 저하를 의심했다. 그러나 컨텍스트 윈도우를 확인한 결과, 전역으로 설치된 수많은 MCP 서버의 도구 설명이 매 턴마다 로드되어 컨텍스트를 점유하고 있었다.

첫 번째 해결책은 `--scope project`를 사용하여 프로젝트별로 필요한 서버만 로드하는 방식이다. 이를 통해 세션마다 불필요한 도구 정의가 로드되는 문제를 방지했다.

두 번째 해결책은 게이트웨이를 도입하여 모델이 모든 도구를 직접 보지 않게 하는 방식이다. `ratel`과 같은 도구를 사용하여 도구 카탈로그를 검색하고 관련 도구만 랭킹하여 제공함으로써 모델의 혼란을 줄였다.

모델 컨텍스트 프로토콜(MCP): — Model Context Protocol의 약자로, AI 모델이 외부 데이터나 도구에 안전하게 접근할 수 있도록 표준화된 인터페이스를 제공하는 프로토콜이다. 다양한 데이터 소스와 도구를 모델에 연결하여 에이전트 기능을 확장하는 데 사용된다.
컨텍스트 윈도우(Context Window): — LLM이 한 번의 입력으로 처리할 수 있는 토큰의 최대 범위이다. 이 영역에 도구 정의, 이전 대화 기록, 시스템 프롬프트 등이 포함되며, 너무 많은 정보가 주입되면 모델의 추론 성능이 저하될 수 있다.
도구 호출(Tool Calling): — LLM이 외부 API나 함수를 실행하여 정보를 검색하거나 작업을 수행하는 기능이다. 모델은 도구의 설명과 스키마를 보고 적절한 도구를 선택하여 호출한다.

Claude Code추천

메인 개발 드라이버

MCP중립

모델 컨텍스트 프로토콜

Ratel추천링크

도구 게이트웨이