클로드 MCP 설치 방법 3가지 — 2026년 기준 커넥터·확장·JSON 완전 정리

클로드 MCP는 이제 JSON 파일을 직접 건드리지 않아도 설치할 수 있습니다. 2025년에는 claude_desktop_config.json을 열어 코드를 붙여넣는 것이 유일한 방법이었지만, 2026년 현재는 커넥터와 확장 프로그램(.mcpb)으로 클릭 몇 번이면 끝납니다.

이 글은 2026년 8월 기준으로 클로드 MCP 설치 방법 3가지를 난이도 순으로 정리했습니다. 개발 지식이 없어도 따라 할 수 있는 방법부터, 원하는 서버를 자유롭게 붙이는 고급 방법까지 순서대로 다룹니다. 설치 중 자주 막히는 지점과 해결법도 함께 담았습니다.

MCP를 붙이지 않은 클로드는 학습 시점 이후의 정보를 모르고, 내 파일도 읽지 못합니다. 반대로 MCP를 붙이면 워드프레스 발행, 파일 정리, 데이터 조회 같은 작업을 대화만으로 시킬 수 있습니다.

MCP란 무엇인가 (2026년 현재)

MCP(Model Context Protocol)는 AI 모델과 외부 도구를 연결하는 표준 규격입니다. AI의 USB-C 포트라고 생각하면 정확합니다. 한 번 MCP 방식으로 만들어진 도구는 어느 AI에서든 그대로 꽂아 쓸 수 있습니다.

MCP가 업계 표준이 된 과정

MCP는 2024년 11월 앤스로픽이 공개한 프로토콜입니다. 처음에는 클로드 전용처럼 보였지만, 지금은 상황이 완전히 달라졌습니다.

시점	사건
2024년 11월	앤스로픽이 MCP 공개
2025년 3월	오픈AI가 공식 채택 — ChatGPT 데스크톱 앱에 적용
2025년	구글 딥마인드·마이크로소프트·세일즈포스 지원 추가
2025년 12월	앤스로픽이 리눅스 재단 산하 Agentic AI Foundation에 기증 — 벤더 중립 표준으로 전환
2026년 현재	MCP 서버 2만 개 이상, SDK 월 다운로드 9,700만 건

리눅스 재단 기증에는 오픈AI와 블록이 공동 창립사로 참여했고, AWS·구글·마이크로소프트·클라우드플레어·블룸버그가 플래티넘 멤버로 합류했습니다. 더 이상 앤스로픽 한 회사의 기술이 아닙니다.

그래서 지금 MCP를 배워두면 클로드뿐 아니라 다른 AI 도구로 옮겨가도 그대로 쓸 수 있습니다.

MCP로 실제로 할 수 있는 일

• 파일 읽고 쓰기 — 내 컴퓨터의 문서를 클로드가 직접 열어보고 정리합니다
• 웹사이트 관리 — 워드프레스 글 발행·수정을 대화로 처리합니다
• 외부 서비스 연동 — 노션·깃허브·구글 드라이브·슬랙 등에 직접 접근합니다
• 데이터 조회 — 데이터베이스에 질문하고 답을 받습니다
• 브라우저 자동화 — 페이지를 열고 클릭하고 정보를 가져옵니다

클로드 MCP 설치 방법 3가지

2026년 현재 방법은 셋입니다. 위에서부터 시도하고, 안 되면 아래로 내려가세요. 대부분은 1번이나 2번에서 끝납니다.

방법	난이도	이럴 때 씁니다
① 커넥터	매우 쉬움	노션·깃허브 등 유명 서비스. 설치 없이 로그인만
② 확장 프로그램(.mcpb)	쉬움	배포 파일이 있는 서버. 더블클릭 설치
③ JSON 직접 편집	보통	위 둘에 없는 서버. 자유도 최고

방법 1. 커넥터로 연결하기 (가장 쉬움)

커넥터는 원격 MCP 서버입니다. 내 컴퓨터에 아무것도 설치하지 않고, 서비스에 로그인만 하면 연결됩니다.

