본문 바로가기
M MCP모아
가이드

MCP 클라이언트란? 호스트·서버와의 차이를 다이어그램으로 이해하기

MCP 클라이언트가 호스트·서버와 어떻게 다른지 다이어그램과 핸드셰이크 흐름으로 정확히 설명합니다. Claude Desktop 설정 예시와 흔한 혼동 정리 포함.

MCP 호스트, 클라이언트, 서버 세 계층의 관계를 보여주는 아키텍처 다이어그램 표지 이미지

MCP 클라이언트(MCP Client)란 MCP 아키텍처에서 MCP 서버와 직접 통신하며 Tool·Resource·Prompt를 요청하는 프로토콜 구성 요소입니다. Claude Desktop, Cursor 같은 응용 프로그램(호스트) 내부에 내장되어, AI 모델이 외부 도구를 자연스럽게 쓸 수 있도록 중간 다리 역할을 합니다.

MCP 설정에서 막히는 문제의 상당수는 호스트·클라이언트·서버를 구분하지 못해 생깁니다. “클라이언트를 따로 설치해야 하나?”, “서버 설정을 어디에 적어야 하나?” 같은 질문이 대표적입니다. 이 글은 세 개념을 다이어그램과 핸드셰이크 흐름으로 분리해 설명하고, 실제 설정 파일 예시까지 연결합니다.

한눈에 보는 요약

  • 호스트(Host): 사용자가 직접 실행하는 앱. AI 모델과 UI를 품는다. (Claude Desktop, Cursor, Claude Code)
  • 클라이언트(Client): 호스트 안에서 서버 1개와 1대1 연결을 관리하는 프로토콜 인스턴스. 호스트에 내장되어 별도 설치가 필요 없다.
  • 서버(Server): Tool·Resource·Prompt를 공급하는 독립 프로세스. 사용자가 추가하는 대상은 바로 이 서버다.

즉 사용자가 직접 손대는 것은 서버 등록뿐이고, 클라이언트는 호스트가 서버마다 자동으로 만들어 줍니다.

MCP 아키텍처의 세 구성 요소

MCP(Model Context Protocol)는 단순히 “AI와 외부 도구를 연결하는 프로토콜”이 아니라, 세 역할이 명확히 분리된 계층 구조를 정의합니다.

구성 요소영문역할대표 예시
호스트Host사용자가 직접 실행하는 응용 프로그램. AI 모델을 품고 UI를 제공한다Claude Desktop, Cursor, Claude Code
클라이언트Client호스트 내부에서 MCP 서버 1개와 1대1 연결을 관리하는 프로토콜 인스턴스호스트 코드 내 ClientSession
서버ServerTool·Resource·Prompt를 외부에 공급하는 독립 프로세스코르독, HWP-MCP, 한포지 등

핵심은 클라이언트가 호스트의 부분 집합이라는 점입니다. Claude Desktop을 설치하면 호스트와 클라이언트가 한 패키지로 따라옵니다. 별도로 클라이언트를 설치할 필요는 없고, 사용할 서버만 추가하면 됩니다.

MCP 클라이언트의 세 가지 책임

공식 MCP 사양에서 클라이언트는 다음 세 가지 일을 맡습니다.

  1. 연결 수립(Transport): MCP 서버 프로세스를 시작하거나(stdio) 네트워크 엔드포인트에 연결하고(SSE·HTTP), JSON-RPC 2.0 메시지 채널을 엽니다.
  2. 핸드셰이크(initialize): 프로토콜 버전과 지원 기능(capabilities)을 서버와 교환합니다.
  3. 요청 및 알림 처리: AI 모델이 필요로 할 때 tools/call, resources/read 등을 서버에 보내고, 응답을 다시 AI 모델에 전달합니다.

호스트가 여러 MCP 서버를 쓸 때는 서버마다 독립적인 클라이언트 인스턴스를 하나씩 만들어 병렬로 관리합니다. 예를 들어 Claude Desktop이 파일 관리 서버와 한글 문서 서버를 동시에 연결했다면, 내부에는 클라이언트 인스턴스가 두 개 존재하는 셈입니다. 한 서버에서 연결이 끊겨도 다른 서버는 영향을 받지 않는 이유가 여기에 있습니다.

호스트·클라이언트·서버 간 데이터 흐름

아래 다이어그램은 사용자 요청이 AI 모델까지 전달되고, 도구 호출 결과가 되돌아오는 전체 경로를 보여줍니다.

┌──────────────────────────────────────────┐
│              호스트 (Host)                │
│  예: Claude Desktop / Cursor / Claude Code│
│                                          │
│  ┌──────────────┐   ┌─────────────────┐  │
│  │  AI 모델     │◄──│  MCP 클라이언트  │  │
│  │ (Claude 등)  │──►│  (Client A)     │  │
│  └──────────────┘   └────────┬────────┘  │
│                              │ JSON-RPC  │
└──────────────────────────────┼───────────┘
                               │ stdio / SSE
                    ┌──────────▼──────────┐
                    │    MCP 서버 (Server) │
                    │  예: 코르독, HWP-MCP │
                    │                     │
                    │  Tools / Resources  │
                    │  / Prompts 제공     │
                    └──────────┬──────────┘
                               │ HTTP / 파일 시스템
                    ┌──────────▼──────────┐
                    │   외부 데이터 소스  │
                    │  (API, DB, 파일)    │
                    └─────────────────────┘

