MCP 커넥터 연결하다가 계속 실패하는데 원인이 뭘까요
답변 1
- 첫째운영진Lv.62026. 7. 31.
안녕하세요, 운영진입니다. 결론부터 말씀드리면 로그를 제대로 된 위치에서 다시 확인하시는 게 먼저이고, 그다음 경로·권한·문법 순으로 좁혀가시면 됩니다. 먼저 로그 확인 위치입니다. 커넥터 목록에 뜨는 상태 표시만으로는 원인을 알기 어렵습니다. 데스크톱 앱에서 설정의 Developer 항목으로 들어가면 개별 MCP 서버의 연결 상태와 로그를 볼 수 있고, 별도로 상단 메뉴의 Help에서 Troubleshooting, Show Logs로도 진단 로그를 열 수 있습니다. 이 로그에 에러 메시지가 남아있을 가능성이 높으니 여기서부터 시작하시길 권합니다. 확인 순서는 다음과 같습니다. 1. 설정 파일의 JSON 문법이 정확한지 확인합니다. 쉼표 하나, 중괄호 하나만 틀려도 해당 서버 전체가 조용히 실패할 수 있습니다. 2. 명령어 경로가 절대 경로인지 확인합니다. 상대 경로나 단순 명령어 이름만 쓰면 데스크톱 앱이 실행되는 환경에서 PATH를 인식하지 못해 실패하는 경우가 흔합니다. 3. 실행 파일이나 스크립트에 실행 권한이 있는지 확인합니다. 4. npx로 패키지를 처음 받는 경우, 다운로드 중에는 일시적으로 연결 실패로 표시될 수 있으니 잠시 후 재시도해 보세요. 5. 커스텀 서버를 직접 만든 경우라면 서버가 표준출력(stdout)에 디버그 로그를 찍고 있지 않은지도 확인이 필요합니다. MCP는 JSON-RPC를 stdio로 주고받기 때문에 여기에 다른 텍스트가 섞이면 통신 자체가 깨집니다. 권한 문제인지 경로 문제인지는 결국 로그의 에러 메시지로 구분하시는 게 가장 정확합니다. 정확한 에러 문구를 확인하신 뒤 다시 질문 주시면 더 구체적으로 도와드리겠습니다. 증상별 원인과 해결 순서는 아래 가이드에 자세히 정리해 두었습니다. https://usingclaude.com/ko/library/mcps/mcp-server-troubleshooting