Claude Code v2.1.274 — MCP 안정화 5연타, "unexpected tool_use_id" 무한 재시도도 끝

MCP 서버 관련 픽스가 무려 다섯 건 들어왔습니다. MCP 연동이 일상이 된 지금, 이번 v2.1.274는 그 자체로 안정성 업그레이드입니다.

한마디로 말하면, "unexpected tool_use_id" 무한 재시작 지옥의 자가 치유, 레거시 HTTP+SSE 서버 연결 픽스 등 MCP 신뢰성 5건과 메모리 위험 경고가 핵심인 릴리스입니다.

MCP 안정화 5연타

MCP 사용자가 만나는 대표적인 고통이 정리됐습니다. 첫째, http로 설정했는데 legacy HTTP+SSE만 말하는 MCP 서버가 첫 요청에 422·4xx로 응답해 연결 실패하던 문제. 둘째, 서버별로 긴 timeout을 설정해도 Streamable HTTP tool 호출이 5분 정도에서 끊기던 문제. 셋째, 서버가 listChanged를 선언하지 않아 프롬프트·리소스가 갱신되지 않던 문제. 넷째, 403 insufficient_scope 에러가 "로그인 만료"로 오인 표시되던 것 — 이제 누락된 권한을 명시하고 /mcp 재인증을 안내합니다. 다섯째, MCP 서버가 세션 도중 끊기고 재연결이 포기될 때 /mcp를 가리키는 알림이 추가됐습니다.

"unexpected tool_use_id" 무한 루프 — 자가 치유

손상된 transcript 때문에 "unexpected tool_use_id" 400 에러를 끝없이 재시도하던 문제도 잡혔습니다. 이제 가능한 경우 transcript이 자가 치유되고, 불가능하면 /rewind 힌트가 붙은 명확한 에러로 루프를 종료합니다. 무한 재시도로 토큰을 태우던 최악의 시나리오가 사라진 것입니다.

메모리 위험 경고와 관측성

메모리 사용량이 위험 수준이면 눈에 보이는 경고와 함께 메모리 확보·안전 재시작 절차를 안내합니다. 관측성도 강화됐습니다 — claude_code.llm_request 스팬에 effort 속성이 추가되고, claude_code.managed_settings_resolved 이벤트로 관리 설정 소스와 정책 헬퍼 상태를 추적할 수 있습니다 (OTEL_LOG_MANAGED_SETTINGS=1). 게이트웨이 운영자에게는 Postgres 연결 타임아웃 설정(store.connect_timeout_seconds, 기본 5초)과 복제본 요청 256개 초과 경고도 제공됩니다.

실전에서 어떻게 쓸까?

CI·크론 등 첫 턴이 비대화형인 환경에서는 CLAUDE_CODE_MCP_STARTUP_WAIT_MS로 MCP 대기 시간을 제어하세요 — 0이면 대기 없이 바로 실행합니다. Remote Control로 팀원·에이전트 메시지를 주고받는다면 접힌 메시지의 클릭-to-확장이 추가돼 가독성이 좋아졌습니다.

MCP를 연동해 쓰는 팀이라면 이 버전은 선택이 아닌 필수입니다. 특히 403 오류 표시 개선은 "로그인 만료인 줄 알고 재로그인만 반복하던" 디버깅 시간을 그대로 줄여줍니다.

출처: https://github.com/anthropics/claude-code/releases/tag/v2.1.274

태그: AI Claude Claude Code 개발도구