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

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

- Canonical: https://learning.reopt.ai/en/courses/claude-code-automation/lessons/ccau-m3-concept
- Language: en
- HTML: https://learning.reopt.ai/en/courses/claude-code-automation/lessons/ccau-m3-concept

---

[Automation and extensions](/en/courses/claude-code-automation) 3. MCP 범위와 컨텍스트 예산 5 / 9

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

범위 우선순위, 지연 로딩, 출력 한도, 헤드리스 경로
Concept 45 XP 9 min

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

| 다이얼 | 무엇을 조절하나 | 기억할 값 |
| 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초 |

서버를 늘린 비용은 시작 지연과 컨텍스트 점유로 되돌아옵니다.

- 1 범위 먼저 고정 팀 공유가 필요하면 project, 개인 실험은 local로 위치를 먼저 정합니다.

- 2 전송 방식 정리 원격 서버는 HTTP로 붙이고 deprecated된 SSE 설정은 남기지 않습니다.

- 3 예산 배분 Tool Search를 auto로 두고 alwaysLoad는 즉시 필요한 서버만 예외로 남깁니다.

- 4 헤드리스 분리 -p 경로에서 사람 입력에 의존하는 지점을 사전 설정과 훅으로 대체합니다.

실무에 남길 기준

- 같은 이름 서버는 병합되지 않으므로 다른 범위에 헤더만 추가하면 조용히 무시된다
- Tool Search는 tool_reference를 지원하는 모델이 필요하고 Haiku에서는 쓸 수 없다
- 헤드리스 -p에서는 elicitation 다이얼로그와 PermissionRequest 훅이 성립하지 않으므로 Elicitation 훅 자동 응답으로 대체한다

[Previous](/en/courses/claude-code-automation/lessons/ccau-m2-scenario) Got it · Continue

---

Site guide for agents: https://learning.reopt.ai/llms.txt · Sitemap: https://learning.reopt.ai/sitemap.xml · Contact: https://learning.reopt.ai/contact