Claude Desktop 설치·MCP 연결 완벽 가이드 — Windows·Mac 다운로드부터 서버 연동까지

Claude Desktop을 설치하고 MCP 서버를 연결하면 Claude AI가 파일 읽기, 웹 검색, 데이터베이스 조회, 한국 공문서 처리 등 다양한 외부 도구를 직접 사용할 수 있게 됩니다. Windows와 Mac 모두 설치 과정이 간단하고, MCP 연결은 JSON 설정 파일 하나면 충분합니다. 이 가이드에서는 공식 다운로드 경로 확인부터 설치 오류 해결, 첫 MCP 서버 연결까지 막힘 없이 끝낼 수 있도록 단계별로 안내합니다.

Claude Desktop이란 무엇인가요?

Claude Desktop은 Anthropic이 직접 배포하는 공식 데스크톱 클라이언트 앱입니다. 웹 브라우저 없이 Claude AI와 대화할 수 있으며, 가장 중요한 특징은 MCP(Model Context Protocol) 서버를 연결할 수 있다는 점입니다.

MCP는 AI 모델이 외부 도구나 데이터 소스와 표준화된 방식으로 통신하도록 설계된 오픈 프로토콜입니다. 쉽게 말하면 Claude에게 “플러그인”을 붙이는 방법입니다. 파일 읽기, 웹 검색, 한글 문서 처리, 데이터베이스 조회 등 Claude 혼자서는 못 하는 작업을 MCP 서버가 대신 처리해 주고 결과를 돌려줍니다.

웹 버전 vs 데스크톱 앱

기능	Claude 웹 버전	Claude Desktop
브라우저 없이 사용	불가	가능
시스템 트레이 상주	불가	가능
전역 단축키	불가	가능
MCP 서버 연동	불가	가능
로컬 파일 직접 접근	불가	MCP 통해 가능

MCP 서버 생태계를 제대로 활용하려면 Claude Desktop이 사실상 필수입니다. MCP 서버 전체 목록 보기에서 현재 연결 가능한 서버들을 확인할 수 있습니다.

준비물

항목	내용
운영체제	Windows 10 이상(64비트) 또는 macOS 12 이상
Anthropic 계정	claude.ai에서 무료 가입 가능
인터넷 연결	다운로드 및 로그인에 필요
Node.js (선택)	npx 기반 MCP 서버 사용 시 필요 (nodejs.org LTS 권장)
텍스트 편집기	VS Code, 메모장, 텍스트 편집 등

1단계 — Claude Desktop 다운로드

공식 다운로드 페이지는 claude.ai/download입니다. 페이지에 접속하면 운영체제를 자동 감지하여 적합한 버전을 추천합니다.

https://claude.ai/download

운영체제	파일 형식
Windows 10/11 (64비트)	.exe 설치 파일
macOS (Apple Silicon / Intel)	.dmg 디스크 이미지

주의: 검색엔진에서 “Claude Desktop 다운로드”를 검색하면 비공식 미러 사이트가 노출될 수 있습니다. 반드시 Anthropic 공식 도메인(claude.ai)에서만 다운로드하세요. 비공식 경로의 설치 파일은 보안 위험이 있습니다.

2단계 — 설치 실행

Windows 설치

1. 다운로드한 .exe 파일을 더블 클릭합니다.
2. “이 앱이 디바이스를 변경하도록 허용하시겠어요?” UAC(사용자 계정 컨트롤) 창이 뜨면 예를 클릭합니다.
3. 설치 마법사의 안내에 따라 다음 → 설치 → 완료 순서로 진행합니다. 기본 설치 위치를 그대로 사용해도 무방합니다.
4. 설치가 끝나면 바탕화면 또는 시작 메뉴에 Claude 아이콘이 생성됩니다.

macOS 설치

1. 다운로드한 .dmg 파일을 더블 클릭하여 마운트합니다.
2. 열린 창에서 Claude 아이콘을 Applications 폴더로 드래그합니다.
3. Launchpad 또는 응용 프로그램 폴더에서 Claude를 실행합니다.
4. 처음 실행 시 “인터넷에서 다운로드한 앱입니다” 경고가 뜨면 열기를 클릭합니다.

3단계 — 로그인 및 초기 설정

Claude Desktop을 처음 실행하면 로그인 화면이 나타납니다.

• 기존 계정: 이메일과 비밀번호 또는 Google 계정으로 로그인
• 신규 가입: “계정 만들기”를 선택하여 이메일 인증 후 가입