AI 모델은 클라이언트를 통해서만 서버와 대화합니다. 클라이언트는 모델 대신 JSON-RPC 메시지를 직렬화하고, 서버의 응답을 역직렬화해 모델이 이해할 수 있는 형태로 넘겨줍니다. 모델은 “어떤 트랜스포트로 어떤 서버에 붙어 있는지”를 알 필요가 없으며, 그 추상화를 담당하는 계층이 곧 클라이언트입니다.

클라이언트와 서버의 핸드셰이크 과정

연결이 처음 맺어질 때 클라이언트와 서버는 아래 순서로 핸드셰이크를 수행합니다.

클라이언트                        서버
    │──── initialize(버전, capabilities) ────►│
    │◄─── initialized(버전, capabilities) ────│
    │                                         │
    │──── tools/list ────────────────────────►│
    │◄─── Tool 목록 반환 ─────────────────────│
    │                                         │
    │──── resources/list ────────────────────►│
    │◄─── Resource 목록 반환 ─────────────────│
    │                                         │
    (이후 AI 모델 요청에 따라 tools/call 반복)

핸드셰이크가 완료돼야 AI 모델이 어떤 Tool이 있는지 알 수 있고, 실제 호출도 가능합니다. Claude Desktop이 새 MCP 서버를 인식하지 못한다면 대부분 이 초기 연결 단계의 문제입니다. 서버 프로세스가 뜨지 않았거나(command·args 오타), initialize 응답이 오지 않은 경우가 흔합니다. 이때는 도구 목록이 비어 보이거나 서버가 “연결 실패”로 표시됩니다.

자주 겪는 혼동과 올바른 이해

세 구성 요소를 혼동하면 다음과 같은 문제가 생깁니다.

오해결과올바른 이해
”MCP 클라이언트를 따로 설치해야 한다”불필요한 설치 시도클라이언트는 호스트(Claude Desktop 등)에 내장됨
”Claude Desktop이 MCP 서버다”서버 설정을 엉뚱한 곳에 하려 함Claude Desktop은 호스트·클라이언트, 서버는 별도 프로세스
”서버 하나에 클라이언트 하나만 연결 가능”서버를 여럿 못 쓴다고 포기호스트는 서버마다 독립 클라이언트를 생성해 다수 연결 가능
”클라이언트가 곧 AI 모델이다”역할 혼동으로 설정 오류클라이언트는 AI 모델과 서버 사이의 프로토콜 계층

Claude Desktop에서 클라이언트 동작 확인하기

Claude Desktop은 대표적인 MCP 호스트이자 클라이언트입니다. 아래 설정 파일에 서버를 추가하면 Claude Desktop이 해당 서버와의 클라이언트 연결을 자동으로 생성합니다.

macOS 기준 설정 파일 위치:

~/Library/Application Support/Claude/claude_desktop_config.json

서버 두 개를 동시에 등록하는 예시:

{
  "mcpServers": {
    "kordoc": {
      "command": "npx",
      "args": ["-y", "kordoc", "mcp"]
    },
    "hwp-mcp": {
      "command": "npx",
      "args": ["-y", "hwp-mcp"]
    }
  }
}

위처럼 두 서버를 등록하면 Claude Desktop은 앱 시작 시 kordoc용 클라이언트와 hwp-mcp용 클라이언트를 각각 생성해 독립 프로세스로 실행합니다. mcpServers의 각 키(예: kordoc, hwp-mcp)가 하나의 클라이언트-서버 연결에 대응한다고 보면 됩니다. 사용자는 이 인스턴스를 직접 다룰 필요 없이, Claude 대화창에서 자연어로 요청하기만 하면 됩니다.

설정을 바꿨다면 Claude Desktop을 완전히 종료 후 재시작해야 변경이 반영됩니다. 새 서버가 보이지 않으면 JSON 문법 오류, command/args 오타, 서버 패키지 미설치를 먼저 점검하세요.

실제 MCP 서버 예시 — 한국 문서 처리

개발 도구 카테고리에 등록된 한국산 MCP 서버들은 위 클라이언트-서버 구조 위에서 동작합니다. 대표적인 세 서버를 소개합니다.

코르독 (KorDoc)

코르독은 HWP·HWPX·PDF·XLSX·DOCX 등 한국 공문서를 Markdown으로 변환하는 MCP 서버입니다. GitHub 저장소는 https://github.com/chrisryugj/kordoc 에서 확인할 수 있으며, 설치 명령은 다음과 같습니다.

npx -y kordoc setup

