Claude Desktop MCP 서버
연결하는 방법 2026
설치부터 실전 활용까지 단계별 완전 가이드
MCP 입문을 마쳤다면 다음 단계는 Claude Desktop에 실제 서버를 연결하는 것입니다.
JSON 설정 파일부터 원클릭 확장 설치까지, 2026년 최신 방법을 모두 정리했습니다.
1 MCP 서버 연결 전 반드시 확인할 것
Claude Desktop에 MCP 서버를 연결하기 전에 두 가지를 먼저 확인해야 합니다. 이 단계를 건너뛰면 연결 후에도 서버가 인식되지 않는 상황이 발생합니다.
MCP 서버 연결 기능은 최신 버전에서만 정상 작동합니다. claude.ai/download에서 최신 버전 여부를 확인하십시오.
JSON 설정 방식으로 npx 기반 서버를 사용할 경우 Node.js 18 이상이 필요합니다. 터미널에서 node --version으로 확인하십시오.
SSE(Server-Sent Events) 방식의 연결은 2026년 4월 이후 지원이 종료되었습니다. 기존 설정에 "transport": "sse"가 있다면 "streamable-http"로 교체가 필요합니다. 최신 공식 정보는 MCP 공식 사이트에서 확인하십시오.
2 방법 ① 데스크톱 확장(Extensions) — 가장 쉬운 방법
2026년 초부터 Claude Desktop은 .mcpb 형식의 데스크톱 확장(Desktop Extensions)을 지원합니다. JSON 파일을 직접 수정하지 않아도 브라우저 확장 프로그램처럼 원클릭으로 설치할 수 있습니다. 비개발자에게 권장하는 방식입니다.
공식 디렉터리에 없는 서버를 개발자로부터 .mcpb 파일로 받은 경우에는 아래 경로로 설치합니다.
- Settings → Extensions → "Advanced settings" 클릭
- Extension Developer 섹션에서 "Install Extension…" 선택
- .mcpb 파일을 선택하고 안내에 따라 설치를 완료합니다.
3 방법 ② JSON 설정 파일 직접 편집 — 자유도 높은 방법
공개된 오픈소스 MCP 서버를 직접 연결하거나, 환경변수(API 키 등)를 직접 설정할 때는 JSON 파일을 편집하는 방식을 사용합니다. 설정 파일 경로가 운영체제마다 다르다는 점에 주의하십시오.
| 운영체제 | 설정 파일 경로 | 빠른 접근 방법 |
|---|---|---|
| 🍎 macOS | ~/Library/Application Support/Claude/claude_desktop_config.json |
Settings → Developer → Edit Config |
| 🪟 Windows | %APPDATA%\Claude\claude_desktop_config.json |
Settings → Developer → Edit Config |
{
"mcpServers": {
"서버이름": {
"command": "npx",
"args": ["-y", "패키지명"],
"env": {
"API_KEY": "여기에_API_키_입력"
}
}
}
}
파일이 존재하지 않으면 직접 생성합니다. JSON 문법 오류(쉼표 누락, 괄호 불일치)가 있으면 서버 전체가 인식되지 않으므로 저장 전 반드시 검토하십시오.
- macOS에서
~/Library는 숨김 폴더입니다. Finder에서Cmd+Shift+G를 누르고 경로를 직접 입력하십시오. - 설정 파일 수정 후에는 Claude Desktop을 완전히 종료하고 재시작해야 합니다. 단순히 창을 닫는 것으로는 반영되지 않습니다.
- 상대경로(
./폴더명)는 작동하지 않습니다. 절대경로(/Users/사용자명/...)로만 입력하십시오.
4 지금 바로 써볼 만한 MCP 서버 5가지
처음 MCP 서버를 연결할 때는 읽기 전용 서버부터 시작하는 편이 안전합니다. 쓰기 권한이 있는 서버는 작동 방식을 이해한 뒤 추가하십시오.
| 서버 이름 | 주요 기능 | 난이도 | API 키 필요 여부 |
|---|---|---|---|
| Filesystem | 로컬 파일 읽기·쓰기·검색 | 🟢 쉬움 | 불필요 |
| Fetch | URL 내용 가져오기·웹페이지 요약 | 🟢 쉬움 | 불필요 |
| Brave Search | 실시간 웹 검색 | 🟡 보통 | 필요 (무료 플랜 있음) |
| GitHub | 저장소 조회·이슈·PR 관리 | 🟡 보통 | 필요 (Personal Access Token) |
| Memory | 대화 간 정보 저장·기억 | 🟢 쉬움 | 불필요 |
Filesystem → Fetch → Memory 순서로 하나씩 추가하십시오. 각 서버가 정상 작동하는 것을 확인한 뒤 다음 서버를 추가하면 오류 원인을 파악하기 쉽습니다. 더 많은 서버는 MCP 공식 GitHub 저장소에서 확인할 수 있습니다.
5 연결 확인 방법 — 🔨 아이콘이 핵심
설치 또는 설정 파일 저장 후 재시작을 완료했다면, 아래 두 가지 방법으로 연결 성공 여부를 확인할 수 있습니다.
새 채팅창을 열면 입력창 하단에 🔨 아이콘과 숫자가 표시됩니다. 숫자는 현재 연결된 도구(tool)의 수를 나타냅니다. 클릭하면 사용 가능한 도구 목록을 확인할 수 있습니다.
Claude에게 직접 물어봐도 됩니다. Filesystem 서버라면 "내 Desktop에 있는 파일 목록을 보여줘"처럼 요청하고, Claude가 파일 목록을 응답하면 정상 작동 중입니다.
6 자주 발생하는 오류 3가지와 해결법
MCP 서버 연결에서 가장 많이 막히는 지점은 세 가지로 압축됩니다. 오류 메시지가 없어도 서버가 인식되지 않는 경우가 많으므로, 아래 순서대로 하나씩 점검하십시오.
7 자주 묻는 질문 (FAQ)
8 오늘 바로 시작하는 3단계
- ① 지금 바로: Claude Desktop을 최신 버전으로 업데이트하고 Settings → Extensions를 열어보십시오. 공식 디렉터리에서 Filesystem 서버를 찾아 설치하면 5분 안에 첫 번째 서버 연결이 완료됩니다.
- ② 연결 후: 채팅창 하단 🔨 아이콘이 생겼는지 확인하고 "내 바탕화면 파일 목록을 보여줘"를 입력해보십시오. Claude가 실제로 파일 목록을 응답하면 MCP 연결이 성공한 것입니다.
- ③ 다음 단계: Fetch 서버와 Brave Search를 추가해 보십시오. 서버가 쌓이면 Claude Desktop이 사실상 로컬 AI 에이전트로 전환됩니다. 더 복잡한 자동화를 원한다면 n8n과 Claude 연동 가이드와 AI 에이전트 입문 가이드를 참고하십시오.
※ 본 글의 MCP 서버 설정 방법·지원 기능은 Anthropic 공식 문서 및 MCP 공식 사이트 기준으로 정리했으며, 이후 버전 업데이트에 따라 변경될 수 있습니다. 실제 작동 여부는 사용 환경·버전·서버 구현 상태에 따라 달라질 수 있습니다. 최신 정보는 MCP 공식 사이트 및 Claude 공식 지원 센터에서 확인하십시오.