🚀 [실전] 내 컴퓨터의 데이터를 AI의 팔다리로! MCP 서버 구축 가이드

 

슈퍼휴먼 슈퍼워크:1인이 100인의 임팩트를 만드는 AI 에이전트 시대가 온다 - 블로그/홈페이지 |

"이 포스팅은 쿠팡 파트너스 활동의 일환으로, 이에 따른 일정액의 수수료를 제공받습니다."

 

인공지능과 대화하다 보면 가끔 이런 답답함이 느껴집니다.
"내 컴퓨터에 있는 최신 재고 현황이나 엑셀 파일 좀 직접 보고 대답해주면 안 되나?"
앤스로픽(Anthropic)이 발표한 MCP(Model Context Protocol)는 바로 이 가려운 곳을 긁어주는 기술입니다.

오늘은 코딩 초보자도 따라 할 수 있도록, 내 사업장 정보를 클로드(Claude)에게 학습시키는 MCP 서버 구축 과정을 완벽히 정리해 드립니다.

---

1. 왜 MCP 서버를 만들어야 할까?

기존의 AI는 학습된 데이터로만 말합니다. 하지만 MCP 서버를 연결하면:

• 실시간성: "지금 A 상품 재고 몇 개야?"라는 질문에 정확히 답합니다.
• 보안성: 데이터를 AI에게 넘기지 않고, 필요할 때만 내 서버에서 '조회'해 갑니다.
• 자동화: 단순 답변을 넘어, AI가 직접 명령을 내려 시스템을 조작할 수 있습니다.

---

2. 준비물: 빌딩을 위한 도구들

구축을 시작하기 전, 아래 도구들이 설치되어 있어야 합니다.

1. Node.js: 서버를 실행하는 엔진입니다.
2. Claude Desktop 앱: 웹사이트가 아닌, PC에 설치된 클로드 앱이 필요합니다.
3. Visual Studio Code (VS Code) 또는 notepad++ (추천) : 코드를 수정할 편집기입니다.   

3. 단계별 구축 프로세스

STEP 1: 프로젝트 폴더 생성 및 SDK 설치

터미널(CMD)을 열고 서버를 담을 주머니를 만듭니다.

Bash

 

mkdir my-shop-mcp && cd my-shop-mcp
npm init -y
npm install @modelcontextprotocol/sdk
npm install -g tsx

Tip: 여기서 tsx는 TypeScript 파일을 별도의 복잡한 변환 과정 없이 바로 실행해주는 고마운 도구입니다.

STEP 2: 서버 로직 작성 (index.ts)

프로젝트 폴더에 index.ts 파일을 만들고 아래의 핵심 로직을 넣습니다. 이 코드는 AI가 "상품 정보 좀 알려줘"라고 할 때 DB에서 정보를 찾아주는 '통역사' 역할을 합니다.

TypeScript

 

import { Server } from "@modelcontextprotocol/sdk/server/index.js";
import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
// ... 서버 이름 정의 및 도구(Tools) 설정 로직 ...

STEP 3: 클로드 데스크톱과 연결하기 (config.json)

가장 중요한 단계입니다. 클로드가 켜질 때 내 서버를 인식하도록 '체크리스트'에 등록해야 합니다.

• 파일 경로: %APPDATA%\Claude\claude_desktop_config.json
• 설정 내용:

JSON

 

{
  "mcpServers": {
    "my-shop": {
      "command": "npx",
      "args": ["tsx", "D:/my-shop-mcp/index.ts"]
    }
  }
}

주의! 윈도우 경로를 적을 때는 \ 대신 /를 사용해야 오류가 나지 않습니다.

---

4. 시행착오 탈출기 (Troubleshooting)

빌딩 과정에서 흔히 발생하는 에러와 해결책입니다.

• "폴더가 없어요!": 클로드 데스크톱 앱을 설치하고 최소 한 번은 실행해야 %APPDATA%\Claude 폴더가 생성됩니다.
• "아이콘이 안 보여요": 설정을 바꾼 뒤에는 반드시 클로드 앱을 [Quit]으로 완전히 종료했다가 다시 켜야 합니다.
• "TSC 명령어를 찾을 수 없대요": 복잡하게 컴파일(변환)하지 마세요. 위 설정처럼 npx tsx를 사용하면 .ts 파일을 직접 실행할 수 있어 훨씬 간편합니다.

---

5. 마치며: 연결된 지능의 시대

이제 클로드 채팅창 오른쪽 하단에 플러그 아이콘이 생겼다면 성공입니다!

또는  클로드에게 직접 물어보세요.

"지금 연결된 MCP 도구 있어? get_product_info 사용 가능한지 확인해줘."
이제 여러분의 AI는 단순히 웹에 떠도는 정보를 읊는 존재가 아닙니다. 여러분의 사업장 데이터베이스를 직접 들여다보고 판단하는 '수석 비서'로 진화한 것입니다. 코딩을 넘어 비즈니스를 '빌딩'하는 즐거움을 느껴보시기 바랍니다.

---

함께 읽으면 좋은 글:

• [Google A2A vs Anthropic MCP: 차세대 AI 표준 대결]
• [n8n과 MCP를 연동하여 완전 자동화 구축하기]

---

이 포스팅이 도움이 되셨다면 좋아요와 댓글 부탁드립니다!