이긴 정의 하나와 지출로서의 컨텍스트
범위 우선순위, 지연 로딩, 출력 한도, 헤드리스 경로
MCP를 붙이는 일은 쉽고, 그래서 두 종류의 문제가 뒤늦게 옵니다. 첫째는 왜 내 설정이 안 먹히지입니다. 같은 이름의 서버가 여러 곳에 정의되면 Claude Code는 가장 높은 우선순위 정의 하나만 쓰고 필드를 병합하지 않습니다. 헤더만 project 범위에 추가해 두면 조용히 무시되는 사고가 여기서 나옵니다. 둘째는 세션이 무거워졌다입니다. 도구 정의가 차지하는 컨텍스트와 연결 대기 시간이 서버 수만큼 늘어나기 때문에, 지연 로딩·출력 한도·타임아웃을 운영값으로 정해 두지 않으면 예산이 아니라 사고로 돌아옵니다.
| 다이얼 | 무엇을 조절하나 | 기억할 값 |
|---|---|---|
| ENABLE_TOOL_SEARCH | MCP 도구 정의의 지연 로딩 | auto는 컨텍스트 10% 기준 |
| alwaysLoad: true | 해당 서버 도구를 선로드 | 연결까지 시작 블로킹, 5초 상한 |
| MAX_MCP_OUTPUT_TOKENS | 도구 출력 토큰 상한 | 경고 10,000 / 제한 25,000 |
| anthropic/maxResultSizeChars | 결과 보존 한도 override | 최대 500K자, 텍스트 한정 |
| MCP_CONNECTION_NONBLOCKING | 헤드리스에서 연결 대기 생략 | --mcp-config는 서버당 5초 |
- 범위 먼저 고정팀 공유가 필요하면 project, 개인 실험은 local로 위치를 먼저 정합니다.
- 전송 방식 정리원격 서버는 HTTP로 붙이고 deprecated된 SSE 설정은 남기지 않습니다.
- 예산 배분Tool Search를 auto로 두고 alwaysLoad는 즉시 필요한 서버만 예외로 남깁니다.
- 헤드리스 분리-p 경로에서 사람 입력에 의존하는 지점을 사전 설정과 훅으로 대체합니다.