MCP 트랜스포트 완전 가이드

stdio vs HTTP 방식 차이와 실전 선택 기준

by AI개발자
claudecode1 (1).png

stdio와 HTTP 양쪽 트랜스포트의 구조를 이해하고, 각각의 방식으로 MCP 서버를 접속합니다. 또한 MCP 설정 파일(JSON)을 사용한 일괄 관리 방법을 습득합니다.



배경 지식

트랜스포트란 무엇인가

MCP에서의 트랜스포트는 클라이언트(Claude Code)와 서버(툴 프로바이더) 사이에서 메시지를 주고받는 통신 계층입니다. MCP는 3가지 트랜스포트 방식을 제공합니다.

mcp-006.png


stdio 트랜스포트

stdio 트랜스포트는 표준 입출력(stdin / stdout)을 통해 통신하는 방식입니다.

mcp-007.png

특징:

Claude Code가 MCP 서버를 서브 프로세스로 기동합니다

프로세스 간 통신이므로 네트워크가 불필요합니다

서버의 라이프사이클은 Claude Code가 관리합니다

로컬 환경의 툴(파일 조작, 빌드 툴 등)에 최적입니다


장점:

셋업이 간단합니다 (URL이나 포트 설정이 불필요)

네트워크 지연이 없습니다

방화벽 설정이 불필요합니다

프로세스 종료 시 자동 클린업됩니다


제약:

로컬 머신에서만 동작합니다

서버 프로세스의 공유가 불가합니다

서버의 기동·정지가 Claude Code에 의존합니다


HTTP 트랜스포트

HTTP 트랜스포트는 HTTP 통신을 통해 원격(또는 로컬)의 MCP 서버에 접속하는 방식입니다.

mcp-008.png

특징:

독립적으로 가동하는 HTTP 서버에 접속합니다

원격 서버로의 접속이 가능합니다

서버의 기동·관리는 Claude Code와 독립적입니다

OAuth 등의 인증 기구와 조합하기 쉽습니다


장점:

원격 서비스로의 접속이 가능합니다

여러 클라이언트에서 서버를 공유할 수 있습니다

서버의 독립적인 관리·스케일링이 가능합니다

클라우드 서비스와의 친화성이 높습니다


제약:

네트워크 설정이 필요합니다

인증·보안의 고려가 필요합니다

네트워크 지연의 영향을 받습니다


지금 바로 작가의 멤버십 구독자가 되어
멤버십 특별 연재 콘텐츠를 모두 만나 보세요.

brunch membership
AI개발자작가님의 멤버십을 시작해 보세요!

AI Workflow Architect, LLM Engineer, Vibe Engineering, Claude Code, AI 업무 자동화 컨설팅/AI강의

89 구독자

오직 멤버십 구독자만 볼 수 있는,
이 작가의 특별 연재 콘텐츠

  • 최근 30일간 57개의 멤버십 콘텐츠 발행
  • 총 77개의 혜택 콘텐츠
최신 발행글 더보기
이전 08화Claude Code MCP 완전 입문