Claude Desktop에 MCP 서버 연결하는 법 — 초보자도 따라하는 단계별 설치 가이드

 

Claude Desktop에 MCP 서버, 직접 연결해볼 수 있을까요? 개념은 이해했는데 막상 설치하려니 막막한 분들을 위한 글이에요. Node.js 설치부터 JSON 설정, 첫 실행까지 초보자도 따라할 수 있도록 단계별로 정리했습니다!

 

MCP가 뭔지는 이제 알겠는데… 막상 "해봐야지!" 했다가 에러 메시지 보고 탭을 닫아버린 경험, 혹시 있으신가요? 저도 처음에 딱 그랬어요. 😅 공식 문서가 영어인 데다가 설명이 개발자 기준이라, 처음 접하는 분들한테는 꽤 높은 벽처럼 느껴지거든요.

그래서 이번엔 제가 직접 따라해 보면서 막혔던 부분들까지 싹 다 정리해 봤어요. Claude Desktop 기준으로, 설치부터 첫 MCP 서버 연결까지 스텝 바이 스텝으로 가보겠습니다. 준비됐나요? 🚀

 

📌 시작 전 체크리스트
이 가이드는 Claude Desktop 앱 기준이에요. claude.ai 웹 버전과는 다르니 주의하세요! macOS와 Windows 모두 동일한 방식으로 진행되며, 경로만 일부 다릅니다.

 

STEP 1 — Claude Desktop 설치하기 📥

가장 먼저 Claude Desktop 앱을 설치해야 해요. 웹 브라우저로 접속하는 claude.ai와는 별도로, 데스크탑 앱에서만 MCP 연결이 가능하거든요. 이 점이 좀 아쉽긴 한데, 어쩔 수 없어요!

📝 설치 방법

1. 공식 사이트 접속: claude.ai/download 에 접속합니다.
2. OS 선택 후 다운로드: macOS 또는 Windows용 설치 파일을 내려받습니다.
3. 설치 후 로그인: 앱을 실행하고 Anthropic 계정으로 로그인하면 준비 완료예요.

⚠️ 주의하세요!
Claude Desktop은 유료 플랜(Pro 이상)이 있어야 MCP를 포함한 고급 기능을 원활하게 사용할 수 있어요. 무료 플랜에서도 앱 자체는 설치할 수 있지만, 기능 제한이 있을 수 있습니다.

 

STEP 2 — Node.js 설치 확인하기 ⚙️

MCP 서버 대부분은 Node.js 환경에서 실행돼요. 그래서 Node.js가 내 PC에 설치되어 있는지 먼저 확인해야 해요. 뭔가 어렵게 느껴지신다면, 그냥 "MCP를 돌리기 위한 엔진 설치"라고 생각하시면 돼요!

💻 설치 여부 확인 방법

터미널(맥: Terminal, 윈도우: PowerShell 또는 명령 프롬프트)을 열고 아래 명령어를 입력해 보세요.

node -v

v20.x.x 처럼 버전 번호가 뜨면 OK! 아무것도 안 뜨거나 오류가 나오면 Node.js를 설치해야 해요.

⬇️ Node.js 설치 방법

1. nodejs.org 에 접속합니다.
2. LTS 버전(Long Term Support, 안정 버전)을 선택해 다운로드합니다.
3. 설치 완료 후 터미널을 새로 열고 node -v로 재확인하세요.

💡 알아두세요!
Node.js 설치 시 함께 설치되는 npx 명령어가 MCP 서버 실행에 자주 사용돼요. Node.js만 제대로 설치하면 npx도 자동으로 설치됩니다.

 

STEP 3 — 설정 파일 찾기 📂

MCP 서버 연결은 claude_desktop_config.json이라는 설정 파일을 직접 수정하는 방식으로 이루어져요. 처음엔 좀 낯설 수 있는데, 막상 보면 그냥 텍스트 파일이라 어렵지 않아요!

📍 OS별 설정 파일 경로

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

🔍 파일 빨리 여는 팁

