MCP(Model Context Protocol) 완전 가이드

AI 에이전트가 GitHub를 열람하고, 데이터베이스를 조회하고, 웹을 검색하려면 무언가가 연결고리 역할을 해줘야 합니다. MCP(Model Context Protocol)는 바로 그 연결고리를 표준화한 오픈 프로토콜입니다. Anthropic이 2024년 11월 공개한 이후, 2026년 현재 200개 이상의 서버 구현체가 존재하며 Claude Code, Cursor, Windsurf, VS Code 등 주요 AI 도구들이 기본 지원합니다.

이 가이드는 MCP의 핵심 개념부터 Claude Code에서의 실제 설정, 인기 서버 목록, 직접 서버를 만드는 방법, 그리고 보안 주의사항까지 한 문서에 정리합니다. WSL + Windows 환경을 기준으로 설명합니다.

MCP란 무엇인가

MCP(Model Context Protocol)는 AI 애플리케이션이 외부 데이터 소스·도구·서비스와 표준화된 방식으로 통신하기 위한 오픈소스 프로토콜입니다. 흔히 "AI 앱의 USB-C"라 불립니다. USB-C가 어떤 기기든 동일한 포트로 연결하듯, MCP는 어떤 AI 앱이든 동일한 프로토콜로 어떤 외부 시스템에든 연결할 수 있게 합니다.

MCP 이전에는 각 AI 도구가 GitHub, Slack, 데이터베이스 등을 연결하기 위해 각자 별도의 플러그인을 개발해야 했습니다. 서비스가 10개면 플러그인도 10개, 도구가 5개면 총 50가지 연동을 각각 만들어야 했습니다. MCP는 이 구조를 "AI 앱 1개 + MCP 서버 N개"로 단순화합니다. 서버 하나만 MCP 규격에 맞게 만들면, MCP를 지원하는 모든 AI 앱이 그 서버를 사용할 수 있습니다.

MCP 서버가 제공하는 세 가지 기본 요소

아키텍처: 호스트·클라이언트·서버

MCP는 명확한 3계층 클라이언트-서버 아키텍처를 따릅니다. 공식 문서 기준으로 각 계층의 역할은 다음과 같습니다.

중요한 점은 호스트가 서버마다 별도의 클라이언트를 생성한다는 것입니다. Claude Code(호스트)가 GitHub MCP 서버와 Supabase MCP 서버를 동시에 쓴다면, 내부적으로 두 개의 클라이언트 객체가 각각 독립적인 연결을 유지합니다.

두 개의 프로토콜 레이어

MCP는 내부적으로 두 레이어로 구성됩니다. 데이터 레이어는 JSON-RPC 2.0 기반 메시지 구조와 의미론을 정의하며, 도구·리소스·프롬프트 같은 핵심 기본 요소와 수명 주기 관리를 포함합니다. 전송 레이어는 클라이언트와 서버 사이의 실제 통신 채널과 인증을 담당합니다. 데이터 레이어가 내부 레이어라면 전송 레이어는 외부 레이어입니다.

전송 방식: stdio vs Streamable HTTP

MCP는 두 가지 표준 전송 방식을 지원합니다. 어느 방식을 써도 메시지 형식은 동일하게 JSON-RPC 2.0을 사용합니다. 로컬 도구 통합에는 stdio, 클라우드 서비스 연동에는 Streamable HTTP를 씁니다.

Claude Code에서 MCP 설정하기

Claude Code는 claude mcp add 명령어 하나로 MCP 서버를 연결합니다. 설정은 세 가지 스코프(local, project, user)로 나뉘며, 원격 HTTP 서버와 로컬 stdio 서버 두 방식 모두 지원합니다.

원격 HTTP 서버 연결

클라우드 기반 서비스는 Streamable HTTP 방식으로 연결합니다. 공식 권장 방식입니다.

$ claude mcp add --transport http notion https://mcp.notion.com/mcp
✓ Added MCP server: notion

$ claude mcp add --transport http github https://api.githubcopilot.com/mcp/
✓ Added MCP server: github

$ claude mcp add --transport http sentry https://mcp.sentry.dev/mcp
✓ Added MCP server: sentry

로컬 stdio 서버 연결

로컬 파일 시스템이나 시스템에 직접 접근해야 하는 서버는 stdio 방식으로 연결합니다. -- 뒤에 실행할 명령어를 적습니다.