로그인 후 바로 Claude와 대화할 수 있습니다. MCP 서버 없이도 일반 텍스트 대화는 완전히 작동합니다.

권장 초기 설정:

• 시작 시 자동 실행: 설정 메뉴에서 활성화하면 PC 부팅 시 Claude가 자동으로 백그라운드에서 대기합니다.
• 전역 단축키 설정: 어느 앱에서든 단축키 한 번으로 Claude 입력창을 열 수 있습니다.

4단계 — MCP 설정 파일 위치 확인

MCP 서버는 JSON 설정 파일을 통해 등록합니다. 파일 경로는 운영체제마다 다릅니다.

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

파일이 없으면 해당 폴더를 만들고 새 파일로 생성하면 됩니다. Windows에서는 파일 탐색기 주소창에 %APPDATA%\Claude를 직접 입력하면 해당 폴더로 이동할 수 있습니다.

5단계 — MCP 서버 추가하기

설정 파일의 기본 구조는 다음과 같습니다.

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

예시: 코르독(KorDoc) MCP 서버 추가

코르독(KorDoc)은 HWP·HWPX·PDF·XLSX·DOCX 등 한국 공문서를 Markdown으로 변환해 주는 MCP 서버입니다.

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

예시: HWP-MCP 서버 추가

HWP-MCP는 AI 어시스턴트가 한글(.hwp/.hwpx) 문서를 직접 읽고 편집할 수 있게 해주는 서버입니다.

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

여러 서버를 동시에 등록하려면 위처럼 mcpServers 객체 안에 여러 항목을 나란히 추가하면 됩니다.

6단계 — Claude Desktop 재시작 및 확인

설정 파일을 저장한 뒤 Claude Desktop을 완전히 종료합니다. Windows에서는 시스템 트레이(우측 하단 아이콘)에서도 종료해야 합니다.

앱을 다시 실행하면 채팅 입력창 근처에 MCP 관련 아이콘 또는 표시가 나타납니다. Claude에게 “연결된 도구가 뭐야?”라고 물어보면 현재 사용 가능한 MCP 서버 목록을 알려줍니다.

데이터 흐름 구조

MCP 서버가 연결된 Claude Desktop의 동작 구조는 다음과 같습니다. 도구 실행은 로컬에서 일어나고, 최종 추론은 Anthropic 클라우드의 Claude 모델이 담당한다는 점에 주목하세요.

사용자 질문
    │
    ▼
Claude Desktop (로컬 앱)
    │  MCP 프로토콜 호출
    ▼
MCP 서버 (로컬 프로세스: 파일 읽기 / API 호출 / DB 조회)
    │
    ▼
외부 도구·파일·한국 API
    │  결과 반환
    ▼
Claude AI 모델 (Anthropic 클라우드, 답변 생성)
    │
    ▼
사용자에게 최종 답변

흔한 오류와 해결 방법

Windows “PC 보호” 메시지

Windows Defender SmartScreen이 알 수 없는 게시자로 표시할 수 있습니다. Anthropic 공식 사이트에서 직접 다운로드했다면 “추가 정보”를 클릭한 뒤 “실행”을 선택해 진행할 수 있습니다.

macOS “손상된 앱” 경고

macOS 보안 정책으로 인해 나타날 수 있습니다. 시스템 설정 - 개인 정보 보호 및 보안 - 보안 항목에서 “그래도 열기”를 클릭해 허용합니다.

JSON 파싱 오류

설정 파일에 쉼표가 빠지거나 따옴표가 잘못되면 Claude Desktop이 MCP 서버를 인식하지 못합니다.

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

jsonlint.com 같은 무료 JSON 검증 도구에 내용을 붙여넣어 오류 위치를 확인하세요.

npx 명령어를 찾을 수 없음

npx: command not found 오류는 Node.js가 설치되지 않아 발생합니다. nodejs.org에서 LTS 버전을 설치한 후 터미널을 새로 열어 다시 시도하세요.

node --version   # 버전 확인
npx --version    # npx 확인

MCP 서버가 목록에 안 뜸

1. 설정 파일 경로가 정확한지 다시 확인합니다(오타 주의).
2. JSON 문법 오류 여부를 확인합니다(쉼표, 중괄호 누락 등).
3. 앱을 완전히 종료(Quit)한 뒤 재실행합니다. 작업 관리자(Windows) 또는 활성 상태 보기(macOS)에서 Claude 프로세스가 완전히 종료됐는지 확인하세요.
4. Node.js가 설치되어 있는지 확인합니다(node -v).

