slima-mcp 버전은 어떻게 동작하는가

한 줄로: slima-mcp의 버전이 어떻게 동작하는지 설명합니다. 서버는 낡은 버전을 막지 않고, 낡은 버전은 그저 호출할 도구가 적을 뿐입니다. 지금 어느 버전을 쓰고 있는지 확인하는 방법도 함께 다룹니다.

현재 버전

slima-mcp 0.3.0, 2026-09-09 배포. 그 앞 버전인 0.2.0은 2026-04-24 것이라 넉 달 넘게 벌어져 있습니다. 그래서 여기서 「마이너 하나 차이」는 실제 격차를 크게 줄여 말하는 표현입니다.

0.2.0에는 작품, 파일, AI 베타 리더 도구가 있었습니다. 0.3.0에서 더해진 것은 이렇습니다.

• 구조화 편집 도구(update_beat_board / update_timeline / update_script / update_relationship_map / update_world_map)
• 규칙을 알려 주는 도구 묶음(get_capabilities / list_guides / load_guide / list_writing_skills / load_writing_skill)
• 메모와 코멘트, 그리고 semantic_search
• view_relationship_map
• get_reader_test. 대기 시간을 넘겨 아직 안 끝난 AI 베타 리더 리포트를 나중에 받아 오는 도구입니다

서버는 여러분의 버전을 어떻게 보는가

호출마다 클라이언트가 User-Agent에 자기 버전을 실어 보냅니다. 서버는 그것을 두 기준선과 비교합니다.

기준선	현재 값	뜻
권장 버전	0.3.0	이보다 낮으면 업그레이드 안내가 붙지만 동작은 그대로입니다
하드 하한	0.1.0	이보다 낮을 때만 차단됩니다. 이 선은 보안 문제나 파괴적 변경을 위해 남겨 둔 것입니다

즉 버전이 뒤처졌다고 서비스가 거부되지는 않습니다. 낡은 클라이언트의 도구도 그대로 동작합니다. 부족한 것은 호출할 도구입니다. 서버가 무언가를 감추는 게 아니라, 그 도구들이 여러분 손에 있는 패키지에 아예 존재하지 않는 것입니다.

버전이 뒤처져 있으면 신호가 두 개 나타납니다.

• 모든 응답에 X-Slima-MCP-Upgrade-Hint 헤더가 붙어, 권장 버전과 현재 버전을 함께 알려 줍니다
• 오류 메시지에 업그레이드 설명 문단이 하나 더 붙습니다

유독 0.3.0을 챙겨야 하는 이유

지금 어느 버전을 쓰는지 확인하기

웹 커넥터(claude.ai, ChatGPT)를 쓴다면 확인할 것도 할 일도 없습니다. 원격 서버는 항상 최신이고, 다음 대화부터 새 버전입니다.

로컬(Claude Desktop, Cursor, Gemini CLI, VS Code)이라면 이렇습니다.

# 실제로 실행되는 버전
npx -y slima-mcp@0 --version

# npm에 올라간 최신 버전
npm view slima-mcp version

# 남아 있는 글로벌 설치 — 가장 흔한 원인
npm ls -g slima-mcp

앞의 두 값이 다르면, 무언가가 여러분을 낡은 버전에 붙잡아 두고 있습니다.

업그레이드하기

설정이 npx를 쓴다면 글로벌 설치를 먼저 지우고 클라이언트를 다시 시작하십시오.

npm uninstall -g slima-mcp

이 단계는 정리 정돈이 아니라 필수입니다. npx pkg@<범위>는 이미 PATH에 있는 패키지로 그 범위를 만족시킬 수 있으면 레지스트리에 아예 묻지 않습니다. 2026-09-09에 글로벌 0.2.0이 깔린 상태에서 npm 최신이 0.3.0일 때 직접 측정한 결과입니다.

명령	실제로 실행된 버전
npx -y slima-mcp@0	0.2.0 — 글로벌 설치를 사용
npx -y slima-mcp	0.2.0 — 마찬가지
npx -y slima-mcp@latest	0.3.0 — dist-tag는 레지스트리 조회를 강제합니다
npx -y [email protected]	0.3.0 — 글로벌 사본으로는 정확한 상위 버전을 만족시킬 수 없습니다

그래서 낡은 글로벌 설치를 남겨 두면 npx 방식은 영원히 업그레이드되지 않고, 서버는 계속 업그레이드하라고 알려 줍니다.

⚠️ 설치했을 가능성이 있는 모든 자리를 확인하십시오. 글로벌 설치는 Node 버전 관리 환경마다 하나씩, 운영체제마다 하나씩 존재할 수 있습니다. WSL에서는 nvm 아래에 하나, Windows의 AppData/Roaming/npm 아래에 또 하나가 서로 다른 버전으로 깔려 있고, 그중 하나만 MCP 클라이언트가 실제로 쓰는 PATH에 올라 있는 경우가 흔합니다.

계속 글로벌 설치를 쓰겠다면 이 명령을 종종 직접 돌리는 일을 기억해 두십시오.

npm install -g slima-mcp@latest

설정에 @latest가 아니라 @0이라고 쓰는 이유

그건 메이저 버전의 파괴적 변경에 관한 다른 이야기입니다. 왜 slima-mcp@0인가에 있습니다. 글로벌 설치에서 npx로 옮기는 전체 절차는 글로벌 설치에서 옮기기에 있습니다.

관련 문서

• Docs: 왜 slima-mcp@0인가: 버전 고정 정책
• Docs: npm install -g에서 npx로 옮기기
• Docs: slima-mcp CLI 명령 모음
• Docs: 가이드와 글쓰기 스킬
• Docs: 구조화 편집 도구