Claude Desktop MCP 재시작 방법 — 설정 변경 후 올바르게 적용하기

Q: 설정 파일을 수정했는데 왜 MCP가 바뀌지 않나요?

Claude Desktop은 실행 시점에만 claude_desktop_config.json을 읽습니다. 파일을 저장한 뒤 Claude Desktop을 완전히 종료하고 다시 실행해야 변경 사항이 반영됩니다. 창만 닫아서는 프로세스가 살아있어 설정이 다시 로드되지 않습니다.

Q: 재시작해도 망치 아이콘이 안 보여요. MCP 서버가 없는 건가요?

망치 아이콘이 없다면 claude_desktop_config.json 파일 위치가 올바른지, JSON 문법에 오류가 없는지 먼저 확인하세요. JSON 오류가 하나라도 있으면 전체 설정이 무시됩니다. 터미널에서 python3 -m json.tool로 파일을 파싱해 오류 줄을 확인할 수 있습니다.

claude_desktop_config.json을 수정한 뒤 MCP 서버 변경이 반영되지 않는다면, 이유는 단 하나입니다. Claude Desktop이 설정 파일을 실행 시점에만 읽기 때문입니다. 창을 닫는 것만으로는 프로세스가 종료되지 않으므로, 반드시 시스템 트레이(또는 메뉴바)에서 완전히 종료한 뒤 다시 실행해야 합니다. 이 가이드는 macOS와 Windows 각각에서 Claude Desktop MCP를 올바르게 재시작하는 방법을 단계별로 안내합니다.

왜 재시작이 필요한가요?

Claude Desktop은 실행 직후 단 한 번 claude_desktop_config.json을 읽어 MCP 서버 목록을 메모리에 로드합니다. 이후 파일을 수정해도 앱이 살아있는 동안은 변경을 인식하지 않습니다. 이것은 버그가 아니라 현재 Claude Desktop의 동작 방식입니다.

Claude Desktop 실행
      |
      v
claude_desktop_config.json 읽기 (1회)
      |
      v
MCP 서버 프로세스 시작 (등록된 서버별로)
      |
      v
대화 세션 시작 — 이후 config 파일 변경은 무시됨

따라서 설정을 바꿀 때마다 완전 종료 → 재실행 사이클이 필수입니다.

준비: 설정 파일 저장 확인

재시작 전에 설정 파일이 올바르게 저장됐는지 확인하는 것이 중요합니다. JSON 문법 오류가 하나라도 있으면 Claude Desktop이 전체 설정을 무시합니다.

설정 파일 위치:

운영체제	파일 경로
macOS	`~/Library/Application Support/Claude/claude_desktop_config.json`
Windows	`%APPDATA%\Claude\claude_desktop_config.json`

JSON 문법 빠른 검증:

# macOS / Linux
python3 -m json.tool ~/Library/Application\ Support/Claude/claude_desktop_config.json

오류가 없으면 파싱된 JSON이 출력됩니다. 오류가 있으면 몇 번째 줄인지 알려주므로 그 부분을 먼저 수정하세요.

올바른 설정 파일 기본 구조:

{
  "mcpServers": {
    "서버이름": {
      "command": "npx",
      "args": ["-y", "패키지명"]
    }
  }
}

단계별 재시작 방법

1단계: 설정 파일 저장

편집기에서 claude_desktop_config.json을 저장합니다. 저장 단축키는 대부분의 편집기에서 Cmd+S(macOS) 또는 Ctrl+S(Windows)입니다.

2단계: Claude Desktop 완전 종료

창의 X 버튼으로 닫지 말고, 아래 방법으로 프로세스 자체를 종료해야 합니다.

macOS에서 완전 종료:

화면 오른쪽 상단 메뉴바에서 Claude 아이콘을 클릭합니다.
드롭다운 메뉴에서 Quit Claude 또는 Claude 종료를 선택합니다.
Dock의 Claude 아이콘에서 점(실행 표시)이 사라지면 종료 완료입니다.

또는 터미널에서 다음 명령으로 강제 종료할 수 있습니다.

pkill -x "Claude"

Windows에서 완전 종료:

작업 표시줄 오른쪽 끝 숨겨진 아이콘 버튼(^)을 클릭합니다.
Claude 아이콘을 우클릭합니다.
Quit 또는 종료를 선택합니다.

또는 작업 관리자(Ctrl+Shift+Esc)에서 Claude 프로세스를 찾아 직접 종료할 수 있습니다.

3단계: 프로세스 완전 종료 확인 (선택 사항)

재시작이 반복적으로 문제가 된다면 프로세스가 실제로 종료됐는지 확인하세요.

# macOS: Claude 관련 프로세스 목록 확인
pgrep -l Claude
# 아무 출력이 없으면 완전히 종료된 것입니다

Windows에서는 작업 관리자의 프로세스 탭에서 Claude 항목이 사라졌는지 확인합니다.

4단계: Claude Desktop 재실행

macOS: Dock에서 Claude 아이콘을 클릭하거나, Spotlight(Cmd+Space)에서 Claude를 검색해 실행합니다.
Windows: 시작 메뉴나 바탕화면 단축키에서 Claude Desktop을 실행합니다.

5단계: MCP 서버 연결 확인

Claude Desktop이 실행되면 자동으로 claude_desktop_config.json을 다시 읽어 등록된 MCP 서버를 시작합니다.

대화창 하단 입력창 왼쪽의 망치 아이콘을 클릭해 MCP 서버 목록이 나타나는지 확인합니다. 새로 추가한 서버가 보이면 설정이 정상적으로 반영된 것입니다.

