수급 데이터 MCP로 투자자별 매매 현황을 Claude에서 분석하는 방법

핵심 요약 (TL;DR)

외국인·기관·개인 투자자별 수급 데이터를 Claude AI에서 바로 분석하려면 Korea Stock MCP 서버를 설치하고 DART API 키를 연결하면 됩니다. 설치는 npx -y korea-stock-mcp@latest 한 줄이고, Claude Desktop 설정 파일에 서버 블록을 추가하면 자연어로 수급 현황을 조회할 수 있습니다. pykrx 기반의 비공식 방식 대신 KRX·DART 공식 API를 쓰기 때문에 데이터 안정성이 높습니다.

---

왜 수급 데이터 MCP가 필요한가

주식 투자에서 수급은 주가 방향을 가늠하는 핵심 지표입니다. 외국인이 며칠째 순매수하는 종목, 기관이 집중 매도하는 섹터, 개인이 역추세 매수하는 패턴은 모두 중요한 시그널입니다. 문제는 이 데이터를 보려면 HTS를 열거나 KRX 사이트를 직접 방문해야 한다는 번거로움이 있었습니다.

MCP(Model Context Protocol)를 활용하면 이 과정이 크게 단순해집니다. Claude에게 “삼성전자 최근 10거래일 외국인 순매수 추이 분석해줘”라고 입력하면, MCP 서버가 KRX 또는 DART 공식 API를 호출하고 결과를 Claude가 바로 해석합니다. 스프레드시트를 만들거나 파이썬 코드를 짤 필요 없이 대화 한 번으로 수급 분석이 가능합니다.

데이터 흐름 구조

[Claude Desktop / Claude Code]
        |
        | MCP 프로토콜 (JSON-RPC)
        v
[Korea Stock MCP 서버]
        |
        +---> KRX 공식 API  (수급·시세 데이터)
        |
        +---> DART 공식 API (공시·재무 데이터)

---

준비물

항목	내용
Node.js	v18 이상 (npx 사용)
Claude Desktop	최신 버전 (MCP 지원)
DART API 키	opendart.fss.or.kr 무료 발급
인터넷 연결	KRX·DART 공식 API 호출 필요

참고: Claude Code(터미널)에서도 동일한 방법으로 설정할 수 있습니다.

---

단계별 설치 및 설정

1단계. DART API 키 발급

opendart.fss.or.kr에 접속해 개발자 회원가입을 합니다. 이메일 인증 후 API 인증키 발급 메뉴에서 키를 생성하면 됩니다. 무료이며 하루 API 호출 횟수 제한이 있으니 대량 자동화보다는 분석 목적으로 사용하는 것이 적합합니다.

2단계. Korea Stock MCP 서버 설치 확인

별도 전역 설치 없이 npx로 실행할 수 있습니다. 터미널에서 아래 명령을 입력해 서버가 정상 동작하는지 확인하세요.

npx -y korea-stock-mcp@latest --help

오류 없이 도움말이 출력되면 준비 완료입니다.

3단계. Claude Desktop 설정 파일 수정

Claude Desktop의 MCP 설정 파일은 운영체제별로 경로가 다릅니다.

OS	설정 파일 경로
macOS	~/Library/Application Support/Claude/claude_desktop_config.json
Windows	%APPDATA%\Claude\claude_desktop_config.json

파일을 텍스트 편집기로 열어 아래 블록을 추가합니다. 파일이 없다면 새로 만드세요.

{
  "mcpServers": {
    "korea-stock-mcp": {
      "command": "npx",
      "args": ["-y", "korea-stock-mcp@latest"],
      "env": {
        "DART_API_KEY": "여기에_발급받은_API_키_입력"
      }
    }
  }
}

이미 다른 MCP 서버가 등록돼 있다면 mcpServers 객체 안에 korea-stock-mcp 블록만 추가하면 됩니다.

4단계. Claude Desktop 재시작 및 연결 확인

설정을 저장한 뒤 Claude Desktop을 완전히 종료하고 다시 실행합니다. 새 대화창을 열어 입력창 아래 MCP 도구 아이콘이 나타나는지 확인하세요. 도구 목록에 Korea Stock MCP 관련 항목이 보이면 연결 성공입니다.

5단계. 투자자별 수급 데이터 쿼리

이제 Claude에게 자연어로 요청할 수 있습니다. 아래는 실전 쿼리 예시입니다.

예시 1: 특정 종목 투자자별 순매수

“삼성전자(005930) 최근 5거래일 외국인·기관·개인 순매수 수량과 금액을 표로 정리해줘.”

예시 2: 섹터별 수급 흐름

“반도체 대형주 3개의 이번 주 기관 순매수 합산해줘.”

예시 3: 수급과 주가 연계 분석

“카카오 최근 20거래일 외국인 수급 추이와 주가 등락을 비교 분석해줘.”

Claude가 MCP 도구를 호출해 데이터를 가져온 뒤 분석 결과를 한국어로 설명해 줍니다.

---

흔한 오류와 해결 방법

”MCP 서버에 연결할 수 없습니다” 오류