$ claude mcp add --transport stdio filesystem -- npx -y @modelcontextprotocol/server-filesystem /home/daniel/projects
✓ Added MCP server: filesystem

$ claude mcp add --transport stdio memory -- npx -y @modelcontextprotocol/server-memory
✓ Added MCP server: memory

$ claude mcp add --transport stdio context7 -- npx -y @upstash/context7-mcp
✓ Added MCP server: context7

환경변수가 필요한 서버 연결

$ claude mcp add --transport stdio \
  --env GITHUB_PERSONAL_ACCESS_TOKEN=ghp_xxxx \
  github-local \
  -- npx -y @modelcontextprotocol/server-github
✓ Added MCP server: github-local

$ claude mcp add --transport http \
  --header "Authorization: Bearer your-api-key" \
  secure-api https://api.example.com/mcp
✓ Added MCP server: secure-api

서버 관리 명령어

설정 스코프: local · project · user

# user 스코프: 모든 프로젝트에서 사용
claude mcp add --transport http --scope user hubspot https://mcp.hubspot.com/anthropic

# project 스코프: .mcp.json에 저장, 팀 공유
claude mcp add --transport http --scope project paypal https://mcp.paypal.com/mcp

# local 스코프 (기본값): 현재 프로젝트에서만
claude mcp add --transport http stripe https://mcp.stripe.com

인기 MCP 서버 목록

2026년 현재 MCP 서버 레지스트리에는 수천 개의 서버가 등록되어 있습니다. 그 중 개발자들이 실제로 많이 사용하는 핵심 서버들을 정리했습니다. 공식 Anthropic MCP 레지스트리에서 Claude Code와 호환되는 최신 서버 목록을 확인할 수 있습니다.

개발 생산성 서버

데이터 & 검색 서버

업무 자동화 서버

직접 MCP 서버 만들기

원하는 MCP 서버가 없거나 사내 내부 시스템에 연결해야 한다면 직접 만들 수 있습니다. MCP는 TypeScript, Python, Java, Kotlin, C# 등 여러 언어의 공식 SDK를 제공합니다. 여기서는 가장 널리 쓰이는 TypeScript SDK 기준으로 최소한의 stdio 서버 예시를 보여드립니다.

프로젝트 초기화

$ mkdir my-mcp-server && cd my-mcp-server
$ npm init -y
$ npm install @modelcontextprotocol/sdk
$ npm install -D typescript @types/node

my-mcp-server/
  src/
    index.ts
  package.json
  tsconfig.json

최소 서버 코드 (TypeScript)

import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
import { z } from 'zod';

// 서버 인스턴스 생성
const server = new McpServer({
  name: 'my-mcp-server',
  version: '1.0.0',
});

// 도구(Tool) 등록: 두 숫자를 더하는 계산기
server.tool(
  'add',
  { a: z.number(), b: z.number() },
  async ({ a, b }) => ({
    content: [{ type: 'text', text: String(a + b) }],
  })
);

// 리소스(Resource) 등록: 간단한 텍스트 데이터 제공
server.resource(
  'greeting',
  'greeting://hello',
  async (uri) => ({
    contents: [{ uri: uri.href, text: '안녕하세요! 이것은 MCP 리소스 예시입니다.' }],
  })
);

// stdio 전송으로 서버 시작
async function main() {
  const transport = new StdioServerTransport();
  await server.connect(transport);
  console.error('MCP 서버 실행 중...'); // stderr에 로그 출력
}

main().catch(console.error);

빌드 및 Claude Code에 연결

$ npx tsc
$ claude mcp add --transport stdio my-server -- node /절대경로/my-mcp-server/dist/index.js
✓ Added MCP server: my-server

보안 주의사항

MCP 서버는 AI 모델에 강력한 능력을 부여하는 만큼, 잘못 설정하면 심각한 보안 위험을 초래합니다. 2026년 현재 연구 결과에서는 도구 오염(Tool Poisoning)과 프롬프트 인젝션이 주요 공격 벡터로 식별되었습니다.

주요 보안 위협

보안 모범 사례

자주 묻는 질문 (FAQ)

MCP는 AI 에이전트가 실제 업무 도구와 연결되는 방식을 근본적으로 바꾸고 있습니다. 성공지식백과에서는 인기 MCP 서버별 심화 설정 가이드와 실전 워크플로우를 계속 업데이트할 예정입니다.