API 키 없이 바로 쓸 수 있어 MCP 클라이언트-서버 구조를 처음 체험하기에 좋습니다.

HWP-MCP (한글 문서 MCP 서버)

HWP-MCP는 AI 어시스턴트가 한글(.hwp/.hwpx) 문서를 읽고 편집·생성할 수 있게 해주는 MCP 서버입니다. GitHub 저장소는 https://github.com/treesoop/hwp-mcp 에서 확인할 수 있습니다.

npx -y hwp-mcp

한포지 (HwpForge)

한포지는 한글(HWPX) 문서를 AI 에이전트가 읽고 쓰고 변환할 수 있게 해주는 MCP 서버로, 한컴 한글 HWPX(KS X 6101) API를 지원합니다. GitHub 저장소는 https://github.com/ai-screams/HwpForge 에서 확인할 수 있습니다.

npx -y @hwpforge/mcp

세 서버 모두 Claude Desktop 같은 MCP 클라이언트(호스트)에 claude_desktop_config.json을 통해 등록하면 바로 사용할 수 있습니다.

MCP 클라이언트 구현체 종류

대표적인 MCP 클라이언트(가 내장된 호스트) 구현체는 다음과 같습니다.

호스트(클라이언트 내장)종류트랜스포트 지원
Claude Desktop데스크톱 AI 앱stdio, SSE
CursorAI 코드 에디터stdio, SSE
Claude CodeCLI 개발 도구stdio, SSE
VS Code (Copilot)코드 에디터stdio, SSE
Continue오픈소스 코드 어시스턴트stdio

MCP 서버 개발자 입장에서는 위 클라이언트 중 어느 것과도 호환되도록 서버를 만들면 됩니다. 프로토콜이 표준화되어 있어, 하나의 MCP 서버를 Claude Desktop에서도 Cursor에서도 그대로 쓸 수 있습니다. 직접 클라이언트를 구현해야 한다면 Anthropic이 공개한 공식 SDK(TypeScript·Python)를 사용해 낮은 수준의 JSON-RPC 처리 없이 클라이언트 인스턴스를 만들 수 있습니다.

자주 묻는 질문

MCP 클라이언트와 MCP 호스트는 같은 건가요?

비슷해 보이지만 다릅니다. 호스트(Host)는 Claude Desktop, Cursor처럼 사용자가 직접 실행하는 응용 프로그램 자체를 가리키고, 클라이언트(Client)는 그 호스트 내부에서 MCP 서버와 1대1 연결을 관리하는 프로토콜 구성 요소입니다. 하나의 호스트가 여러 개의 클라이언트를 동시에 운영해 여러 서버와 통신할 수 있습니다.

MCP 클라이언트가 되려면 무엇이 필요한가요?

MCP SDK(TypeScript 또는 Python)를 사용해 클라이언트 인스턴스를 생성하고, 대상 MCP 서버와 stdio 또는 SSE/HTTP 트랜스포트로 연결을 맺으면 됩니다. Anthropic이 공개한 공식 SDK가 있어 낮은 수준의 프로토콜 구현 없이 시작할 수 있습니다.

Claude Desktop은 MCP 클라이언트인가요, MCP 서버인가요?

Claude Desktop은 MCP 호스트이자 클라이언트입니다. 사용자 인터페이스를 제공하는 호스트 역할을 하면서, 내부적으로 MCP 클라이언트 로직을 통해 외부 MCP 서버들과 통신합니다. Claude Desktop 자체는 MCP 서버가 아닙니다.

MCP 서버와 MCP 클라이언트의 가장 큰 차이는 무엇인가요?

역할이 반대입니다. MCP 서버는 Tool, Resource, Prompt를 공급하는 쪽이고, MCP 클라이언트는 그것을 요청하고 소비하는 쪽입니다. 서버는 외부 API나 데이터베이스와 연동되어 실제 기능을 제공하고, 클라이언트는 AI 모델이 그 기능을 언제 어떻게 쓸지 조율합니다.

하나의 MCP 호스트가 여러 서버에 동시에 연결할 수 있나요?

네, 가능합니다. Claude Desktop을 예로 들면 claude_desktop_config.json의 mcpServers 항목에 여러 서버를 나열하면 됩니다. 호스트는 서버마다 별도의 클라이언트 인스턴스를 만들어 병렬로 관리합니다.

MCP 클라이언트가 MCP 서버에게 최초로 요청하는 것은 무엇인가요?

연결이 맺어지면 클라이언트는 initialize 요청을 보내 프로토콜 버전과 자신의 기능(capabilities)을 교환합니다. 그 다음 tools/list, resources/list 등을 호출해 서버가 제공하는 Tool과 Resource 목록을 가져옵니다. 이 핸드셰이크가 끝난 뒤에야 AI 모델이 실제 Tool을 호출할 수 있습니다.

다음 단계

MCP 클라이언트·호스트·서버의 차이를 이해했다면, 이제 실제로 MCP 서버를 Claude Desktop에 연결해 볼 차례입니다.

이 글과 관련된 MCP 서버