Claude Code의 MCP 서버 관리: 컨텍스트 폭발을 막는 실전 가이드
If you're serious about not blowing up your Claude Code context with MCP servers, here's the exact path I'd follow
핵심 요약
Claude Code 사용 시 MCP 서버를 무분별하게 추가하지 말고, 워크플로우에 맞춰 선별적으로 관리하여 컨텍스트 효율을 높이는 방법.
- MCP 서버 선별 — 처음부터 많이 설치하지 말고, 실제 업무에 필요한 서버 하나로 시작해서 적응함.
- 설정 파일 최적화 — `.claude.json`을 직접 확인하고, 모델이 이해하기 어려운 장황한 도구 설명을 간결하게 수정함.
- 스코프 관리 — 전역 설정(`--scope user`) 대신 프로젝트별 설정(`--scope project`)을 사용하여 필요한 도구만 노출함.
- 게이트웨이 도입 — 4개 이상의 서버를 사용할 때는 Ratel 같은 게이트웨이를 통해 도구 노출을 최적화함.
저는 7개월 동안 Claude Code를 주력 도구로 사용하면서 그동안 MCP 서버들을 추가해 왔습니다. 온갖 실수를 다 해봤죠. 오늘 다시 시작한다면 제가 따를 경로를 공유합니다.
r/ClaudeAI에서 가장 많이 보이는 실수는 첫 주에 MCP 서버를 10개 이상 설치하고는, 프롬프트를 입력하기도 전에 컨텍스트 바가 60%나 차 있는 이유를 궁금해하는 것입니다.
Pick One MCP Server And Live With It For A Week
첫날부터 MCP 6개를 한꺼번에 연결하지 마세요. 실제로 하는 작업과 연관된 서버 하나로 시작하세요. 저는 하루 종일 PR을 확인하기 때문에 GitHub MCP로 시작했습니다. 일주일 동안 사용해 보세요. 모델이 어떻게 도구를 선택하는지 지켜보고, 잘못 선택하는 순간을 포착하세요.
"MCP를 사용하는 사람"과 실제로 잘 작동하는 환경을 갖춘 사람의 차이는, 모델이 도구를 선택할 때 무엇을 신뢰해야 하고 무엇을 명시적으로 지시해야 하는지 정확히 알고 있다는 점입니다.
Read Your .claude.json Like You'd Read A Dotfile
대부분의 사람들은 README에서 복사해서 붙여넣기만 하고 설정을 들여다보지 않습니다. 그러지 마세요. ~/.claude.json을 열어보세요. 모든 서버 항목을 확인하고 모든 도구 이름을 살펴보세요. 이름과 설명만 보고 5초 안에 도구가 무슨 일을 하는지 알 수 없다면, 모델도 알 수 없습니다.
Trim Tool Descriptions Aggressively
아무도 말해주지 않는 팁입니다. MCP 사양상 서버는 장황한 설명을 포함할 수 있는데, 이게 매번 컨텍스트에 들어갑니다. 제가 쓰던 MCP 서버 중 하나는 도구 하나에 대한 설명이 1,200 토큰이나 됐습니다. 도구 하나에 말이죠. 기능을 유지하면서 설명을 제거했더니 매번 1,200 토큰을 절약하게 되었습니다.
도구 설명이 마케팅 문구처럼 읽힌다면 다시 작성하세요.
Stop Adding MCP Servers Globally By Default
--scope user를 사용하면 시작하는 모든 Claude 세션에 서버가 포함됩니다. 대부분의 서버는 그럴 필요가 없습니다. 특정 코드베이스에만 필요한 것은 --scope project를 사용하세요. 플래그를 잊어버려서 Postgres, AWS, Stripe가 전역으로 활성화된 개발자들을 보면 참 안타깝습니다.
Group Servers By Workflow, Not By Vendor
"Linear MCP가 있고 Notion MCP가 있다"고 생각하지 마세요. "지금 PM 업무를 하고 있으니 이슈 읽기 권한과 문서 읽기 권한이 필요하다"고 생각하세요. 프로젝트 스코프에 두 개의 MCP를 넣고, 유저 스코프에는 아무것도 넣지 마세요. 작업을 전환할 때 스코프를 전환하면, 모델은 필요한 도구만 보게 됩니다.
Use A Gateway When You Pass 4 Servers
활성 MCP가 4개를 넘어가면 게이트웨이 패턴이 효과를 보기 시작합니다. 모든 도구가 모델에게 직접 노출되는 대신, 모델은 search_tools + invoke_tool + auth만 보게 되고, 쿼리별로 도구의 우선순위가 정해집니다.
저는 두 가지를 시도해 봤는데 Ratel(오픈 소스, 인프로세스 실행)에 정착했습니다. 설치는 명령어 하나(npx @ ratel-ai/mcp-server mcp import로 기존 설정을 읽어와 게이트웨이를 가리키도록 Claude를 재작성하고 백업을 자동으로 생성)로 끝납니다. 내부적으로 BM25 랭킹을 사용하며, 별도의 서비스를 실행하거나 임베딩 API 비용을 낼 필요가 없습니다.