재시작 후에도 서버가 안 보일 때

망치 아이콘이 없거나 서버가 목록에 없다면 아래 순서로 점검하세요.

증상	점검 항목
망치 아이콘 자체가 없음	JSON 문법 오류 또는 파일 경로 오류
망치는 있지만 서버가 0개	`mcpServers` 키 오류, 서버 이름 문제
특정 서버만 없음	해당 런타임(node, npx 등) 미설치
서버가 보였다가 사라짐	서버 프로세스 크래시, 로그 확인 필요

로그 확인으로 정확한 원인 파악:

# macOS: 실시간 MCP 로그 보기
tail -f ~/Library/Logs/Claude/mcp*.log

Windows 로그 위치는 %APPDATA%\Claude\logs\ 폴더입니다.

실제 MCP 서버 설정 예시

올바르게 재시작했는데도 서버 연결이 안 된다면 설정 자체가 잘못됐을 수 있습니다. 아래는 MCP모아에 등록된 한국 MCP 서버의 검증된 설정 예시입니다.

코르독(KorDoc) — HWP·PDF·DOCX를 Markdown으로 변환:

{
  "mcpServers": {
    "kordoc": {
      "command": "npx",
      "args": ["-y", "kordoc", "setup"]
    }
  }
}

HWP-MCP — 한글 문서 읽기·편집·생성:

{
  "mcpServers": {
    "hwp-mcp": {
      "command": "npx",
      "args": ["-y", "hwp-mcp"]
    }
  }
}

한포지(HwpForge) — HWPX 문서 AI 에이전트 연동:

{
  "mcpServers": {
    "hwpforge": {
      "command": "npx",
      "args": ["-y", "@hwpforge/mcp"]
    }
  }
}

위 세 서버를 동시에 사용하고 싶다면 mcpServers 객체 안에 나란히 추가하면 됩니다. 설정 후 반드시 재시작해야 반영됩니다.

{
  "mcpServers": {
    "kordoc": {
      "command": "npx",
      "args": ["-y", "kordoc", "setup"]
    },
    "hwp-mcp": {
      "command": "npx",
      "args": ["-y", "hwp-mcp"]
    },
    "hwpforge": {
      "command": "npx",
      "args": ["-y", "@hwpforge/mcp"]
    }
  }
}

재시작 절차 한눈에 보기

1. claude_desktop_config.json 수정·저장
         |
         v
2. 트레이/메뉴바에서 Quit Claude (완전 종료)
         |
         v
3. Claude Desktop 재실행
         |
         v
4. 망치 아이콘 → 서버 목록 확인
         |
    ┌────┴────┐
  정상       오류
    |          |
  완료      로그 확인

자주 묻는 질문

설정 파일을 수정했는데 왜 MCP가 바뀌지 않나요?

Claude Desktop은 실행 시점에만 claude_desktop_config.json을 읽습니다. 파일을 저장한 뒤 Claude Desktop을 완전히 종료하고 다시 실행해야 변경 사항이 반영됩니다. 창만 닫아서는 프로세스가 살아있어 설정이 다시 로드되지 않습니다.

창을 닫으면 종료되는 게 아닌가요?

아닙니다. Claude Desktop은 창을 닫아도 macOS 메뉴바나 Windows 시스템 트레이에 계속 실행 중입니다. 설정을 반영하려면 트레이 아이콘에서 Quit(종료)를 선택해 프로세스 자체를 끝내야 합니다.

macOS에서 트레이 아이콘이 보이지 않아요.

메뉴바가 꽉 찬 경우 아이콘이 숨겨질 수 있습니다. macOS Ventura 이상에서는 메뉴바 오른쪽에 앱 목록 확장 버튼(…)을 클릭하면 나타납니다. 또는 활동 모니터에서 Claude 프로세스를 찾아 종료한 뒤 재실행하세요.

재시작해도 망치 아이콘이 안 보여요. MCP 서버가 없는 건가요?

망치 아이콘이 없다면 claude_desktop_config.json 파일 위치가 올바른지, JSON 문법에 오류가 없는지 먼저 확인하세요. JSON 오류가 하나라도 있으면 전체 설정이 무시됩니다. 터미널에서 python3 -m json.tool로 파일을 파싱해 오류 줄을 확인할 수 있습니다.

Claude Desktop 재시작 없이 MCP를 즉시 반영하는 방법은 없나요?

현재 Claude Desktop은 실행 시 설정을 한 번 읽는 구조여서 런타임 중 설정 변경 반영(hot reload)을 공식 지원하지 않습니다. 재시작이 유일한 방법입니다. Claude Code(CLI) 환경은 claude mcp add 명령으로 세션 중에도 서버를 추가할 수 있습니다.

Windows에서 시스템 트레이 아이콘이 숨겨져 있어요.

작업 표시줄 오른쪽 끝의 위쪽 화살표(^) 아이콘을 클릭하면 숨겨진 트레이 아이콘이 펼쳐집니다. 거기서 Claude 아이콘을 우클릭해 종료하면 됩니다.

다음 단계

재시작 절차를 익혔다면 실제로 유용한 MCP 서버를 추가해 보세요. 한글 문서 처리에 특화된 코르독(KorDoc), HWP-MCP, 한포지(HwpForge)는 별도 API 키 없이 npx 한 줄로 설치할 수 있습니다. 설치 후 이 가이드의 재시작 절차를 따르면 바로 사용할 수 있습니다. 더 많은 한국 특화 MCP 서버는 개발도구 카테고리와 전체 서버 목록에서 찾아볼 수 있습니다.