Claude Desktop MCP 설정 시 발생하는 JSON 오류 해결하기

문제 상황

Claude Desktop을 사용하면서 MCP(Model Context Protocol)를 설정할 때 다음과 같은 오류 메시지를 만날 수 있습니다:

파일 설정을 불러올 수 없습니다.
claude_desktop_config.json 파일을 확인하고 구문 분석하는 중 오류가 발생했습니다. 오류 내용:
Unexpected token ']', ....."
}
"... is not valid JSON

이 오류는 JSON 파일의 형식이 올바르지 않을 때 발생합니다.

원인 분석

가장 흔한 원인은 JSON 파일에서 불필요한 콤마(,)가 들어가 있기 때문입니다. JSON 형식에서는 배열이나 객체의 마지막 항목 뒤에 콤마를 허용하지 않습니다.

예를 들어, 다음과 같은 설정 파일은 오류를 발생시킵니다:

json

{
  "mcpServers": {
    "filesystem": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-filesystem",
        "C:\\dev\\sinbum-blog\\obsidian",  // 이 콤마가 문제!
      ]
    }
  }
}

해결 방법

claude_desktop_config.json 파일을 텍스트 편집기로 엽니다.
배열이나 객체의 마지막 항목 뒤에 있는 콤마를 제거합니다.

수정된 올바른 형식:

json

{
  "mcpServers": {
    "filesystem": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-filesystem",
        "C:\\dev\\sinbum-blog\\obsidian"  // 콤마 제거됨
      ]
    }
  }
}

기타 JSON 파일 오류 확인 방법

온라인 JSON 검사기 사용하기
- JSONLint와 같은 웹사이트에서 JSON 파일의 유효성을 검사할 수 있습니다.
VS Code 사용하기
- Visual Studio Code에서는 JSON 파일을 열면 자동으로 형식 오류를 표시해 줍니다.
일반적인 JSON 오류들
- 따옴표 누락: 속성 이름과 문자열 값은 쌍따옴표(")로 감싸야 합니다.
- 불필요한 콤마: 위에서 설명한 것처럼 마지막 항목 뒤에 콤마를 사용하면 안 됩니다.
- 중괄호/대괄호 짝 맞추기: 모든 {, [는 각각 닫는 }, ]가 있어야 합니다.

Claude Desktop MCP 설정 시 JSON 오류는 대부분 간단한 구문 문제이며, 위의 가이드를 따라 쉽게 해결할 수 있습니다. 특히 배열의 마지막 항목 뒤에 콤마가 있는지 확인하는 것이 중요합니다.

JSON 형식에 익숙하지 않은 경우, 온라인 JSON 검증 도구를 활용하면 오류를 더 쉽게 찾을 수 있습니다.