Claude Desktop에 MCP 서버 설치하는 방법 (단계별)

Claude Desktop에 MCP 서버를 추가하는 방법: macOS와 Windows의 claude_desktop_config.json 위치, 설정 예시, 문제 해결.

시작하기 전에

Claude Desktop 앱이 필요합니다. 대부분의 서버는 Node.js(npx 명령용) 또는 uv가 설치된 Python(uvx 명령용)도 필요하며, 어떤 것이 필요한지는 서버의 README에 나와 있습니다.

1. 설정 파일 열기

시스템 메뉴 막대의 Claude 메뉴(채팅 창 안의 설정이 아님)를 클릭해 Settings…를 고른 다음 Developer → Edit Config를 엽니다. 그러면 claude_desktop_config.json이 열립니다. macOS에서는 ~/Library/Application Support/Claude/claude_desktop_config.json, Windows에서는 %APPDATA%\Claude\claude_desktop_config.json에 있습니다.

2. 서버 추가

mcpServers 아래에 항목을 추가합니다. 아래 예시는 공식 Filesystem 서버를 폴더 하나에만 접근하도록 추가합니다.

{
  "mcpServers": {
    "filesystem": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-filesystem", "/Users/you/Documents"]
    }
  }
}

3. 다시 시작하고 확인

Claude Desktop을 완전히 종료한 뒤 다시 엽니다. 채팅 입력창에서 Add files, connectors, and more를 클릭하고 Connectors → Manage connectors를 열어 서버를 선택하면 도구 목록을 볼 수 있습니다. 연결되지 않으면 macOS의 ~/Library/Logs/Claude 또는 Windows의 %APPDATA%\Claude\logs에 있는 로그(mcp.log, mcp-server-이름.log)를 확인하세요.

팁

• 절대 경로를 사용하세요.
• API 키는 서버 항목 안의 env 객체에 넣으세요.
• Socketlist의 여러 서버 페이지에서 README에서 가져온 설정을 바로 복사할 수 있습니다.