← 전체 가이드
Claude MCP

MCP 서버 직접 만들어보기

Model Context Protocol 서버를 TypeScript로 만들고 Claude Desktop에 연결하는 최소 예제. 커스텀 도구 하나 추가까지.

읽는 데 12분 · STEP 6개 · 2026. 11. 13.

MCP가 뭔가

Model Context Protocol은 LLM이 외부 도구·데이터와 이야기하는 표준 규약입니다.

1단계: 프로젝트 세팅

mkdir my-mcp && cd my-mcp
npm init -y
npm install @modelcontextprotocol/sdk zod

2단계: 서버 코드 작성

index.ts에 기본 서버를 만듭니다.

3단계: 도구 하나 추가

add 같은 간단한 함수부터.

4단계: Claude Desktop 설정

claude_desktop_config.json에 서버 경로 등록.

5단계: 테스트

Claude Desktop을 재시작하고 도구를 호출해봅니다.

6단계: 배포

npm 패키지로 올리거나, 사내용이면 로컬 경로 그대로.