macOS: Finder에서 Cmd + Shift + G 를 누른 뒤 경로를 붙여넣기하면 바로 이동할 수 있어요.

Windows: 탐색기 주소창에 %APPDATA%\Claude 를 직접 입력하면 돼요.

파일이 없는 경우엔 당황하지 마세요! Claude Desktop을 한 번이라도 실행했으면 자동 생성되거나, 직접 빈 파일을 만들어도 돼요. 내용이 없다면 {} 만 입력한 채로 저장해두면 시작 준비 완료예요.

 

STEP 4 — 첫 MCP 서버 연결하기 🔌

이제 진짜 핵심이에요! 실습용으로 가장 쉽고 안전한 Filesystem MCP 서버를 연결해볼게요. 이 서버를 연결하면 Claude가 내 PC의 특정 폴더에 있는 파일을 직접 읽고 내용을 파악할 수 있어요.

📝 설정 파일에 아래 내용을 붙여넣으세요

{
  "mcpServers": {
    "filesystem": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-filesystem",
        "/Users/여러분의이름/Documents"
      ]
    }
  }
}

👆 마지막 경로 부분(/Users/여러분의이름/Documents)은 Claude가 접근을 허용할 실제 폴더 경로로 바꿔주세요. Windows라면 C:\\Users\\이름\\Documents 형식으로 입력해요.

⚠️ 주의하세요!
접근 허용 폴더는 꼭 필요한 범위만 설정하는 게 좋아요. 예를 들어 루트 디렉토리(/ 또는 C:\)처럼 너무 넓은 범위를 주면 보안상 위험할 수 있어요!

 

STEP 5 — 재시작 후 연결 확인하기 ✅

설정 파일 저장이 끝났으면, Claude Desktop을 완전히 종료했다가 다시 실행해야 해요. 이 단계를 빠뜨리는 분들이 꽤 많아서 강조하는 거예요! 단순히 창만 닫으면 안 되고, 시스템 트레이(맥은 상단 메뉴바, 윈도우는 우하단 아이콘)에서도 완전히 종료해야 합니다.

🔍 연결 확인 방법

1. Claude Desktop을 재실행합니다.
2. 채팅 입력창 근처에 🔨 망치 아이콘이 나타나면 MCP 연결 성공이에요!
3. 망치 아이콘을 클릭하면 현재 연결된 MCP 서버 목록과 사용 가능한 툴 목록이 표시돼요.
4. 테스트로 Claude에게 "내 Documents 폴더에 어떤 파일이 있어?" 라고 물어보세요. 실제 파일 목록을 가져온다면 완벽하게 연결된 거예요! 🎉

💡 알아두세요!
MCP 서버가 처음 실행될 때 npx가 패키지를 다운로드하는 과정이 있어요. 인터넷 연결 상태에 따라 10~30초 정도 걸릴 수 있으니 조금 기다려 주세요. 이후 재실행부터는 캐시된 파일을 사용해서 훨씬 빨라요.

 

자주 막히는 포인트 & 해결법 🛠️

저도 처음 세팅할 때 몇 군데서 막혔어요. 자주 발생하는 오류와 해결 방법을 정리해뒀으니 참고하세요!

❌ 망치 아이콘이 안 보여요

→ Claude Desktop을 완전히 종료했다가 다시 실행하세요. 설정 파일 JSON 문법 오류(쉼표 누락, 괄호 불일치 등)가 있을 경우에도 아이콘이 뜨지 않아요. JSON 유효성 검사기(jsonlint.com)에 설정 내용을 붙여넣어 확인해 보세요.

❌ "npx를 찾을 수 없다"는 오류가 떠요

→ Node.js가 제대로 설치되지 않았거나, 설치 후 PC를 재시작하지 않은 경우예요. PC 재시작 후 다시 시도해 보세요. 그래도 안 된다면 Node.js를 공식 사이트에서 재설치해 보세요.

❌ 파일 경로를 인식 못해요 (Windows)

