클로드가 외부 도구를 직접 쓸 수 있게 해주는 MCP(Model Context Protocol), 다들 잘 쓰고 계시나요? 최근에는 원클릭으로 설치하는 데스크톱 익스텐션도 지원하기 시작했지만, 내가 원하는 커스텀 서버나 유용한 도구를 직접 붙이려면 결국 claude_desktop_config.json 파일을 직접 편집해야 하는 경우가 많습니다. 이때 초보자분들이 가장 자주 겪는 함정과 해결법을 가볍게 공유해 드릴게요.

가장 흔히 발생하는 문제가 바로 spawn npx ENOENT 오류입니다. 클로드 데스크톱 앱이 시스템의 환경 변수를 제대로 상속받지 못해 npx 명령어를 찾지 못하는 현상인데요. 이럴 때는 설정 파일의 command에 그냥 npx라고 적기보다, 내 PC 터미널에서 which npx(macOS)나 where npx(Windows)를 실행해 나온 npx의 절대 경로를 그대로 적어주면 깔끔하게 해결됩니다. 로컬 폴더를 지정할 때도 ./ 같은 상대 경로가 아닌 전체 절대 경로를 입력해야 에러가 나지 않습니다.

입문하시는 분들에게는 실시간 인터넷 검색을 지원하는 Brave Search와 로컬 파일을 읽고 쓸 수 있는 Filesystem 서버부터 써보시는 것을 추천합니다. 특히 Brave Search는 최근 공식 패키지명이 @brave/brave-search-mcp-server로 변경되었으니 구형 패키지 대신 새로운 패키지명으로 아래처럼 추가해 보세요. 클로드 앱을 완전히 재시작하고 나면 우측 하단에 플러그 아이콘이 활성화된 것을 볼 수 있습니다. 생각보다 설정이 어렵지 않으니 한번 꼭 써보세요 ㅎㅎ