1. 클로드 데스크톱 앱을 엽니다
2. 채팅 입력창 왼쪽 아래 + 버튼을 클릭합니다
3. 커넥터(Connectors)를 선택합니다
4. 목록에서 원하는 서비스를 찾아 연결을 누릅니다
5. 브라우저가 열리면 해당 서비스 계정으로 로그인하고 권한을 승인합니다

끝입니다. API 키를 발급받거나 파일을 편집할 필요가 없습니다. 인증은 OAuth 방식이라 비밀번호를 어딘가에 적어두지 않아도 됩니다.

목록에 없는 원격 서버는 커넥터 추가 → 사용자 지정 커넥터에서 주소(URL)를 직접 넣으면 됩니다.

방법 2. 확장 프로그램(.mcpb) 설치

.mcpb는 MCP 번들(MCP Bundle) 파일입니다. 서버 실행에 필요한 것들이 하나로 묶여 있어서 더블클릭이면 설치가 끝납니다.

이 방식의 가장 큰 장점은 Node.js 경로 문제에서 자유롭다는 점입니다. JSON 편집 방식에서 초보자가 가장 많이 막히는 지점이 바로 그것인데, 번들은 그 과정을 통째로 건너뜁니다.

1. 배포처에서 .mcpb 파일을 내려받습니다
2. 클로드 데스크톱 → 설정 → 확장 프로그램(Extensions)으로 이동합니다
3. 확장 프로그램 설치를 누르고 내려받은 파일을 선택합니다
4. 안내에 따라 설정값(API 키 등)을 입력하고 승인합니다

파일을 직접 더블클릭해도 클로드가 열립니다.

방법 3. JSON 직접 편집 (자유도 최고)

커넥터에도 없고 .mcpb도 없는 서버는 설정 파일에 직접 적어야 합니다. 2만 개가 넘는 MCP 서버 대부분이 아직 이 방식이라, 알아두면 선택지가 크게 넓어집니다.

준비물

• 클로드 데스크톱 앱 — claude.ai/download
• Node.js — nodejs.org (대부분의 MCP 서버가 Node 기반입니다)
• 도커 — 선택 사항. 일부 서버만 필요합니다

설정 파일 경로 찾기

가장 쉬운 방법은 앱에서 바로 여는 것입니다. 설정 → 개발자 → 설정 편집(Edit Config)을 누르면 파일이 있는 폴더가 바로 열립니다. 경로를 외울 필요가 없습니다.

운영체제	경로
맥	~/Library/Application Support/Claude/claude_desktop_config.json
윈도우	%APPDATA%Claudeclaude_desktop_config.json

맥에서 파인더로 직접 찾으려면 Command + Shift + .(점) 을 눌러 숨김 파일을 표시해야 Library 폴더가 보입니다.

설정 파일 작성 예시

파일 시스템 서버를 붙이는 예시입니다. 사용자명 부분만 본인 것으로 바꾸세요.

{
  "mcpServers": {
    "filesystem": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-filesystem",
        "/Users/사용자명/Documents"
      ]
    }
  }
}

저장한 뒤 클로드를 완전히 종료했다가 다시 실행합니다. 창만 닫으면 반영되지 않습니다. 맥은 Command + Q, 윈도우는 작업 표시줄 아이콘에서 완전 종료해야 합니다.

재시작 후 채팅창 아래 도구 아이콘에 서버가 나타나면 성공입니다.

클로드 코드에서 MCP 연결하기

터미널에서 쓰는 클로드 코드(Claude Code)는 명령어 한 줄로 서버를 추가합니다. JSON을 열 필요가 없습니다.

claude mcp add --scope user 서버이름 -- npx -y 패키지이름

원격 서버(커넥터 방식)는 이렇게 붙입니다.

claude mcp add --scope user --transport http 서버이름 https://주소

--scope 옵션을 빠뜨리지 마세요. 생략하면 명령을 실행한 그 폴더에서만 서버가 잡힙니다. 다른 프로젝트에서 안 보인다면 십중팔구 이 문제입니다. user로 지정하면 모든 프로젝트에서 쓸 수 있습니다.

