MCP Server란? 구조와 실제 활용 예시

MCP Server는 MCP 규격에 맞춰 AI에게 도구(Tool)·데이터(Resource)·템플릿(Prompt)을 제공하는 프로그램이다. 로컬 컴퓨터에서 실행되는 작은 스크립트일 수도 있고, Notion·Asana 같은 회사가 직접 운영하는 원격 서비스일 수도 있다. 이 글은 MCP Server가 실제로 어떤 형태로 존재하고, Claude Code에 어떻게 연결하는지를 공식 문서 기준으로 정리한다.

MCP Server의 두 가지 실행 방식

MCP 서버는 연결 방식(전송 계층, transport)에 따라 크게 두 종류로 나뉜다.

방식	실행 위치	대표 예시
원격 서버 (HTTP)	서비스 제공사의 서버	Notion, Asana 등이 공식 제공하는 MCP 서버
로컬 서버 (stdio)	내 컴퓨터에서 프로세스로 실행	파일 시스템 접근, 커스텀 스크립트

과거에는 SSE(Server-Sent Events) 방식도 쓰였지만 공식 문서는 현재 이를 지원 중단(deprecated) 대상으로 안내하며, 가능하면 HTTP 방식을 쓰도록 권장한다. 실시간으로 서버가 이벤트를 먼저 보내야 하는 특수한 경우에는 WebSocket 방식도 사용된다.

실제로 서버를 연결하는 방법

Claude Code에서는 claude mcp add 명령으로 서버를 등록한다. 아래는 공식 문서에 나온 예시를 그대로 인용한 것이다.

원격 HTTP 서버 연결 (예: Notion):

claude mcp add --transport http notion https://mcp.notion.com/mcp

인증 토큰이 필요한 원격 서버:

claude mcp add --transport http secure-api https://api.example.com/mcp \
  --header "Authorization: Bearer your-token"

로컬 stdio 서버 연결 (예: Airtable, 환경변수로 API 키 전달):

claude mcp add --env AIRTABLE_API_KEY=YOUR_KEY --transport stdio airtable \
  -- npx -y airtable-mcp-server

-- 뒤에 오는 부분은 실제로 서버를 실행하는 명령어이며, 그 앞부분은 Claude Code 자체의 옵션(--transport, --env 등)이다. 이 둘을 구분하지 않으면 서버 실행에 필요한 옵션이 Claude Code의 옵션으로 잘못 해석될 수 있다.

연결 상태 확인하기

서버를 추가한 뒤에는 다음 명령으로 상태를 확인할 수 있다.

# 등록된 서버 전체 목록과 상태 확인
claude mcp list

# 특정 서버의 상세 정보 확인
claude mcp get notion

# 서버 제거
claude mcp remove notion

claude mcp list는 각 서버 옆에 연결 상태를 함께 보여준다. “연결됨”, “인증 필요”, “연결 실패” 같은 상태를 통해 서버가 정상적으로 작동하는지 바로 확인할 수 있다.

어디서 MCP 서버를 찾을 수 있나

• 이미 만들어진 서버를 찾는 경우: MCP 공식 저장소의 레퍼런스 서버 목록이나, 각 서비스(Notion, Asana, Sentry 등)가 직접 제공하는 공식 MCP 서버 문서를 확인한다.
• 원하는 서버가 없는 경우: MCP 공식 개발 가이드를 참고해 직접 만들거나, Claude Code에 서버 스캐폴딩을 도와주는 공식 플러그인을 활용해 대화형으로 서버 뼈대를 생성할 수 있다.

한계와 주의할 점

• 보안이 가장 중요하다. 공식 문서는 “연결하기 전에 각 서버를 신뢰할 수 있는지 반드시 확인하라”고 명시한다. 외부 콘텐츠를 가져오는 서버는 프롬프트 인젝션 공격 경로가 될 수 있다.
• 다른 AI 도구(Claude Desktop, Cursor 등)를 위해 작성된 서버 설정도 URL, 실행 명령, JSON 설정 중 하나의 형태만 파악하면 Claude Code용 명령으로 손쉽게 옮길 수 있다.
• 이 글에 소개한 명령어와 옵션은 2026년 8월 22일 기준 Claude Code 공식 문서를 인용한 것이며, 실제 실행은 검증하지 않았다. 버전에 따라 옵션이 달라질 수 있으므로 실제 사용 전 공식 문서를 확인해야 한다.

결론

MCP Server는 AI가 실제로 “무엇에 접근할 수 있는가”를 결정하는 실체다. 개념으로서의 MCP가 규격이라면, MCP Server는 그 규격을 구현해 실제 데이터와 기능을 내주는 프로그램이다. Claude Code 기준으로는 claude mcp add 한 줄로 대부분의 서버를 연결할 수 있을 만큼 진입 장벽이 낮지만, 어떤 서버를 신뢰하고 연결할지는 사용자가 직접 판단해야 하는 영역으로 남아 있다.