자동화와 확장
3. MCP 범위와 컨텍스트 예산5 / 9

이긴 정의 하나와 지출로서의 컨텍스트

범위 우선순위, 지연 로딩, 출력 한도, 헤드리스 경로

개념 학습 45 XP 9분

MCP를 붙이는 일은 쉽고, 그래서 두 종류의 문제가 뒤늦게 옵니다. 첫째는 왜 내 설정이 안 먹히지입니다. 같은 이름의 서버가 여러 곳에 정의되면 Claude Code는 가장 높은 우선순위 정의 하나만 쓰고 필드를 병합하지 않습니다. 헤더만 project 범위에 추가해 두면 조용히 무시되는 사고가 여기서 나옵니다. 둘째는 세션이 무거워졌다입니다. 도구 정의가 차지하는 컨텍스트와 연결 대기 시간이 서버 수만큼 늘어나기 때문에, 지연 로딩·출력 한도·타임아웃을 운영값으로 정해 두지 않으면 예산이 아니라 사고로 돌아옵니다.

다이얼무엇을 조절하나기억할 값
ENABLE_TOOL_SEARCHMCP 도구 정의의 지연 로딩auto는 컨텍스트 10% 기준
alwaysLoad: true해당 서버 도구를 선로드연결까지 시작 블로킹, 5초 상한
MAX_MCP_OUTPUT_TOKENS도구 출력 토큰 상한경고 10,000 / 제한 25,000
anthropic/maxResultSizeChars결과 보존 한도 override최대 500K자, 텍스트 한정
MCP_CONNECTION_NONBLOCKING헤드리스에서 연결 대기 생략--mcp-config는 서버당 5초
서버를 늘린 비용은 시작 지연과 컨텍스트 점유로 되돌아옵니다.
  1. 범위 먼저 고정팀 공유가 필요하면 project, 개인 실험은 local로 위치를 먼저 정합니다.
  2. 전송 방식 정리원격 서버는 HTTP로 붙이고 deprecated된 SSE 설정은 남기지 않습니다.
  3. 예산 배분Tool Search를 auto로 두고 alwaysLoad는 즉시 필요한 서버만 예외로 남깁니다.
  4. 헤드리스 분리-p 경로에서 사람 입력에 의존하는 지점을 사전 설정과 훅으로 대체합니다.
이전