전역 설치에서 `npx` 방식으로 옮기기

예전 문서에는 npm install -g slima-mcp이라고 적혀 있을 수 있는데, 이 방식은 더 이상 권장되지 않습니다. 새로운 방식은 패키지를 전역으로 설치하지 않고, 설정 파일에 바로 npx를 적어 두는 것입니다.

왜 바꾸나요

전역 설치	동적 npx
npm update를 수동으로 실행해야 합니다	실행할 때마다 최신 0.x를 자동으로 받아옵니다
여러 node 버전을 오갈 때 꼬이기 쉽습니다	영향을 받지 않습니다
사용자마다 따로 설치해야 합니다	처음 실행할 때 내려받고 캐시에 저장합니다
버전 관리 부담이 큽니다	@0이 알아서 처리해 줍니다

이전 절차

1 · 전역 설치 제거

npm uninstall -g slima-mcp

깨끗하게 빠졌는지 확인합니다:

which slima-mcp
# not found 이라고 나와야 정상입니다

2 · 클라이언트 설정을 npx 방식으로 바꾸기

다음에서:

"slima": {
  "command": "slima-mcp"
}

다음과 같이 바꿉니다:

"slima": {
  "command": "npx",
  "args": ["-y", "slima-mcp@0"]
}

3 · 클라이언트 재시작

Claude Desktop / Cursor를 완전히 종료한 뒤 다시 엽니다.

4 · 동작 확인

평소처럼 입력해 봅니다:

@slima list books

이전과 동일하게 동작해야 합니다.

토큰은 영향을 받지 않습니다

~/.slima/credentials.json은 별도로 존재하는 파일이라 npm 설치와는 아무 관계가 없습니다. 따라서 이전 작업은 여러분의 토큰에 전혀 영향을 주지 않습니다.

더 이상 수동 업데이트가 필요 없습니다

새 방식인 npx -y slima-mcp@0은 실행할 때마다 최신 0.x를 자동으로 확인하기 때문에, 따로 업그레이드 작업을 할 필요가 없습니다.

(1.0이 출시되면 그때 한 번만 @0을 @1로 직접 바꿔 주시면 됩니다. 자세한 내용은 버전 고정 전략을 참고하십시오.)

관련 문서

• 버전 고정 전략
• Claude Desktop 연결