혹시 이런 경험 해보셨나요? AI 어시스턴트에게 “내 로컬 파일을 읽어서 분석해줘” 혹은 “우리 회사 DB에 직접 쿼리를 날려봐”라고 요청했다가, AI가 “저는 그 파일에 접근할 수 없어요”라는 답변을 받아본 적이요. 2026년 현재, 이 답답함을 해소해주는 기술이 바로 MCP(Model Context Protocol)입니다.
Anthropic이 2024년 11월 공개한 MCP는 출시 1년 만에 GitHub에서 누적 스타 수 3만 개를 돌파하며 AI 개발 생태계의 핵심 프로토콜로 자리잡았습니다. 실제로 MCP를 도입한 개발팀들은 평균 업무 자동화율 62% 향상을 보고했으며, 단순 반복 작업에 소요되는 시간이 주당 평균 8시간 이상 절감됐다는 설문 결과도 있습니다. 이 글에서는 MCP 서버를 처음 접하는 분도 따라할 수 있도록 설치부터 연동까지 전 과정을 상세히 안내해드리겠습니다.
2. MCP 서버 설치 전 필수 준비사항
3. MCP 서버 설치 방법 – 단계별 완전 정복
4. Claude Desktop과 MCP 서버 연동하기
5. 인기 MCP 서버 TOP 5 추천 및 활용법
6. 자주 발생하는 오류와 해결법
7. 자주 묻는 질문 (Q&A)
• Node.js(v18 이상) 또는 Python(3.10 이상) 환경만 있으면 누구나 10분 내로 기본 MCP 서버를 설치할 수 있습니다.
• Claude Desktop, Cursor, Continue 등 주요 AI 툴은 모두 MCP를 공식 지원하며 설정 파일 하나로 연동됩니다.
• 파일시스템, GitHub, Slack, PostgreSQL 등 실무에 바로 쓸 수 있는 공식 MCP 서버가 무료로 제공됩니다.
1. MCP가 뭔가요? 쉽게 이해하는 개념 정리
MCP, 즉 Model Context Protocol은 AI 모델이 외부 도구, 파일 시스템, API, 데이터베이스 등과 표준화된 방식으로 소통할 수 있게 해주는 오픈 프로토콜입니다. 쉽게 비유하자면, AI와 세상 사이의 ‘만능 번역기’이자 ‘연결 다리’라고 생각하시면 됩니다.
기존에는 AI에게 특정 도구를 쓰게 하려면 각 도구마다 별도의 플러그인이나 커스텀 통합 코드를 짜야 했습니다. GitHub 연동을 하려면 GitHub 전용 플러그인, Slack 연동을 하려면 Slack 전용 코드… 이런 방식은 유지보수도 어렵고, AI 모델이 바뀔 때마다 처음부터 다시 만들어야 하는 문제가 있었습니다. MCP는 이 문제를 해결하기 위해 등장했습니다. “한 번 MCP 서버로 만들어두면, MCP를 지원하는 모든 AI 클라이언트에서 바로 쓸 수 있다”는 것이 핵심입니다.
MCP의 구조는 크게 세 가지로 나뉩니다. 첫째로 MCP 호스트(Host)는 Claude Desktop, Cursor 같은 AI 애플리케이션입니다. 둘째로 MCP 클라이언트(Client)는 호스트 안에 내장되어 서버와 통신하는 역할을 합니다. 셋째로 MCP 서버(Server)는 실제 파일 읽기, DB 쿼리, API 호출 등의 기능을 제공하는 프로그램입니다. 이 세 요소가 표준화된 JSON-RPC 프로토콜로 대화를 주고받으면서 AI가 마치 사람처럼 도구를 자유롭게 사용할 수 있게 됩니다.
2. MCP 서버 설치 전 필수 준비사항
MCP 서버 설치를 시작하기 전에 몇 가지 환경을 미리 갖춰두어야 합니다. 준비가 제대로 되어있지 않으면 설치 중간에 오류가 발생하거나 서버가 정상 작동하지 않을 수 있으니, 아래 체크리스트를 꼼꼼히 확인해주세요.
가장 먼저 확인해야 할 것은 런타임 환경입니다. MCP 서버는 대부분 Node.js 또는 Python으로 작성되어 있습니다. 2026년 기준으로 공식 Anthropic MCP 서버의 약 70%가 TypeScript/Node.js 기반이며, 나머지 30%가 Python 기반입니다. 따라서 Node.js와 Python 모두 설치해두는 것을 권장합니다.
| 항목 | 최소 요구사항 | 권장 사항 | 확인 명령어 |
|---|---|---|---|
| Node.js | v18.0 이상 | v20.x LTS (2026년 기준) | node –version |
| npm | v9.0 이상 | v10.x 이상 | npm –version |
| Python | 3.10 이상 | 3.12 이상 | python –version |
| uv (Python 패키지 관리자) | 선택사항 | 강력 권장 | uv –version |
| Git | v2.x 이상 | 최신 버전 | git –version |
| Claude Desktop (클라이언트) | 최신 버전 | 최신 버전 | 앱 실행 후 버전 확인 |
3. MCP 서버 설치 방법 – 단계별 완전 정복
이제 본격적으로 MCP 서버를 설치해봅시다. 가장 기본이 되는 공식 파일시스템(Filesystem) MCP 서버를 예시로 전체 과정을 설명하겠습니다. 이 서버는 AI가 여러분의 로컬 디렉토리를 읽고, 파일을 생성·수정·삭제할 수 있게 해주는 가장 기초적인 MCP 서버입니다.
Step 1 – Node.js 설치 확인 및 설치
터미널(윈도우는 PowerShell 또는 명령 프롬프트, Mac/Linux는 Terminal)을 열고 node –version을 입력해 Node.js가 설치되어 있는지 확인합니다. v18 미만이거나 설치가 안 되어 있다면 Node.js 공식 홈페이지(nodejs.org)에서 LTS 버전을 다운로드해 설치하세요. 2026년 현재 권장 LTS 버전은 Node.js 20.x입니다.
Step 2 – Claude Desktop 설치
MCP 클라이언트로 가장 많이 쓰이는 Claude Desktop을 claude.ai/download에서 다운로드합니다. Windows와 macOS 버전 모두 제공됩니다. 설치 후 Anthropic 계정으로 로그인해두세요. (무료 플랜도 MCP 서버 연동 기능을 지원합니다.)
Step 3 – MCP 설정 파일 위치 확인
Claude Desktop의 MCP 서버는 JSON 설정 파일 하나로 관리됩니다. 운영체제별 설정 파일 경로는 아래와 같습니다.
| 운영체제 | 설정 파일 경로 |
|---|---|
| macOS | ~/Library/Application Support/Claude/claude_desktop_config.json |
| Windows | %APPDATA%\Claude\claude_desktop_config.json |
| Linux | ~/.config/Claude/claude_desktop_config.json |
Step 4 – 설정 파일 편집
해당 경로에 설정 파일이 없다면 새로 생성하면 됩니다. VS Code, 메모장, nano 등 어떤 텍스트 에디터든 사용 가능합니다. 파일시스템 MCP 서버를 추가하는 기본 설정은 아래와 같은 JSON 구조를 가집니다. “args” 배열 안의 경로 부분에 AI가 접근을 허용할 본인의 폴더 경로를 넣어주면 됩니다. 예를 들어 macOS 사용자라면 “/Users/본인아이디/Documents”처럼 입력합니다. 보안을 위해 전체 루트 디렉토리보다는 특정 작업 폴더만 지정하는 것을 권장합니다.
설정 파일의 기본 구조는 “mcpServers”라는 최상위 키 아래에 각 서버의 이름을 키로, 그 안에 “command”(실행 명령어)와 “args”(인자 배열)를 지정하는 방식입니다. 파일시스템 서버의 경우 command는 “npx”, args는 [“-y”, “@modelcontextprotocol/server-filesystem”, “허용할 경로”]가 됩니다.
Step 5 – Claude Desktop 재시작 및 확인
설정 파일을 저장한 뒤 Claude Desktop을 완전히 종료했다가 다시 실행합니다. 채팅 입력창 하단 또는 설정 메뉴에서 MCP 서버 아이콘(망치 모양 또는 플러그 아이콘)이 표시된다면 정상적으로 연결된 것입니다. Claude에게 “내 Documents 폴더에 있는 파일 목록을 알려줘”라고 물어보면 실제 파일 목록을 읽어오는 것을 확인할 수 있습니다.
4. Claude Desktop과 MCP 서버 연동하기
기본 설치를 마쳤다면 이제 여러 MCP 서버를 동시에 추가하고 관리하는 방법을 알아보겠습니다. Claude Desktop의 설정 파일은 여러 MCP 서버를 동시에 등록할 수 있으며, 각 서버는 독립적으로 동작합니다. 실제 업무 현장에서는 보통 3~7개의 MCP 서버를 동시에 운용하는 경우가 많습니다.
예를 들어 마케터 A씨의 경우, 파일시스템 서버로 로컬 문서를 관리하고, Slack MCP 서버로 팀 채널 메시지를 분석하며, Google Drive MCP 서버로 스프레드시트를 자동으로 업데이트하는 3개의 서버를 동시에 사용하고 있습니다. 이 세 서버를 설정 파일의 “mcpServers” 객체 안에 각각 “filesystem”, “slack”, “gdrive” 같은 이름으로 나란히 등록해두면 Claude가 대화 중 상황에 맞춰 자동으로 적절한 서버를 선택해 사용합니다.
연동 시 자주 놓치는 중요한 포인트가 있습니다. 바로 환경 변수(API 키) 설정입니다. Slack이나 GitHub 같은 서비스 연동 MCP 서버는 해당 서비스의 API 키가 필요합니다. 이 API 키는 설정 파일의 “env” 섹션에 등록합니다. 예를 들어 Slack MCP 서버라면 “env”: { “SLACK_BOT_TOKEN”: “xoxb-여기에토큰입력” } 형태로 추가합니다. 절대로 이 토큰을 GitHub 등 공개 저장소에 올리지 마세요.
② API 키가 포함된 설정 파일(claude_desktop_config.json)을 절대 외부에 공유하지 마세요.
③ 신뢰할 수 없는 출처의 MCP 서버는 설치하지 마세요. 2026년 현재 악성 MCP 서버를 통한 데이터 탈취 사례가 보고된 바 있습니다.
④ Anthropic 공식 GitHub(github.com/modelcontextprotocol)에서 제공하는 서버를 우선 사용하세요.
5. 인기 MCP 서버 TOP 5 추천 및 활용법
2026년 현재 MCP 서버 생태계는 폭발적으로 성장해 공식·비공식 서버를 합하면 3,000개 이상이 존재합니다. 그 중 실무에서 가장 많이 쓰이고 안정성이 검증된 공식 MCP 서버 5가지를 엄선해 소개합니다.
| 서버명 | 주요 기능 | 추천 대상 | 설치 명령어 |
|---|---|---|---|
| Filesystem | 로컬 파일 읽기/쓰기/삭제, 디렉토리 탐색 | 모든 사용자, 필수 기본 서버 | npx @modelcontextprotocol/server-filesystem |
| GitHub | 레포지토리 관리, PR 생성, 이슈 처리, 코드 검색 | 개발자, DevOps 엔지니어 | npx @modelcontextprotocol/server-github |
| PostgreSQL | DB 스키마 조회, SQL 쿼리 실행, 데이터 분석 | 데이터 분석가, 백엔드 개발자 | npx @modelcontextprotocol/server-postgres |
| Brave Search | 실시간 웹 검색, 최신 뉴스 수집 | 리서처, 콘텐츠 크리에이터 | npx @modelcontextprotocol/server-brave-search |
| Slack | 채널 메시지 읽기/쓰기, 사용자 정보 조회 | 기업 사용자, 팀 협업 자동화 | npx @modelcontextprotocol/server-slack |
특히 PostgreSQL MCP 서버는 데이터 분석 업무에서 혁신적인 변화를 가져옵니다. 예를 들어 “지난 3개월 동안 가장 매출이 높은 제품 카테고리 TOP 10과 전월 대비 증가율을 계산해서 보고해줘”라고 Claude에게 요청하면, Claude가 직접 DB에 적절한 SQL 쿼리를 작성하고 실행해서 결과를 자연어로 분석해드립니다. 기존에 데이터 분석 요청이 오면 개발자가 쿼리를 짜서 결과를 받고 분석하는 데 평균 2~3시간이 걸리던 작업이, MCP를 통해 5분 내로 단축됩니다.
6. 자주 발생하는 오류와 해결법
MCP 서버를 처음 설치할 때 가장 많이 마주치는 오류 유형과 해결책을 정리했습니다. 설치 후 Claude Desktop에서 MCP 서버 아이콘이 나타나지 않거나, 도구 사용 중 에러가 발생한다면 아래 항목들을 순서대로 체크해보세요.
오류 1 – “spawn npx ENOENT” 또는 서버 연결 실패
이 오류는 Claude Desktop이 npx 명령어를 찾지 못할 때 발생합니다. 터미널에서는 npx가 잘 실행되더라도, GUI 앱인 Claude Desktop은 시스템 PATH를 다르게 인식하는 경우가 있습니다. 해결책은 설정 파일의 command 값에 npx 대신 npx의 전체 경로를 입력하는 것입니다. 경로는 터미널에서 which npx(Mac/Linux) 또는 where npx(Windows)로 확인할 수 있습니다. 예를 들어 macOS에서는 “/usr/local/bin/npx”처럼 절대 경로를 사용합니다.
오류 2 – JSON 파싱 오류
설정 파일의 JSON 문법이 틀리면 Claude Desktop이 설정을 불러오지 못합니다. 특히 경로에 백슬래시(\\)가 포함된 Windows 사용자분들이 자주 겪는 문제입니다. Windows 경로는 반드시 백슬래시를 두 개(\\\\)로 이스케이프하거나, 슬래시(/)로 대체해야 합니다. JSON 문법 오류는 jsonlint.com에서 설정 파일 내용을 붙여넣어 미리 검증해볼 수 있습니다.
오류 3 – API 권한 오류 (403 Forbidden)
GitHub, Slack 등 외부 서비스 MCP 서버에서 자주 발생합니다. API 토큰의 권한 범위(scope)가 충분하지 않을 때 나타납니다. 각 서비스의 개발자 설정 페이지에서 토큰을 재발급할 때 MCP 서버가 필요로 하는 권한을 모두 체크해야 합니다. 예를 들어 GitHub MCP 서버는 repo, read:org, read:user 권한이 필요합니다.
오류 4 – MCP 서버가 연결됐지만 도구가 보이지 않는 경우
Claude Desktop 버전이 너무 낮거나, 설정 파일을 수정한 후 앱을 완전히 재시작하지 않아서 생기는 문제입니다. 단순히 창을 닫고 다시 열어서는 안 되고, 시스템 트레이 또는 작업 표시줄에서 Claude 프로세스가 완전히 종료됐는지 확인 후 재시작해야 합니다. 그래도 안 된다면 Claude Desktop을 최신 버전으로 업데이트해보세요.