MCP 서버란 무엇인가 — 역할·구조와 로컬·원격 서버 연결 방법
MCP 서버의 뜻과 역할부터 로컬 stdio·원격 SSE 차이, Claude Desktop·Cursor 연결 설정, 보안·비용 비교, 오류 해결까지 한 편으로 끝내는 종합 가이드입니다.
MCP 서버(Model Context Protocol Server)는 AI 클라이언트가 외부 도구·데이터·서비스에 접근할 수 있도록 표준 인터페이스를 제공하는 경량 프로세스입니다. Claude, Cursor, Windsurf 같은 AI 클라이언트가 파일을 읽거나 API를 호출할 때, 그 요청을 받아서 실행하고 결과를 돌려주는 역할을 합니다. 즉, MCP 서버는 AI와 외부 세계를 연결하는 다리입니다. 로컬에서 돌아가는 서버와 원격에서 돌아가는 서버로 나뉘며, 둘의 차이를 이해하면 어떤 서버를 선택·설치·배포할지 금방 판단할 수 있습니다.
MCP 서버가 왜 필요한가
기본 Claude나 GPT는 대화 맥락 안에 있는 텍스트만 처리할 수 있습니다. 내 컴퓨터의 파일, 회사 데이터베이스, 한국 공공 API 같은 외부 정보에는 손을 댈 수 없습니다. 이 한계를 극복하기 위해 Anthropic이 설계한 개방형 표준이 **Model Context Protocol(MCP)**이고, 이 프로토콜을 구현한 서버가 MCP 서버입니다.
MCP 이전에는 각 AI 도구 회사가 저마다 다른 방식으로 플러그인을 만들었습니다. MCP는 그 방식을 통일해, 한 번 만든 MCP 서버를 Claude, Cursor, 기타 MCP 호환 클라이언트 어디서나 재사용할 수 있게 합니다.
MCP 서버의 핵심 역할 3가지
| 역할 | 설명 | 예시 |
|---|---|---|
| Tools(도구) | AI가 호출할 수 있는 실행 함수 제공 | 파일 읽기, API 호출, DB 쿼리 |
| Resources(리소스) | AI에게 읽기 전용 데이터를 노출 | 문서 목록, 로그 파일, 설정값 |
| Prompts(프롬프트) | 반복 사용 가능한 프롬프트 템플릿 제공 | 코드 리뷰 템플릿, 이메일 초안 |
대부분의 MCP 서버는 Tools에 집중합니다. AI가 “이 함수를 실행해라”라고 요청하면 MCP 서버가 실제 동작을 수행하고 결과를 JSON 형태로 반환합니다.
MCP 서버의 구조 — 어떻게 통신하는가
AI 클라이언트(Claude Desktop · Cursor · Windsurf)
│
│ MCP 프로토콜 (JSON-RPC 2.0 over stdio 또는 HTTP/SSE)
▼
MCP 서버 프로세스
│
│ 직접 호출 or HTTP 요청
▼
외부 시스템 (파일시스템 · 한국 공공 API · 데이터베이스 · SaaS)
통신 방식은 두 가지입니다.
- stdio 방식: 클라이언트가 MCP 서버 프로세스를 직접 실행하고, 표준 입출력(stdin/stdout)으로 JSON-RPC 메시지를 주고받습니다. 네트워크 포트를 열지 않으며, 로컬 서버가 주로 이 방식을 씁니다.
- HTTP/SSE 방식: 클라이언트가 원격 서버의 HTTP 엔드포인트에 연결하고, Server-Sent Events(SSE)로 스트리밍 응답을 받습니다. 클라이언트는 SSE 스트림을 유지하며 도구 응답·알림을 실시간으로 수신하고, 서버에 요청을 보낼 때는 별도의 HTTP POST 엔드포인트를 쓰는 것이 일반적입니다. 팀 공유용 원격 서버에 적합합니다.
Host · Client · Server — 세 역할은 어떻게 나뉘나
MCP 문서를 읽다 보면 서버 말고도 Host와 Client라는 용어가 나옵니다. 사용자가 이름을 알고 쓰는 앱과 그 내부에서 서버와 말하는 부품을 구분해 두면 설정이 틀어졌을 때 어디를 볼지 판단하기 쉽습니다.
| 구성 요소 | 역할 | 예시 |
|---|---|---|
| Host | 사용자가 직접 실행하는 AI 앱. 여러 Client를 만들고 관리합니다 | Claude Desktop, Cursor, Windsurf |
| Client | Host 내부에서 특정 MCP 서버 하나와 1:1 세션을 유지하는 연결 담당 모듈 | Host 앱에 내장된 부품 |
| Server | 도구·리소스·프롬프트를 실제로 노출하는 독립 프로세스 또는 원격 엔드포인트 | 파일 시스템 서버, KorDoc, HWP-MCP |
사용자
│
▼
[Host: Claude Desktop / Cursor]
├─ [Client A] ── [MCP 서버: 파일 시스템]
├─ [Client B] ── [MCP 서버: KorDoc (공문서 변환)]
└─ [Client C] ── [MCP 서버: HWP-MCP (한글 문서)]
Host는 하나지만 서버는 여러 개를 동시에 연결할 수 있고, 서버마다 별도의 Client가 담당하기 때문에 한 서버가 죽어도 다른 서버의 연결은 영향을 받지 않습니다. 설정 파일의 mcpServers에 항목을 하나 추가하는 일은 Host에게 「이 서버용 Client를 하나 더 만들어라」라고 알려 주는 일이라고 이해하면 됩니다. 그래서 같은 서버를 Claude Desktop과 Cursor에 각각 등록하면 서로 독립된 연결이 생깁니다.
요청이 흘러가는 예: 한글 문서 요약
사용자가 「이 hwpx 파일을 요약해 줘」라고 입력하면 Host 안의 모델이 문서 변환 도구가 필요하다고 판단해 도구 호출을 요청하고, 해당 서버의 Client가 이를 서버에 전달합니다. 서버는 로컬 파일을 읽어 Markdown 텍스트로 돌려주고, 모델은 그 텍스트로 요약을 생성합니다. 이때 모델 자체는 바뀌지 않았고 서버만 추가됐다는 점이 MCP의 핵심입니다. 서버를 교체하거나 늘리는 것만으로 모델이 할 수 있는 일이 확장됩니다.
MCP 서버와 일반 REST API 서버는 무엇이 다른가
REST API는 요청 하나에 응답 하나로 끝나는 호출 규약이고, 어떤 엔드포인트가 있는지는 개발자가 문서를 보고 알아야 합니다. MCP 서버는 연결 시 자신이 제공하는 도구 목록과 입력 형식을 스스로 알려 주므로, 모델이 문서를 읽지 않고도 어떤 도구를 어떻게 부를지 판단할 수 있습니다. 또 표준 규격이라 한 번 만든 서버를 여러 Host에서 재사용할 수 있습니다. 다만 MCP 서버가 내부에서 외부 REST API를 호출하는 구조도 흔해서, 둘은 경쟁 관계라기보다 MCP가 REST API 위에 얹히는 층으로 보는 편이 정확합니다.
로컬 MCP 서버 vs 원격 MCP 서버
두 유형의 차이를 정확히 이해하면 설치·운영·배포 방식 선택이 쉬워집니다.
| 항목 | 로컬 (stdio) | 원격 (SSE/HTTP) |
|---|---|---|
| 실행 위치 | 내 PC/Mac | 클라우드·사내 서버 |
| 전송 방식 | 표준 입출력 (프로세스 간) | HTTP + SSE (네트워크) |
| 연결 방법 | command + args | url(HTTP 엔드포인트) |
| 접근 권한 | 로컬 파일·환경에 직접 접근 | 네트워크로만 접근 |
| 팀 공유 | 불가 (1인 1머신) | 가능 (URL 공유) |
| 상시 가동 | 불가 (클라이언트 실행 시만) | 가능 (24/7 서버) |
| 보안 경계 | 로컬 프로세스 권한 | TLS + 인증 필요 |
| 데이터 이동 | 외부 전송 없음 | 네트워크 경유 |
| 설치 난이도 | 낮음 (npx 한 줄) | 중간~높음 (서버 배포 필요) |
| 운영 비용 | 없음 | 월 $0~20+ (규모별) |
| 응답 속도 | 프로세스 간 통신, 빠름 | 네트워크 레이턴시 추가 |
초보자라면 로컬 MCP 서버부터 시작하는 것이 좋습니다. 별도 서버 없이 npx 한 줄로 Claude Desktop에 연결할 수 있기 때문입니다. 선택 기준을 한 줄로 요약하면: 혼자 쓰고 데이터가 민감하면 로컬 stdio, 팀과 공유하거나 외부에서 접근해야 하면 원격 SSE입니다.
MCP 서버 예시 — 실제 한국형 서버들
한국 개발자들이 만든 MCP 서버 중 개념을 이해하는 데 가장 명확한 예시를 살펴봅니다. 세 서버 모두 로컬 stdio 방식으로, 별도 서버 설치 없이 npx 명령 한 줄로 Claude Desktop과 연결됩니다. 문서 처리 데이터가 로컬을 벗어나지 않아 개인 또는 사내 용도에 적합합니다.
코르독(KorDoc) — 공문서 변환 서버
코르독(KorDoc)은 HWP, HWPX, PDF, XLSX, DOCX 등 한국 공문서를 Markdown으로 변환해주는 MCP 서버입니다. Claude가 “이 HWP 파일 요약해줘”라고 요청하면, KorDoc 서버가 파일을 읽고 Markdown으로 변환한 텍스트를 Claude에게 돌려줍니다.
npx -y kordoc setup
HWP-MCP — 한글 문서 편집 서버
HWP-MCP는 AI 어시스턴트가 한글(.hwp/.hwpx) 문서를 읽고 편집·생성할 수 있게 해주는 MCP 서버입니다. 단순 변환을 넘어 문서를 실제로 수정하는 도구를 제공합니다.
npx -y hwp-mcp
한포지(HwpForge) — HWPX 읽기·쓰기·변환
한포지(HwpForge)는 HWPX 문서를 AI 에이전트가 읽고, 쓰고, 변환하는 도구 세트를 갖춘 MCP 서버입니다. 한컴 한글 HWPX(KS X 6101) 표준을 기반으로 합니다.
npx -y @hwpforge/mcp
로컬 MCP 서버 연결하기 (stdio)
로컬 서버는 클라이언트가 직접 자식 프로세스로 실행합니다. Claude Desktop 기준 설정 파일 위치는 다음과 같습니다.
- macOS:
~/Library/Application Support/Claude/claude_desktop_config.json - Windows:
%APPDATA%\Claude\claude_desktop_config.json
npx 기반 서버 등록 예시(한포지):
{
"mcpServers": {
"hwpforge": {
"command": "npx",
"args": ["-y", "@hwpforge/mcp"]
}
}
}
직접 작성한 서버 파일을 실행할 때는 command에 런타임을, args에 스크립트 경로를 지정합니다.
{
"mcpServers": {
"my-local-server": {
"command": "node",
"args": ["/Users/yourname/my-mcp-server/index.js"]
}
}
}
여러 서버를 동시에 등록할 때는 mcpServers 객체 안에 항목을 나란히 추가합니다.
{
"mcpServers": {
"kordoc": {
"command": "npx",
"args": ["-y", "kordoc", "mcp"]
},
"hwp-mcp": {
"command": "npx",
"args": ["-y", "hwp-mcp"]
}
}
}
설정 파일 저장 후 Claude Desktop을 완전히 종료(트레이 아이콘 포함)하고 다시 시작하면 MCP 서버가 인식됩니다. 채팅 입력창 좌측 하단의 도구 아이콘을 클릭하면 활성화된 MCP 서버 목록을 볼 수 있습니다.
원격 MCP 서버 연결하기 (SSE / HTTP)
원격 서버는 이미 실행 중인 HTTP 서버에 URL 하나로 연결합니다. 로컬에서 프로세스를 띄울 필요 없이, 클라우드나 사내에 배포된 서버를 여러 클라이언트가 동시에 사용할 수 있고, 서버를 업데이트하면 클라이언트마다 재설치하지 않아도 일괄 반영됩니다.
설정 파일 위치 (클라이언트별)
| 클라이언트 | 설정 파일 경로 |
|---|---|
| Claude Desktop (macOS) | ~/Library/Application Support/Claude/claude_desktop_config.json |
| Claude Desktop (Windows) | %APPDATA%\Claude\claude_desktop_config.json |
| Cursor | .cursor/mcp.json (프로젝트별) 또는 전역 설정 |
SSE 타입 서버 항목 추가
mcpServers 오브젝트에 command/args 대신 url을 지정합니다.
{
"mcpServers": {
"my-remote-server": {
"type": "sse",
"url": "https://my-mcp-server.example.com/sse"
}
}
}
"my-remote-server"— 클라이언트에서 보여줄 서버 이름(임의 지정 가능)"type": "sse"— SSE 방식임을 명시하는 값"url"— 원격 서버의 SSE 엔드포인트 전체 URL (예:https://도메인/sse)
로컬과 원격 서버를 한 파일에 함께 둘 수도 있습니다.
{
"mcpServers": {
"existing-local-server": {
"command": "npx",
"args": ["-y", "some-mcp-package"]
},
"my-remote-server": {
"type": "sse",
"url": "https://my-mcp-server.example.com/sse"
}
}
}
인증 헤더 추가 (필요한 경우)
서버가 API 키나 Bearer 토큰 인증을 요구한다면 headers 필드를 추가합니다.
{
"mcpServers": {
"my-remote-server": {
"type": "sse",
"url": "https://my-mcp-server.example.com/sse",
"headers": {
"Authorization": "Bearer YOUR_API_TOKEN_HERE"
}
}
}
}
토큰 값을 설정 파일에 평문으로 저장하게 되므로, 파일 접근 권한 관리에 유의하고 git 등 버전 관리 시스템에는 올리지 않도록 합니다.
로컬에서 개발 중인 SSE 서버는 url에 http://localhost:포트번호/sse처럼 로컬 주소를 입력해 연결할 수 있습니다. 설정 저장 후에는 마찬가지로 클라이언트를 완전히 종료했다가 다시 실행합니다.
보안 관점: 어떤 방식이 더 안전한가
로컬 서버의 보안
로컬 서버는 데이터가 네트워크를 경유하지 않습니다. 민감한 내부 문서, 개인 파일, 사내 데이터베이스를 다루는 경우 로컬 실행이 원칙적으로 더 안전합니다. 단, MCP 서버 프로세스는 클라이언트와 동일한 사용자 권한으로 실행되므로, 파일 시스템 접근·쉘 명령 실행 같은 광범위한 도구를 무분별하게 허용하면 취약점이 생길 수 있습니다.
원격 서버의 보안 요구사항
원격 서버는 인터넷에 노출되므로 반드시 다음을 갖춰야 합니다.
- TLS(HTTPS): 전송 구간 암호화. Let’s Encrypt 무료 인증서나 Cloudflare를 활용하면 됩니다.
- 인증: Bearer 토큰, API 키, 또는 OAuth2. 미인증 요청은 즉시 거부해야 합니다.
- Rate Limiting: 과도한 요청 차단.
- 환경 변수 관리: API 키를 코드에 하드코딩하지 않고 서버 환경 변수로 관리합니다.
성능과 비용 관점
로컬 stdio 방식은 프로세스 간 통신이라 네트워크 레이턴시가 없어 일반적으로 수 밀리초 이내로 응답합니다. 원격 서버는 왕복 네트워크 시간(RTT)이 추가되는데, 국내 클라우드(AWS 서울, GCP 서울 리전 등)를 사용하면 RTT가 보통 10~30ms 수준이라 대부분의 시나리오에서 체감 차이는 크지 않습니다. 단, 대용량 파일을 주고받거나 다수의 연속 호출이 필요하면 로컬이 유리합니다.
비용 측면에서 로컬 서버는 별도 인프라 비용이 전혀 없습니다. 원격 배포 시 주요 플랫폼의 대략적인 비용은 다음과 같습니다.
| 플랫폼 | 무료 티어 | 유료 기준 |
|---|---|---|
| Cloudflare Workers | 10만 요청/일, 무료 | $5/월 (유료 플랜) |
| Railway | 월 $5 크레딧 제공 | 사용량 기반 |
| Fly.io | 소규모 앱 무료 | 메모리·CPU 기반 |
| AWS Lambda | 월 100만 요청 무료 | 이후 요청당 과금 |
팀 내부 도구 수준의 트래픽(일 수백~수천 요청)은 무료 티어로 충분한 경우가 많습니다.
로컬 stdio에서 원격 SSE로 마이그레이션하기
기존 로컬 서버를 원격 서버로 전환하는 기본 흐름입니다.
1단계: HTTP 서버 레이어 추가 — MCP TypeScript SDK의 SSEServerTransport를 사용합니다.
npm install @modelcontextprotocol/sdk express
기존 구조: index.ts (stdio)
└── StdioServerTransport
변경 구조: server.ts (HTTP)
└── Express 앱
└── SSEServerTransport (/sse 엔드포인트)
2단계: 클라이언트 설정 변경 — 로컬 설정의 command/args를 url로 교체합니다(위 원격 연결 예시 참고).
3단계: 인증 추가 — 서버 측에서 미들웨어로 요청 헤더를 검증하고, 클라이언트 설정에 headers를 추가합니다.
4단계: 배포 — Cloudflare Workers, Railway, Fly.io 등 원하는 플랫폼에 배포합니다. HTTPS는 대부분 플랫폼에서 자동 적용됩니다.
흔한 오류와 해결 방법
서버가 목록에 나타나지 않음
- Node.js 설치 여부 확인: npx 방식 서버는 Node.js가 필요합니다.
node --version으로 확인하고, 버전이 출력되지 않으면 nodejs.org에서 LTS 버전을 설치하세요. - JSON 문법 오류 확인: 쉼표 위치, 중괄호 짝, 따옴표 누락 여부를 점검합니다. JSONLint 같은 검증 도구가 편리합니다.
- 파일 저장·경로 확인: 실제로 저장됐는지, 올바른 경로의 파일을 수정했는지 재확인합니다.
- 클라이언트 완전 재시작: 트레이에 남아 있는 프로세스까지 종료해야 합니다.
연결 오류 (Connection refused / Timeout)
- 서버 동작 확인: 브라우저나 curl로 URL에 직접 접근해 봅니다.
- 방화벽·CORS·보안 그룹 설정: 서버 포트가 외부에서 접근 가능한지, CORS가 클라이언트 접근을 허용하는지 확인합니다.
- URL 경로 확인:
/sse경로가 정확한지 서버 문서를 다시 확인합니다.
Claude Desktop의 로그는 macOS 기준 ~/Library/Logs/Claude/ 디렉토리에서 확인할 수 있습니다. 오류 메시지를 로그에서 직접 확인하면 원인 파악이 훨씬 빠릅니다.
인증 오류 (401 Unauthorized)
headers의 Authorization 값이 올바른지, 토큰이 만료되지 않았는지 확인합니다. 서버에 따라 X-API-Key 같은 커스텀 헤더를 사용하기도 하므로 서버 문서를 참조하세요.
SSE 연결이 자꾸 끊김
네트워크 타임아웃이나 프록시 설정이 원인인 경우가 많습니다. 서버 측에서 주기적인 ping 이벤트를 보내 연결을 유지하거나, 클라이언트 측 재연결 로직이 구현돼 있는지 확인하세요. HTTPS를 사용하면 중간 프록시로 인한 단절을 줄일 수 있습니다.
npx 명령이 느릴 때 / “Tool not found”
npx는 처음 실행 시 패키지를 다운로드하므로 수 초~수십 초가 걸릴 수 있고, 이후에는 캐시를 사용해 빨라집니다. 서버는 연결됐는데 특정 도구가 보이지 않으면, 해당 서버가 요구하는 추가 의존성(Python, HWP 뷰어 등)이 설치됐는지 각 서버의 GitHub 저장소를 확인하세요.
자주 묻는 질문
MCP 서버는 일반 웹 서버와 어떻게 다른가요?
일반 웹 서버는 HTTP 요청에 응답하지만, MCP 서버는 Model Context Protocol이라는 표준 규격을 따라 AI 클라이언트(Claude, Cursor 등)와 직접 통신합니다. AI가 어떤 도구를 쓸 수 있는지, 어떤 데이터를 조회할 수 있는지를 선언적으로 노출하는 점이 핵심 차이입니다.
로컬 MCP 서버와 원격 MCP 서버 중 어느 것을 선택해야 하나요?
민감한 파일이나 사내 데이터에 접근해야 할 때는 로컬 MCP 서버가 적합합니다. 팀 전체가 공유하거나 클라우드 서비스를 연동할 경우에는 원격 MCP 서버가 유리합니다. 시작 단계라면 로컬 설치가 훨씬 간단합니다.
stdio와 SSE(Server-Sent Events)는 무슨 차이인가요?
stdio는 프로세스 간 표준 입출력으로 통신하는 방식으로 로컬 전용이며, 클라이언트가 서버를 직접 실행합니다. SSE는 HTTP 기반 스트림으로, 이미 실행 중인 원격 서버에 URL로 접속하므로 여러 클라이언트가 동일 서버를 동시에 공유할 수 있습니다.
원격 MCP 서버를 배포하면 비용이 얼마나 드나요?
플랫폼에 따라 다릅니다. Cloudflare Workers는 무료 티어(10만 요청/일), Railway·Fly.io는 소규모 워크로드에서 월 $5~20 수준입니다. 트래픽이 낮은 팀 도구는 무료 티어로 충분한 경우가 많습니다.
기존 로컬 stdio 서버를 원격 SSE 서버로 전환하려면 어떻게 하나요?
MCP SDK의 SSEServerTransport 클래스로 HTTP 엔드포인트를 열고, 클라이언트 설정의 command/args 대신 url 키로 원격 주소를 지정하면 됩니다. 공식 MCP SDK 문서에서 예제를 확인하세요.
MCP 서버를 직접 만들어야 하나요?
꼭 그렇지는 않습니다. MCP모아 서버 목록에서 이미 완성된 한국형 MCP 서버를 찾아 바로 설치할 수 있습니다. 직접 개발이 필요할 때는 Anthropic 공식 SDK(TypeScript·Python)를 사용합니다.
MCP 서버 설치 후 클라이언트를 재시작해야 하나요?
네, claude_desktop_config.json(또는 클라이언트 설정 파일)을 수정한 뒤에는 클라이언트를 완전히 종료 후 재시작해야 새 MCP 서버가 인식됩니다.
여러 MCP 서버를 동시에 연결할 수 있나요?
가능합니다. mcpServers 항목에 로컬·원격 서버를 나란히 등록하면 됩니다. 각 서버는 독립적으로 동작하며 Claude가 필요에 따라 적절한 서버를 선택해 호출합니다.
다음 단계
MCP 서버의 개념과 연결 방법을 이해했다면, 이제 실제 서버를 설치해볼 차례입니다. 개발도구(devtools) 카테고리에서 다양한 MCP 서버를 둘러보세요. 한국 공문서 처리가 필요하다면 코르독(KorDoc), HWP-MCP, 한포지(HwpForge) 중 하나를 골라 바로 시작할 수 있습니다.
원격 배포를 계획 중이라면 공식 MCP SDK의 SSEServerTransport 예제로 HTTP 서버를 구성한 뒤 원하는 클라우드 플랫폼에 올려보세요. 직접 만든 MCP 서버를 공유하고 싶다면 MCP모아 서버 등록 페이지에서 신청해 한국 개발자 커뮤니티와 함께 MCP 생태계를 만들어갑니다.