한국 업무에 유용한 MCP 서버 추천

Claude Desktop에 연결하면 한국 업무 효율이 크게 오르는 MCP 서버들입니다. 아래 세 서버 모두 API 키가 필요 없어 설정이 간단합니다.

서버	기능	설치 명령
코르독(KorDoc)	HWP·HWPX·PDF·XLSX·DOCX → Markdown 변환	npx -y kordoc setup
HWP-MCP	한글 문서 읽기·편집·생성	npx -y hwp-mcp
한포지(HwpForge)	HWPX 문서 AI 에이전트 처리	npx -y @hwpforge/mcp

더 많은 서버는 개발도구 카테고리에서 확인할 수 있습니다.

자주 묻는 질문

Claude Desktop은 무료로 사용할 수 있나요?

Claude Desktop 앱 자체는 무료로 다운로드하고 설치할 수 있습니다. 다만 Claude AI 사용은 Anthropic 계정이 필요하며, 무료 플랜과 유료 Pro·Team 요금제가 있습니다. 유료 요금제에 가입하면 더 강력한 모델과 높은 사용 한도를 이용할 수 있으며, MCP 서버 기능은 모든 플랜에서 사용 가능합니다.

Claude Desktop Windows 최소 사양은 어떻게 되나요?

Anthropic 공식 문서 기준, Windows 10 이상(64비트)을 지원합니다. 정확한 최신 요구 사항은 claude.ai/download 페이지를 확인하세요.

MCP 서버를 추가했는데 Claude Desktop에서 인식하지 못합니다.

가장 흔한 원인은 JSON 문법 오류입니다. claude_desktop_config.json을 JSON 검증 도구에 붙여넣어 유효성을 확인하세요. 또한 앱을 완전히 종료(트레이 아이콘까지)한 뒤 재실행해야 변경 사항이 반영됩니다.

설정 파일(claude_desktop_config.json)이 어디 있나요?

Windows: %APPDATA%\Claude\claude_desktop_config.json, macOS: ~/Library/Application Support/Claude/claude_desktop_config.json 경로에 있습니다. 파일이 없으면 해당 폴더에 직접 생성하면 됩니다.

npx 명령어가 없다는 오류가 납니다.

npx는 Node.js에 포함된 명령어입니다. nodejs.org에서 Node.js LTS 버전을 설치하면 npx도 함께 설치됩니다. 설치 후 터미널에서 npx --version으로 확인하세요.

Windows에서 Claude Desktop MCP가 Mac과 동일하게 작동하나요?

네, MCP 프로토콜은 플랫폼 무관하게 동일하게 작동합니다. 설정 파일 경로만 다를 뿐 JSON 구조와 서버 연결 방식은 동일합니다.

Claude Desktop과 Claude 웹 버전의 차이는 무엇인가요?

웹 버전은 브라우저에서 바로 이용하고, 데스크톱 앱은 운영체제 수준의 단축키·시스템 트레이 상주·MCP 서버 연동 등 로컬 확장 기능을 제공합니다. MCP 서버를 활용하려면 데스크톱 앱이 필요합니다.

기업·팀 환경에서 Claude Desktop을 배포할 수 있나요?

현재 Claude Desktop은 개인 설치 방식으로 배포됩니다. 기업 대량 배포 정책은 Anthropic 공식 문의 채널을 통해 확인하시기 바랍니다.

MCP 서버 연결 후 Claude가 느려지지 않나요?

MCP 서버는 Claude가 도구를 호출할 때만 실행됩니다. 평소 대화에는 영향을 주지 않으며, 서버 수가 많아도 체감 속도 저하는 거의 없습니다.

다음 단계

Claude Desktop과 MCP 서버를 연결했다면 이제 본격적으로 활용해 볼 차례입니다. MCP모아 가이드 모음에서 각 서버별 상세 활용법을 확인하거나, 전체 MCP 서버 목록에서 업무에 맞는 서버를 추가로 찾아보세요. 특히 한국 문서 작업이 많다면 코르독(KorDoc)과 HWP-MCP 연결을 먼저 추천합니다. 새로운 한국형 MCP 서버를 발견했다면 MCP모아에 등록 요청도 환영합니다.