등록 상태는 claude mcp list로 확인하고, 로그인이 필요한 서버는 /mcp 명령으로 인증합니다.

MCP 서버 추천 — 용도별

서버가 2만 개를 넘어 고르기가 더 어려워졌습니다. 처음이라면 아래 순서대로 하나씩 붙여보세요.

용도	서버	이런 일을 합니다
파일 관리	Filesystem	문서 읽기·쓰기·정리. 가장 먼저 붙일 서버
웹 검색	Brave Search	최신 정보 조회 (API 키 필요)
브라우저 자동화	Playwright	페이지 열기·클릭·정보 수집
메모·문서	Notion	노션 페이지 읽고 쓰기
개발	GitHub	저장소·이슈·PR 관리
디자인	Figma	디자인 파일에서 정보 추출
워드프레스	WordPress 원격	글 발행·수정을 대화로 처리

새 서버를 찾을 때는 공식 디렉터리나 pulsemcp.com 같은 목록 사이트를 참고하면 됩니다.

설치가 안 될 때 확인할 5가지

대부분의 실패는 아래 다섯 가지 중 하나입니다. 위에서부터 순서대로 확인하세요.

1. 앱을 완전히 종료하지 않았다

가장 흔한 원인입니다. 창을 닫는 것과 앱을 끄는 것은 다릅니다. 맥은 Command + Q, 윈도우는 작업 표시줄 아이콘 우클릭 → 종료까지 해야 설정이 다시 읽힙니다.

2. JSON 문법이 틀렸다

쉼표 하나만 빠져도 전체가 무시됩니다. 서버를 여러 개 추가할 때 중간 항목 뒤 쉼표를 빠뜨리는 실수가 가장 많습니다. 마지막 항목 뒤에는 쉼표를 붙이면 안 됩니다.

3. Node.js가 없거나 경로를 못 찾는다

터미널에서 node -v를 입력해 버전이 나오는지 확인하세요. 터미널에서는 되는데 클로드에서만 안 된다면, 앱이 npx 경로를 못 찾는 경우입니다. 이때는 방법 2(확장 프로그램)로 우회하는 것이 빠릅니다.

4. 경로에 한글이나 공백이 있다

폴더 이름에 한글이나 공백이 들어가면 서버가 실행되지 않는 경우가 있습니다. 가능하면 영문 경로를 지정하세요.

5. 인증이 끝나지 않았다

커넥터나 원격 서버는 등록과 로그인이 별개입니다. 등록만 해두고 인증을 안 하면 목록에는 보이는데 도구가 나타나지 않습니다. 인증을 마친 뒤에도 앱이나 세션을 다시 시작해야 도구가 잡힙니다.

자주 묻는 질문

마치며

정리하면 이렇습니다. 커넥터로 되면 커넥터로, 안 되면 확장 프로그램, 그것도 없으면 JSON 편집입니다. 1년 전처럼 처음부터 터미널을 열 필요는 없어졌습니다.

처음 붙일 서버로는 파일 시스템을 권합니다. 설정이 가장 단순하고, 내 문서를 클로드가 직접 읽는 순간 MCP가 왜 필요한지 바로 이해됩니다.

MCP가 리눅스 재단으로 넘어가면서 특정 회사에 묶이지 않는 기술이 됐습니다. 지금 익혀두면 앞으로 어떤 AI 도구를 쓰든 그대로 활용할 수 있습니다.

끝까지 읽어주셔서 감사합니다.

함께 읽으면 좋은 글들

클로드에 brave mcp 설치해서 웹검색 하는 방법

챗지피티 사주 프롬프트 모음: 재물운, 연애운, 직업운까지 한눈에!

유튜브 화질 저하 해결방법, 4K로 고정하는 초간단 설정

🔗 이어서 보면 좋은 글

• 챗GPT 프롬프트 템플릿 4요소 — 복사해서 쓰는 상황별 6종 (2026)