• Node.js 버전을 확인하세요. node -v가 v18 미만이면 업그레이드가 필요합니다.
• claude_desktop_config.json 파일의 JSON 문법이 올바른지 확인하세요. 쉼표나 괄호 오류가 가장 흔합니다.
• Claude Desktop을 완전히 종료(트레이 아이콘까지)한 뒤 재시작하세요.

”API 키 인증 실패” 오류

• DART API 키를 정확히 복사했는지 확인하세요. 앞뒤 공백이 포함되면 인증이 실패합니다.
• API 키가 활성화되려면 발급 후 수 분이 걸릴 수 있습니다.
• opendart.fss.or.kr에 로그인해 키 상태가 정상인지 확인하세요.

데이터가 비어있거나 조회 안 됨

• KRX 공식 데이터는 거래일 기준으로만 제공됩니다. 주말·공휴일 날짜를 조회하면 빈 결과가 반환될 수 있습니다.
• 종목 코드(6자리 숫자)를 정확히 입력했는지 확인하세요. 예: 삼성전자 = 005930.

---

pykrx 대비 MCP 서버 방식의 장단점

구분	pykrx (비공식)	Korea Stock MCP (공식 API)
API 키	불필요	DART 키 필요
안정성	KRX 웹 변경 시 중단 위험	공식 API로 안정적
Claude 연동	별도 코드 작성 필요	MCP로 바로 연결
데이터 범위	시세·수급	시세·수급·공시·재무
추천 대상	파이썬 개발자	투자자·비개발자

---

수급 분석을 더 풍부하게: DART MCP 함께 쓰기

수급 데이터만으로는 “왜 외국인이 매수하는가”를 설명하기 어렵습니다. **DART MCP 서버**나 **한국 DART MCP**를 함께 설정하면 같은 Claude 세션 안에서 재무제표·사업보고서·공시 내용을 동시에 불러올 수 있습니다.

예를 들어 “삼성전자 외국인 수급이 3주 연속 플러스인데, 최근 실적 공시와 연관성을 분석해줘”처럼 질문하면 Claude가 두 MCP 서버를 동시에 활용해 복합 분석을 수행합니다.

DART MCP 서버 설치 예시는 아래와 같습니다.

uv --directory ~/Downloads/dart-mcp run dart.py

또는 Korean DART MCP를 선호한다면 다음과 같이 실행할 수 있습니다.

npx -y korean-dart-mcp

설정 파일에 두 서버를 모두 추가하는 방법은 **금융 카테고리 가이드**에서 확인할 수 있습니다.

---

자주 묻는 질문

수급 데이터 MCP를 쓰면 실시간 데이터를 볼 수 있나요?

KRX 공식 API는 장 마감 후 확정 데이터를 제공합니다. 실시간(틱) 데이터는 한국거래소 유료 서비스를 별도로 사용해야 하며, 무료 API 기반 MCP 서버는 당일 마감 후 또는 전일 기준 데이터를 조회합니다.

pykrx와 KRX 공식 API의 차이가 무엇인가요?

pykrx는 KRX 웹사이트에서 데이터를 파싱하는 비공식 파이썬 라이브러리입니다. 공식 API 키 없이 사용할 수 있지만 KRX 정책 변경 시 동작이 멈출 수 있습니다. Korea Stock MCP는 공식 KRX·DART API를 사용해 더 안정적입니다.

외국인 순매수와 기관 순매수를 동시에 조회할 수 있나요?

네. Korea Stock MCP의 투자자별 매매 도구는 한 번의 쿼리로 외국인·기관·개인의 순매수 금액과 수량을 함께 반환합니다. Claude에게 “삼성전자 최근 5거래일 투자자별 순매수 알려줘”처럼 자연어로 요청하면 됩니다.

API 키를 어디에 보관해야 하나요?

Claude Desktop 설정 파일(claude_desktop_config.json)의 env 블록에 환경변수로 입력합니다. 해당 파일은 로컬 PC에만 저장되며 외부로 전송되지 않습니다. GitHub 등 공개 저장소에는 절대 올리지 마세요.

Claude Code에서도 수급 MCP를 쓸 수 있나요?

네. Claude Code의 MCP 설정(~/.claude/mcp.json 또는 프로젝트별 .mcp.json)에 동일한 서버 블록을 추가하면 터미널 환경에서도 수급 데이터를 조회할 수 있습니다.

DART MCP와 Korea Stock MCP를 함께 사용해도 되나요?

됩니다. 두 서버를 동시에 설정하면 수급 데이터(Korea Stock MCP)와 재무제표·공시 정보(DART MCP)를 Claude 한 세션 안에서 함께 분석할 수 있어 훨씬 풍부한 투자 인사이트를 얻을 수 있습니다.

---

다음 단계

수급 MCP 설정이 완료됐다면 아래 서버들도 함께 살펴보세요.

• 한국 주식 MCP 서버 — DART·KRX 공식 API 기반 통합 주식 분석
• DART MCP 서버 — 재무제표·전자공시 Claude 연동
• 한국 DART MCP — OpenDART 83개 API를 15개 도구로 압축

더 많은 금융 데이터 MCP 서버는 **금융 카테고리**에서, 전체 서버 목록은 **서버 디렉토리**에서 확인하실 수 있습니다.