클로드 MCP 서버 설정 완전정복
코딩 0줄로 AI 비서를 내 PC에 연결하는 법
Claude Desktop에 MCP 서버를 연결하는 순간, AI는 단순한 채팅 도구에서 내 노션·파일·웹을 직접 다루는 진짜 비서로 바뀝니다. 지금 이 글에서 2026년 3월 최신 기준으로, 설정 파일 한 줄 없이도 가능한 방법까지 전부 공개합니다.
Node.js 22+ 필수
코딩 불필요 (커넥터 방식)
2026년 3월 최신 기준
MCP란 무엇인가? — Claude가 세상과 연결되는 방식
MCP(Model Context Protocol)는 Anthropic이 2024년 말 공개한 개방형 표준 프로토콜로, AI 모델과 외부 데이터 소스·도구를 연결하는 규격입니다. 쉽게 말하면 USB 표준처럼, 어떤 AI든 어떤 서비스든 같은 방식으로 연결할 수 있게 해주는 공통 언어입니다. Claude뿐 아니라 현재 ChatGPT, Cursor, Windsurf 등도 MCP를 채택하면서 사실상 AI 생태계의 표준 인터페이스로 자리잡았습니다.
기존 Claude는 대화 창 안에서만 작동했습니다. 인터넷도 못 찾고, 내 파일도 못 보고, 노션에 글도 못 씁니다. 하지만 클로드 MCP 서버를 연결하면 이야기가 완전히 달라집니다. Claude가 직접 웹 검색을 하고, 내 PC 폴더를 열어 파일을 읽고, 노션에 페이지를 만들고, Gmail 임시 보관함에 초안을 저장하는 것이 가능해집니다.
💡 핵심 인사이트
MCP의 진짜 가치는 ‘AI에 기능을 추가한다’는 것이 아닙니다. AI가 내 작업 공간 안으로 들어온다는 것입니다. 지금까지는 제가 Claude에게 정보를 복사해 붙여 넣었다면, MCP 이후에는 Claude가 직접 제 파일과 앱에 접근합니다. 이 방향 전환이 업무 효율을 수십 배 바꿉니다.
2026년 3월 현재, MCP 서버의 수는 수백 개를 넘어섰습니다. Smithery, MCP Hub 같은 디렉터리에서 검색만 하면 원하는 서버를 찾을 수 있으며, Anthropic이 직접 안전성을 검토한 공식 커넥터도 계속 확대되고 있습니다.
2026년 MCP 설정 2가지 방법 — JSON vs. 클릭 한 번
MCP를 Claude에 연결하는 방법은 2026년 현재 크게 두 가지입니다. 첫 번째는 JSON 설정 파일을 직접 편집하는 전통적인 방식이고, 두 번째는 Anthropic이 새롭게 도입한 커넥터(Connector) 방식입니다. 어느 쪽이 더 낫다고 단정할 수는 없습니다. 목적과 사용 환경에 따라 달라지기 때문입니다.
| 구분 | JSON 설정 방식 | 커넥터(클릭) 방식 |
|---|---|---|
| 난이도 | 중간 (터미널 필요) | 쉬움 (클릭만) |
| 설치 범위 | 수백 개 MCP 서버 선택 가능 | 공식 승인 커넥터 한정 |
| 보안 | API 키 직접 관리 | OS 키체인 자동 암호화 |
| 추천 대상 | 개발자·파워 유저 | 일반 사용자 |
| 대표 서비스 | Brave Search, Tavily, 파일시스템 | Notion, Gmail, Google Calendar |
개인적으로는 두 방법을 병행하는 것을 추천합니다. 일상적으로 자주 쓰는 노션·Gmail은 커넥터 방식으로 쉽게 연결하고, 웹 검색이나 심층 파일 관리 같은 고급 기능은 JSON 방식으로 추가하는 것이 가장 효율적입니다.
방법 ① JSON 설정 — 윈도우·맥 단계별 완전 가이드
JSON 방식은 클로드 MCP 서버를 가장 폭넓게 활용할 수 있는 방법입니다. 터미널이나 명령 프롬프트를 한 번만 다루면 이후로는 설정 파일만 수정해서 원하는 서버를 자유롭게 추가할 수 있습니다. 준비물은 Node.js 22 이상 버전과 Claude Desktop 앱, 그리고 원하는 MCP 서버의 API 키입니다.
STEP 1 — Node.js 22 이상 설치
Node.js는 MCP 서버들이 구동되는 엔진입니다. nodejs.org에서 LTS 버전(22 이상)을 내려받아 설치하세요. 설치 후 터미널에서 node -v를 입력해 버전을 확인합니다.
STEP 2 — Claude Desktop 설정 파일 열기
설정 파일 위치가 운영체제마다 다릅니다. 아래 경로로 파일을 찾아 메모장이나 VS Code로 여세요.
Windows 경로
%APPDATA%\Claude\claude_desktop_config.json
macOS 경로
~/Library/Application Support/Claude/claude_desktop_config.json
STEP 3 — 설정 파일에 MCP 서버 추가
아래는 가장 많이 쓰이는 MCP 서버 3종을 한꺼번에 등록하는 설정 파일 전체 예시입니다. YOUR_API_KEY 부분에 실제 발급받은 키를 넣으면 됩니다.
{
"mcpServers": {
"brave-search": {
"command": "npx",
"args": ["-y", "@modelcontextprotocol/server-brave-search"],
"env": { "BRAVE_API_KEY": "YOUR_BRAVE_API_KEY" }
},
"tavily-mcp": {
"command": "npx",
"args": ["-y", "tavily-mcp@0.1.3"],
"env": { "TAVILY_API_KEY": "YOUR_TAVILY_API_KEY" }
},
"sequential-thinking": {
"command": "npx",
"args": ["-y", "@modelcontextprotocol/server-sequential-thinking"]
}
}
}
STEP 4 — Claude Desktop 재시작 및 연결 확인
파일 저장 후 Claude Desktop을 완전히 종료하고 다시 실행합니다. 채팅창 하단 + 버튼 → 커넥터를 클릭하면 등록한 MCP 서버 목록이 나타납니다. 목록에 서버 이름이 보이면 연결 성공입니다.
⚠️ 주의사항
Tavily 설치 시 Cannot find module 'zod' 오류가 나면, 터미널에서 npm install -g zod@3.22.4 --save-exact를 먼저 실행하세요. 패키지 의존성 문제로 발생하는 가장 흔한 오류입니다.
방법 ② 커넥터 설정 — 코딩 없이 노션·Gmail 연결
2026년 들어 Anthropic이 가장 공을 들이고 있는 기능이 바로 커넥터(Connector)입니다. JSON 파일을 건드리지 않고 클릭 몇 번만으로 Notion, Gmail, Google Calendar 등을 연결하는 방식으로, Anthropic이 안전성을 검토한 공식 MCP 서버만 제공됩니다. 보안 걱정 없이 쓸 수 있다는 점이 가장 큰 장점입니다.
Notion 커넥터 연결 4단계
Claude 채팅창 하단 + 버튼을 클릭 → 커넥터 관리 선택
커넥터 관리 페이지에서 + 버튼 클릭 → 검색창에 notion 입력 → Notion 카드의 + 버튼 클릭
브라우저가 열리면 Notion MCP 연결 페이지에서 연결할 워크스페이스를 선택 → 계속하기 클릭
Claude 화면 우측 상단에 “Notion에 연결되었습니다.” 알림 확인 → 완료
연결 후 커넥터 관리 페이지에서 Notion의 도구 권한을 설정할 수 있습니다. 읽기 5개 도구는 기본적으로 ‘항상 허용’으로 설정되어 있고, 쓰기·삭제 7개 도구는 기본값이 ‘매번 확인’입니다. Claude가 노션 페이지를 자동으로 생성하거나 수정하게 하려면 쓰기 도구 권한도 ‘항상 허용’으로 바꿔줘야 원활하게 작동합니다.
실제 사용해보면 “내 노션에 ‘2026년 3월 계획’ 페이지 만들고 주간 체크리스트 레이아웃 잡아줘“라고 입력하는 것만으로 Claude가 워크스페이스에 직접 접속해 페이지를 생성합니다. 목표 테이블, 주차별 토글, 카테고리 체크리스트까지 자동으로 구성되는 것을 확인할 수 있습니다.
꼭 설치해야 할 MCP 서버 TOP 5
수백 개의 MCP 서버 중에서도 실용성 기준으로 솎아낸 5개입니다. 처음 설정하는 분이라면 이 5개만 넣어도 Claude의 활용 범위가 완전히 달라집니다.
Tavily Search — 심층 웹 검색
단순 검색이 아니라 출처를 포함한 심층 검색 결과를 제공합니다. Claude에게 “최신 AI 뉴스 찾아줘”라고 하면 실제 링크와 근거까지 포함해 답변합니다. 무료 플랜으로도 월 1,000회 요청이 가능해 일반 사용자에게 충분합니다.
Filesystem — 내 PC 파일 직접 접근
지정한 폴더 내 파일을 Claude가 직접 읽고 쓸 수 있게 됩니다. “Downloads 폴더에 있는 PDF 요약해줘”처럼 사용할 수 있습니다. 보안을 위해 접근 허용 폴더를 반드시 제한해 설정하세요.
Sequential Thinking — 단계적 추론 강화
복잡한 문제를 여러 단계로 쪼개 사고하도록 돕는 메타인지 도구입니다. API 키 없이 설치 가능하며, 긴 기획서 작성이나 논리적 분석이 필요한 작업에서 체감 품질 차이가 큽니다.
Memory — 대화 장기 기억
기본 Claude는 대화가 끝나면 내용을 잊습니다. Memory MCP를 사용하면 사용자 정보·선호·이전 작업 내용을 지속적으로 기억해 개인화된 응답이 가능해집니다. 동일 주제를 반복 작업하는 사용자에게 필수입니다.
YouTube MCP — 영상 자막 요약
YouTube URL을 넣으면 Claude가 자막을 내려받아 핵심 내용을 정리해줍니다. 1시간짜리 강의를 5분 만에 소화할 수 있어 학습·리서치 작업에 활용도가 매우 높습니다.
MCP 연결 안 될 때 — 실전 오류 해결법
클로드 MCP 서버를 처음 설정하다 보면 크게 세 가지 오류를 자주 만납니다. 각각의 증상과 해결법을 정리했습니다. 대부분의 문제는 JSON 문법 오류나 Node.js 버전 불일치에서 발생하므로, 아래 순서대로 점검하면 빠르게 해결됩니다.
오류 1 — 서버 목록이 안 뜨는 경우
가장 흔한 원인은 claude_desktop_config.json 파일의 JSON 문법 오류입니다. 콤마 하나, 중괄호 하나만 빠져도 전체 설정이 무효가 됩니다. jsonlint.com에 설정 내용을 붙여 넣어 문법 검사를 먼저 하세요.
오류 2 — 서버는 뜨는데 도구 사용 시 오류
API 키가 잘못 입력됐거나 만료된 경우입니다. Tavily나 Brave 대시보드에 로그인해 키가 활성화 상태인지 확인하고, 설정 파일에서 키를 다시 복사 붙여 넣으세요. 키 앞뒤에 빈칸이 들어가는 실수도 흔합니다.
오류 3 — Windows에서 업데이트 후 MCP가 사라지는 경우
2026년 2월 Claude Desktop 업데이트 이후 Windows 일부 환경에서 전역 설정이 초기화되는 버그가 보고됐습니다. 이 경우 프로젝트 폴더의 .claude/settings.json에 MCP 서버 설정을 고정하면 업데이트와 무관하게 유지됩니다. Claude 설정 > 개발자 탭에서 로그를 확인하면 구체적인 오류 원인을 파악할 수 있습니다.
🔍 연결 상태 확인 방법
채팅창 하단 + 버튼 → 커넥터를 클릭하면 현재 연결된 MCP 서버 목록과 각 도구 상태를 바로 확인할 수 있습니다. 서버 이름 옆에 초록 점이 표시되어 있어야 정상 작동 중인 상태입니다.
Q&A — 가장 많이 묻는 질문 5가지
마치며 — 총평
클로드 MCP 서버는 단순한 기능 추가가 아닙니다. AI를 ‘쓰는 도구’에서 ‘함께 일하는 파트너’로 바꾸는 전환점입니다. 지금 이 순간에도 JSON 설정 파일 하나로 Claude가 내 노션에 글을 쓰고, 내 파일을 정리하고, 최신 뉴스를 검색해 오는 환경이 이미 구현되어 있습니다.
처음에는 JSON 파일이나 API 키 발급이 낯설게 느껴질 수 있습니다. 하지만 커넥터 방식을 먼저 경험하면 그 막막함이 확 줄어듭니다. 노션 하나만 연결해봐도 MCP가 업무에서 어떤 의미인지 체감할 수 있습니다. 시작은 작게 해도 충분합니다. 중요한 건 지금 시작하는 것입니다.
🚀 오늘 바로 해볼 한 가지
Claude Desktop을 켜고 채팅창 하단 + 버튼을 누르세요. 커넥터 관리 → 노션 추가. 딱 3분이면 충분합니다. “내 노션에 이번 주 할 일 페이지 만들어줘”라고 입력하는 순간, MCP가 왜 게임 체인저인지 직접 확인하게 됩니다.
※ 본 콘텐츠는 2026년 3월 12일 기준으로 작성되었습니다. MCP 서버의 설정 방법, API 정책, 지원 범위는 각 서비스 업데이트에 따라 변경될 수 있습니다. 설치 전 공식 문서를 반드시 확인하세요. API 키는 외부에 노출되지 않도록 각별히 관리하시기 바랍니다.


댓글 남기기