→ Windows 경로는 역슬래시(\)를 사용하는데, JSON 안에서는 반드시 이중 역슬래시(\\)로 표기해야 해요. 예: C:\\Users\\홍길동\\Documents

 

핵심 내용 정리 📝

전체 과정을 다시 한번 정리할게요!

1. Claude Desktop 설치: claude.ai/download에서 앱을 내려받아 설치해요.
2. Node.js 설치 확인: 터미널에서 node -v로 확인, 없으면 LTS 버전 설치.
3. 설정 파일 위치 찾기: OS별 경로의 claude_desktop_config.json을 텍스트 에디터로 열기.
4. MCP 서버 설정 추가: mcpServers 블록에 연결할 서버 정보를 JSON 형식으로 입력.
5. 완전 재시작 후 확인: 망치 아이콘 확인 → Claude에게 직접 물어보며 테스트.

 

🗺️

Claude Desktop MCP 연결 5단계

1

Claude Desktop 설치 — claude.ai/download에서 앱 다운로드

2

Node.js 설치 확인 — 터미널에서 node -v 실행

3

설정 파일 열기 — OS별 경로의 claude_desktop_config.json 수정

4

MCP 서버 추가 — mcpServers 블록에 JSON 설정 입력

5

완전 재시작 후 테스트 — 🔨 망치 아이콘 확인으로 성공 여부 체크

처음 연결 시 npx가 패키지를 다운로드하므로 10~30초 대기가 필요할 수 있습니다.

 

자주 묻는 질문 ❓

Q: Mac이 아닌 Windows에서도 동일하게 작동하나요?

A: 네, 기본 원리는 동일해요! 다만 설정 파일 경로와 폴더 경로 표기법이 달라요. Windows는 %APPDATA%\Claude 경로를 사용하고, 경로 안의 역슬래시를 \\로 이중 표기해야 한다는 점을 꼭 기억하세요.

Q: MCP 서버를 여러 개 동시에 연결할 수 있나요?

A: 물론이에요! mcpServers 블록 안에 서버를 여러 개 나란히 추가하면 돼요. 예를 들어 filesystem과 github를 동시에 연결해두면 Claude가 파일도 읽고 GitHub도 제어할 수 있게 됩니다.

Q: 설정 파일을 수정할 때 어떤 에디터를 써야 하나요?

A: 메모장이나 TextEdit 같은 기본 텍스트 에디터도 쓸 수 있지만, VS Code를 추천해요. JSON 문법 오류를 바로 표시해줘서 실수를 줄일 수 있거든요. VS Code는 무료로 내려받을 수 있어요.

Q: MCP 서버를 연결하면 내 파일이 Anthropic 서버로 업로드되나요?

A: Filesystem MCP 서버는 로컬에서만 실행되므로 파일 자체가 외부로 전송되지는 않아요. 다만 Claude와의 대화 내용은 Anthropic의 서버를 통해 처리되므로, 민감한 파일 내용이 대화에 포함될 경우엔 Anthropic의 개인정보 처리 방침이 적용된다는 점은 참고해 두세요.

Q: Filesystem 말고 다른 MCP 서버는 어디서 찾을 수 있나요?

A: Anthropic 공식 GitHub(github.com/modelcontextprotocol/servers)에서 다양한 공식 MCP 서버 목록을 확인할 수 있어요. GitHub, Slack, Notion, 브라우저 제어(Playwright) 등 다양한 서버가 공개되어 있답니다.

처음엔 설정 파일이라는 말만 들어도 겁이 나는 게 당연해요. 하지만 실제로 해보면 생각보다 훨씬 간단하다는 걸 느끼실 거예요. 저도 처음엔 두 시간 넘게 씨름했는데, 지금은 새 MCP 서버 추가하는 데 5분도 안 걸리거든요. 😄 다음 글에서는 인기 MCP 서버들을 하나씩 연결하고 활용하는 법을 다뤄볼게요. 세팅하다가 막히는 부분이 있으면 댓글로 편하게 물어봐 주세요! 🙌