Windows에서 Claude MCP 파일시스템 설정하기: 문제 해결과 교훈

서론

이 글은 Windows 환경에서 Claude의 Model Context Protocol (MCP) 파일시스템을 설정하는 과정에서 겪은 문제와 해결 방법을 공유합니다. 특히 JSON 설정 파일의 백슬래시() 처리와 관련된 여러 시행착오를 통해 배운 교훈을 정리했습니다.

문제의 발단

처음 MCP 파일시스템을 설정할 때 다음과 같은 여러 문제들이 발생했습니다:

1. 설정 파일의 경로 문자열 처리 문제

2. 다중 디렉토리 접근 시도 시 발생하는 오류

3. PowerShell에서 JSON 생성 시 백슬래시 이스케이프 문제

시도했던 접근 방식들

1차 시도: 기본 PowerShell 객체 변환 방식

$config = @{

    mcpServers = @{

        filesystem = @{

            command = "node"

            args = @(

                "C:UsersreasonofmoonAppDataRoamingnpmnode_modules@modelcontextprotocolserver-filesystemdistindex.js",

                "C:UsersreasonofmoonDesktop"

            )

        }

    }

}

$jsonContent = $config | ConvertTo-Json -Depth 10 -Compress

결과: 백슬래시가 부적절하게 처리되어 파일시스템 접근 실패

2차 시도: 백슬래시 수동 변환

$jsonContent = $jsonContent.Replace('', '')

결과: 백슬래시가 과도하게 중복되어 JSON 파싱 오류 발생

3차 시도: Here-String 사용

$jsonContent = @'

{

    "mcpServers": {

        "filesystem": {

            "command": "node",

            "args": [

                "C:UsersreasonofmoonAppDataRoamingnpmnode_modules@modelcontextprotocolserver-filesystemdistindex.js",

                "C:UsersreasonofmoonDesktop"

            ]

        }

    }

}

'@

결과: 성공! 정확한 JSON 형식과 올바른 백슬래시 이스케이프 처리

해결책과 교훈

최적의 해결 방법

1. Here-String(@'...'@) 사용하여 JSON 직접 작성

2. 백슬래시는 두 번씩 이스케이프 처리

3. 경로는 한 번에 하나의 디렉토리만 설정

4. 설정 변경 후 항상 Node.js와 Claude 프로세스 재시작

작동하는 최종 설정 스크립트

# 1. 설정 파일 생성

$jsonContent = @'

{

    "mcpServers": {

        "filesystem": {

            "command": "node",

            "args": [

                "C:UsersreasonofmoonAppDataRoamingnpmnode_modules@modelcontextprotocolserver-filesystemdistindex.js",

                "C:UsersreasonofmoonDesktop"

            ]

        }

    }

}

'@

Set-Content "$env:APPDATAClaudeclaude_desktop_config.json" $jsonContent

# 2. 프로세스 정리

Get-Process -Name "node" | Stop-Process -Force

Get-Process | Where-Object {$_.ProcessName -like "*claude*"} | Stop-Process -Force

# 3. Claude 앱 재시작

주의사항과 팁

1. JSON 형식 관련

   • Windows 경로의 백슬래시는 반드시 이중으로 이스케이프(``)

   • Here-String 사용 시 JSON 형식 직접 지정이 더 안정적

   • JSON 유효성 검사툴로 설정 파일 확인 권장

2. 프로세스 관리

   • 설정 변경 후 반드시 Node.js 프로세스 종료

   • Claude 앱 완전 종료 후 재시작

   • 작업 관리자에서 관련 프로세스 확인

3. 경로 설정

   • 처음에는 한 개의 경로만 설정

   • 테스트 후 추가 경로 설정

   • 절대 경로 사용 권장

결론

Windows 환경에서 Claude MCP 설정 시 가장 중요한 것은 JSON 형식의 정확성과 백슬래시 처리입니다. Here-String을 사용한 직접 JSON 작성 방식이 가장 안정적이며, 설정 변경 후에는 반드시 관련 프로세스를 재시작해야 합니다.

이 경험을 통해 Windows 환경에서의 경로 처리와 JSON 설정 관리의 중요성을 다시 한번 확인할 수 있었습니다. 다른 개발자들이 이러한 시행착오를 겪지 않고 MCP 설정을 할 수 있기를 바랍니다.

부록: 트러블슈팅 체크리스트

1. 설정 파일 확인

   • JSON 형식 유효성

   • 백슬래시 이스케이프 처리

   • 경로 존재 여부

2. 프로세스 확인

   • Node.js 프로세스 상태

   • Claude 앱 프로세스 상태

   • 작업 관리자 확인

3. 테스트 방법

   • 단순 명령어로 시작

   • 점진적 기능 확장

   • 오류 발생 시 로그 확인