MCP와 세션 처리 개선
MCP 설정, 세션 동작, 플러그인 정책과 여러 오류 처리가 함께 개선됐다.
교안에 영향
MCP 설정과 플러그인 정책 안내, `/compact`와 `/plugin enable`·`/plugin disable` 관련 예전 설명은 일부 맞지 않을 수 있다.
요약
- MCP `headersHelper` 스크립트에 `CLAUDE_CODE_MCP_SERVER_NAME`, `CLAUDE_CODE_MCP_SERVER_URL` 환경 변수가 추가됐다. - hooks에 조건부 `if` 필드가 들어가고, PreToolUse hooks가 `AskUserQuestion`을 처리할 수 있게 됐다. - `/compact`, `/plugin enable`, `/plugin disable`, `--worktree` 등에서 발생하던 여러 오류가 수정됐다. - 조직 정책으로 차단된 플러그인은 설치·활성화할 수 없고 마켓플레이스에서도 숨겨진다. - 대화 기록, 스트리밍, 원격 세션, 터미널 입력과 표시 관련 동작이 여러 군데에서 개선됐다.
바뀐 것
새 기능
- MCP `headersHelper` 스크립트에 `CLAUDE_CODE_MCP_SERVER_NAME`과 `CLAUDE_CODE_MCP_SERVER_URL` 환경 변수가 추가되어 하나의 helper로 여러 서버를 처리할 수 있게 됐다.
- hooks에 권한 규칙 문법의 조건부 `if` 필드가 추가되어 실행 시점을 걸러낼 수 있게 됐다.
- 스케줄된 작업(`/loop`, `CronCreate`)이 실행될 때 transcript에 타임스탬프 표시가 추가됐다.
- 이미지를 붙여넣을 때 `[Image #N]` 자리표시자 뒤에 공백이 추가됐다.
- deep link 쿼리(`claude-cli://open?q=…`)가 최대 5,000자까지 지원되고 긴 사전 입력 프롬프트에는 검토 경고가 표시된다.
- 조직 정책으로 차단된 플러그인은 설치나 활성화가 되지 않으며 마켓플레이스 보기에서도 숨겨진다.
- PreToolUse hooks가 `permissionDecision: "allow"`와 `updatedInput`을 반환해 `AskUserQuestion`을 처리할 수 있게 됐다.
개선
- MCP OAuth가 RFC 9728 Protected Resource Metadata discovery를 따라 authorization server를 찾도록 바뀌었다.
기타
- OpenTelemetry tool_result 이벤트의 `tool_parameters`는 `OTEL_LOG_TOOL_DETAILS=1`일 때만 기록되도록 바뀌었다.
수정
- 대화가 너무 길어 `/compact` 자체가 들어가지 못할 때 `context exceeded` 오류가 나던 문제가 수정됐다.
- 플러그인 설치 위치가 설정의 선언 위치와 다를 때 `/plugin enable`과 `/plugin disable`이 실패하던 문제가 수정됐다.
- 비 git 저장소에서 `--worktree`가 `WorktreeCreate` hook 전에 오류로 종료되던 문제가 수정됐다.
- `deniedMcpServers` 설정이 claude.ai MCP 서버를 막지 못하던 문제가 수정됐다.
- computer-use 도구의 `switch_display`가 다중 모니터 환경에서 "not available in this session"을 반환하던 문제가 수정됐다.
- `OTEL_LOGS_EXPORTER`, `OTEL_METRICS_EXPORTER`, `OTEL_TRACES_EXPORTER`가 `none`일 때 충돌하던 문제가 수정됐다.
- 비기본 빌드에서 diff 구문 강조가 동작하지 않던 문제가 수정됐다.
- refresh token이 있어도 `403 insufficient_scope`를 받으면 MCP step-up authorization 재인증 흐름이 제대로 시작되도록 수정됐다.
- 원격 세션에서 스트리밍 응답이 중단될 때 발생하던 메모리 누수가 수정됐다.
- edge 연결 변동 시 지속되던 `ECONNRESET` 오류가 재시도 때 새 TCP 연결을 쓰도록 수정됐다.
- 일부 슬래시 명령 실행 뒤 프롬프트가 큐에 갇히고 위 화살표로 다시 불러오지 못하던 문제가 수정됐다.
- `type:'sdk'` MCP 서버를 `--mcp-config`로 넘길 때 시작 과정에서 사라지던 Python Agent SDK 문제가 수정됐다.
- SSH나 VS Code 통합 터미널에서 실행할 때 원시 키 시퀀스가 프롬프트에 보이던 문제가 수정됐다.
- 권한이 해결된 뒤에도 Remote Control 세션 상태가 "Requires Action"에 머물던 문제가 수정됐다.
- 자동완성 제안이 `shift+enter`와 `meta+enter`를 가로채 새 줄 입력이 되지 않던 문제가 수정됐다.
- 스트리밍 중 위로 스크롤할 때 오래된 내용이 비치던 문제가 수정됐다.