MCP의 2026-07-28 Breaking Change를 위한 무료 Claude Skill + 체크 도구 제작 및 제작 과정에서 배운 점
요약
MCP의 대규모 Breaking Change에 대응하기 위해 결정론적 규칙 엔진 기반의 체크 도구와 Claude Skill을 제작했습니다. LLM의 추측 대신 스펙에 근거한 검증을 지향하며, 제작 과정에서 겪은 오류와 교훈을 공유합니다.
핵심 포인트
- MCP 2026-07-28 개정에 따른 마이그레이션 도구 제작
- LLM의 추측이 아닌 결정론적 규칙 엔진 기반 검증 방식 채택
- 웹 데모와 Claude Code용 Skill 두 가지 인터페이스 제공
- 결정론적 시스템도 잘못된 사실을 확신할 수 있음을 사례로 증명
- 주장을 검증 가능하게 만들고 실제로 검증하는 프로세스의 중요성
MCP 2026-07-28 개정은 프로토콜이 겪은 가장 큰 Breaking Change (상태 비저장 전송 (stateless transport), Mcp-Session-Id 폐지, OAuth 2.1)입니다. 마이그레이션은 단순한 버전 업그레이드가 아닌 리팩토링 (refactor) 수준이며, 현재 많은 공개 서버들이 조용히 작동 불능 상태에 빠져 있습니다.
제작 이유: 이런 종류의 도구들을 위한 대부분의 "체크 도구 (checkers)"는 단순히 LLM이 코드를 읽고 추측하는 방식입니다. 저는 결정론적 (deterministic)인 것을 원했습니다. 동일한 입력에 대해 동일한 출력을 내놓고, 모든 발견 사항이 정확한 스펙 (spec) 페이지에 근거하여 사용자가 신뢰하는 대신 직접 검증할 수 있도록 하고 싶었습니다.
제작 방식: 하나의 순수 규칙 엔진 (7개 규칙)을 기반으로 하며, 두 가지 인터페이스로 제공됩니다:
🌐 웹 데모 (Web demo) — 엔드포인트 (endpoint)를 붙여넣으면 등급이 매겨진 보고서를 받습니다. 설치가 필요 없으며 아무것도 저장되지 않습니다.
🧩 Claude Skill — SKILL.md와 의존성이 없는 번들형 체크 도구가 포함되어 있습니다. Claude Code에서는 진단 및 마이그레이션을 수행하며, 압축을 풀면 어떤 에이전트 (agent) (Codex, Cursor 등)에서도 체크 도구를 실행할 수 있습니다.
실제로 배운 점 — MCP를 다루지 않더라도 가치가 있는 교훈:
제 규칙 중 하나가 확신에 차서 틀렸었습니다. 사용자들에게 SDK를 ^2 버전으로 업그레이드하라고 안내했는데, 이는 존재하지 않는 버전이었습니다 (1.30.0에서 멈춤). 그래서 저는 "v2는 존재하지 않는다"라고 말하며 해당 규칙을 삭제했습니다... 하지만 패키지 이름 변경 (package rename)으로서 v2는 존재했습니다. 알고 보니 "이것은 존재하지 않는다"와 "당신이 잘못된 곳을 찾았다"는 동일한 증거를 만들어냅니다. 이름 변경은 마치 부재(absence)와 똑같이 보이기 때문입니다. 결정론적 (Deterministic)이라고 해서 반드시 정확한 (correct) 것은 아닙니다.
현재 README에는 "틀렸던 규칙 (A rule that was wrong)"이라는 섹션이 있으며, 두 가지 실수를 모두 고정(pinning)하는 테스트를 포함하여 실수가 재발하지 않도록 했습니다. 이러한 실패 모드는 현재 에이전트가 코드를 작성하는 모든 곳에서 나타납니다. 즉, 사실이 아님에도 불구하고 확신에 차 있고, 그럴듯하며, 내부적으로 일관된 주장들입니다. 해결책은 "덜 신뢰하는 것"이 아니라, 주장을 검증 가능하게 만들고, 실제로 검증하는 것입니다.
저장소 (MIT, 약 86개 테스트): Github
규칙에 대한 수정 사항을 보내주는 것이 가장 유용한 도움입니다. 이 프로젝트는 이미 틀렸던 규칙 하나를 수정하여 배포했습니다.
⭐ 이 도구가 고장 난 서버를 찾는 데 도움이 되었다면 추천을 눌러주세요.
제출자: /u/Fearzigdotss [link] [comments]
AI 자동 생성 콘텐츠
본 콘텐츠는 r/ClaudeAI의 원문을 AI가 자동으로 요약·번역·분석한 것입니다. 원 저작권은 원저작자에게 있으며, 정확한 내용은 반드시 원문을 확인해 주세요.
원문 바로가기