클로드 MCP 윈도우 안될 때 해결 방법

tilnote2024-12-02 12:22

윈도우 10에서 클로드 Model Context Protocol 이 실행이 안되는 버그가 있습니다. 금방 픽스 될 것 같지만 답답함을 느끼실 분들을 위해 해결 방법을 공유드립니다.

설치할 mcp 서버를 npm 으로 전역 설치 합니다. 권한이 없다고 나올 시 관리자 권한으로 실행하면 됩니다. node가 없다면 설치해야 합니다.
filesystem 으로 예를 들겠습니다.

npm install -g @modelcontextprotocol/server-filesystem

(앞에 server- 를 붙이면 됩니다. brave-search 의 경우 server-brave-search)

이렇게 하면 다음 위치에 설치되게 됩니다.

C:\Users\YOUR_USERNAME\AppData\Roaming\npm\node_modules@modelcontextprotocol\server-filesystem\dist\index.js

만약 해당 폴더가 없으면 다음과 같이 npm 전역 설치의 경로를 확인해 보세요.

npm config get prefix

다음과 같이 node 의 mcp 서버의 실행 경로를 직접 지정해 주면 됩니다.

{
  "mcpServers": {
    "filesystem": {
      "command": "node",
      "args": [
        "C:\\Users\\[YOUR_USERNAME]\\AppData\\Roaming\\npm\\node_modules\\@modelcontextprotocol\\server-filesystem\\dist\\index.js",
        "/Users/[YOUR_USERNAME]/Desktop"
      ]
    }
  }
}

파일 경로 잘 확인해 주시구요. 경로에 \\ 로 escape 하는것 잊지 마세요.

[YOUR_USERNAME] 을 나의 사용자 이름으로 바꾸면 됩니다. 사용자 명은 c:\Users 또는 c:\사용자 에서 확인하실 수 있어요.

사용자 폴더 전체를 허용하면 접근권한이 너무 많을 수 있으니 Desktop 폴더 활용하거나 claude 폴더를 만들고 진행하겠습니다.

config 파일을 바꾸신 후 클로드 데스크탑을 완전히 종료하고 다시 실행하셔야 합니다.

좀 복잡하기는 한데 앤트로픽에서 하루 빨리 패치되기를 바라봅니다.

참고 : MCP servers fail to connect with `npx` on Windows · Issue #40 · modelcontextprotocol/servers