Korea Stock MCP는 실시간 시세도 제공하나요?

Korea Stock MCP는 KRX와 DART 공식 API를 기반으로 합니다. 장 중 실시간 호가는 별도의 실시간 API 연동이 필요할 수 있으며, 공식 문서(https://github.com/jjlabsio/korea-stock-mcp)에서 지원 기능을 확인하세요.

DART MCP와 Korea Stock MCP를 함께 사용할 수 있나요?

네, Claude Desktop의 설정 파일에 두 MCP 서버를 모두 등록하면 동시에 사용할 수 있습니다. DART로 재무·공시 데이터를 가져오고, Korea Stock MCP로 시세 데이터를 조합하면 더욱 풍부한 분석이 가능합니다.

키움증권 자동매매를 위한 Claude MCP 데이터 연동 가이드

Q: 키움증권 Open API는 개인 투자자도 사용할 수 있나요?

네, 키움증권 계좌를 보유한 개인 투자자라면 누구나 Open API 사용 신청이 가능합니다. 신청 후 심사를 거쳐 승인되면 모의투자와 실투자 환경 모두 이용할 수 있습니다.

Q: MCP를 통한 자동매매는 실제 주문을 자동으로 실행하나요?

이 가이드에서 다루는 Korea Stock MCP 서버는 DART·KRX 데이터 조회에 특화되어 있습니다. 실제 주문 실행은 키움증권 Open API의 별도 주문 기능과 연동이 필요하며, 반드시 모의투자로 충분히 검증한 뒤 실투자에 적용하세요.

Q: 키움증권 Open API는 Windows 전용인가요?

키움증권의 기존 OCX 기반 API는 Windows 전용입니다. 다만 REST API 방식이나 MCP 서버를 통한 데이터 수집은 macOS·Linux에서도 가능합니다. 실제 주문 기능이 필요하면 Windows 환경을 사용하거나 Wine 등의 호환 레이어를 검토하세요.

Q: 자동매매 중 손실이 발생하면 누가 책임지나요?

AI와 MCP를 활용한 매매 판단의 최종 책임은 투자자 본인에게 있습니다. Claude와 MCP는 데이터 분석 도구이며, 실제 매매 결정은 투자자가 직접 내려야 합니다. 반드시 모의투자로 전략을 검증한 후 소액으로 실거래를 시작하세요.

키움증권으로 매매하는 투자자가 코드를 직접 짜지 않고도 Claude에게 “최근 분기 영업이익이 늘어난 코스피 종목을 찾아줘”라고 묻는 환경을 만들 수 있습니다. 핵심은 MCP(Model Context Protocol)입니다. Korea Stock MCP 서버와 DART MCP 서버를 Claude Desktop에 연결하면, Claude가 직접 KRX 시세와 DART 공시·재무 데이터를 조회한 뒤 그 위에 분석과 전략 제안을 얹습니다.

다만 시작 전에 한 가지를 분명히 해 둡니다. 이 가이드가 구축하는 것은 데이터 조회·분석 환경이며, 주문을 자동으로 체결하는 시스템이 아닙니다. 여기서 다루는 MCP 서버들은 KRX·DART 공개 API 기반의 조회 도구이고, 실제 주문 실행은 키움증권 Open API의 별도 주문 기능과 직접 연동해야 합니다. Claude의 제안은 어디까지나 사람의 최종 판단을 돕는 보조 입력입니다.

이 조합이 해결하는 문제

기존 자동매매는 파이썬 코드를 직접 작성하고, 조건을 바꿀 때마다 코드를 수정해야 했습니다. 시세는 KRX에서, 공시·재무는 DART에서 따로 긁어와 합쳐야 했고, 대용량 사업보고서 XML을 파싱하는 일은 그 자체로 별도 작업이었습니다.

MCP 방식에서는 이 수집·파싱 단계를 Claude가 도구 호출로 대신합니다. 사람은 전략을 자연어로 기술하고, Claude는 필요한 데이터를 골라 조회한 뒤 비교·요약합니다. 코드 수정 없이 질문만 바꾸면 조건이 바뀌는 셈입니다.

[데이터 흐름]

Claude Desktop
    │  MCP 프로토콜 (JSON-RPC, stdio)
    ▼
Korea Stock MCP ──── KRX Open API   (KOSPI·KOSDAQ·KONEX 일별 시세·종목 정보)
    │            └── DART OpenAPI    (공시·XBRL 재무제표·사업보고서)
    │
DART MCP / Korean DART MCP ──── DART OpenAPI (공시·재무 심화)
    │
    ▼
조회 결과 → Claude 분석·전략 제안 → 사람의 매매 판단

서버별 역할 한눈에 보기

세 서버는 겹치면서도 강점이 다릅니다. 목적에 맞게 고르거나 조합하세요.

서버	데이터 출처	설치 방식	필요한 API 키	강점
Korea Stock MCP	KRX + DART	npx (Node.js)	`DART_API_KEY`, `KRX_API_KEY`	KRX 시세와 DART 공시를 한 서버에서 처리
DART MCP	DART	uvx (Python)	`DART_API_KEY`	재무제표·DCF 등 공시 심화 분석
Korean DART MCP	DART	npx (Node.js)	`DART_API_KEY`	OpenDART 83개 API를 15개 도구로 압축, HWP·PDF 첨부 변환

Korea Stock MCP는 KRX 시세까지 다루므로 KRX_API_KEY가 추가로 필요합니다. DART 키만 등록하면 공시 조회는 되어도 시세 조회에서 막힐 수 있으니 주의하세요.

준비물

항목	필요 여부	비고
키움증권 계좌	필수	Open API 신청 기준
Node.js 18+	필수	npx 실행용 (Korea Stock MCP·Korean DART MCP)
Python 3.10+ 및 uv	DART MCP 사용 시	uv 실행용
Claude Desktop	필수	MCP 클라이언트
DART API 키	필수	opendart.fss.or.kr 발급 (무료)
KRX Open API 키	Korea Stock MCP 시세 사용 시	KRX 시세 조회용

1단계. 키움증권 Open API 신청

키움증권 홈페이지에서 Open API 사용 신청을 진행합니다. 심사에는 보통 1~3 영업일이 소요됩니다. 승인 후에는 모의투자 환경을 먼저 활성화해 실제 자금 손실 없이 전략을 테스트하세요.

키움증권의 OCX 기반 API는 Windows 전용입니다. 다만 이 가이드의 MCP 서버는 시세·공시 데이터를 KRX·DART에서 직접 가져오므로 macOS·Linux에서도 동작합니다. OCX 기반 주문 기능까지 쓰려면 Windows 환경이 필요합니다.

2단계. DART API 키 발급

세 서버 모두 DART API 키가 필요합니다.

https://opendart.fss.or.kr 에 접속해 회원가입
마이페이지 → API 신청 → Open API 키 발급
발급된 키를 안전한 곳에 메모해 두세요 (설정 파일에 평문으로 들어가므로 외부 공유 금지)

Korea Stock MCP로 KRX 시세까지 조회하려면 KRX Open API 키도 별도로 준비합니다. 시세가 필요 없고 공시·재무만 본다면 DART 키만으로도 시작할 수 있습니다.

3단계. Korea Stock MCP 서버 설치

Korea Stock MCP는 DART와 KRX 공식 API를 기반으로 한국 주식을 분석하게 해주는 TypeScript 서버입니다. Node.js 18 이상이 있으면 npx로 바로 실행됩니다.

npx -y korea-stock-mcp@latest

정상이라면 터미널에 서버 시작 메시지가 출력됩니다. 한 번 실행해 동작을 확인한 뒤 Claude Desktop 설정으로 넘어갑니다. (실제 사용 시에는 Claude Desktop이 이 명령을 대신 실행하므로 여기서는 동작 확인용으로만 띄워 보면 됩니다.)

4단계. DART MCP 서버 설치 (선택, 권장)

재무제표·공시를 더 깊게 분석하려면 DART 전용 서버를 추가합니다. 둘 중 환경에 맞는 하나를 고르세요.

DART MCP (uvx 방식, Python):

# uv가 없으면 먼저 설치
curl -LsSf https://astral.sh/uv/install.sh | sh

# 저장소를 ~/Downloads에 클론 후 실행
git clone https://github.com/2geonhyup/dart-mcp ~/Downloads/dart-mcp
uv --directory ~/Downloads/dart-mcp run dart.py

Korean DART MCP (npx 방식, 더 간단):

npx -y korean-dart-mcp

Korean DART MCP는 OpenDART 83개 API를 15개의 MCP 도구로 압축해 Claude가 더 쉽게 호출할 수 있고, HWP·PDF·DOCX 첨부를 마크다운으로 변환하는 기능도 포함합니다. 두 서버 모두 DART_API_KEY가 필요합니다.

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

Claude Desktop의 MCP 설정 파일을 열어 서버를 등록합니다.

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json

아래는 Korea Stock MCP와 Korean DART MCP를 함께 등록하는 예시입니다. Korea Stock MCP에는 DART와 KRX 두 개의 키가 들어간다는 점에 유의하세요.

{
  "mcpServers": {
    "korea-stock": {
      "command": "npx",
      "args": ["-y", "korea-stock-mcp@latest"],
      "env": {
        "DART_API_KEY": "여기에_DART_API_키_입력",
        "KRX_API_KEY": "여기에_KRX_API_키_입력"
      }
    },
    "korean-dart": {
      "command": "npx",
      "args": ["-y", "korean-dart-mcp"],
      "env": {
        "DART_API_KEY": "여기에_DART_API_키_입력"
      }
    }
  }
}

uvx 방식의 DART MCP를 쓴다면 위 korean-dart 항목 대신 아래를 넣습니다. {username} 자리에는 본인 macOS 사용자명을 채워 클론 경로와 일치시키세요.

    "dart-mcp": {
      "command": "uv",
      "args": ["--directory", "/Users/{username}/Downloads/dart-mcp", "run", "dart.py"],
      "env": {
        "DART_API_KEY": "여기에_DART_API_키_입력"
      }
    }

설정 파일 저장 후 Claude Desktop을 완전히 종료했다가 재시작합니다. 좌측 하단에 MCP 아이콘이 표시되면 연결 성공입니다.

6단계. Claude에서 데이터 조회 검증

Claude Desktop을 열고 MCP 서버가 연결됐는지 확인한 뒤, 다음 프롬프트로 도구 호출이 실제로 데이터를 가져오는지 점검합니다.

삼성전자(005930)의 최근 분기 매출·영업이익 추이를 DART 공시 기준으로 정리해 줘.
코스피200 편입 종목 중 최근 52주 신고가를 갱신한 종목 목록을 가져와.
최근 공시에서 자사주 매입을 발표한 코스닥 종목을 찾아줘.

Claude가 MCP 도구를 호출해 실제 수치를 반환하면, 그 데이터 위에 비교·스크리닝·전략 제안을 얹는 단계로 넘어갑니다. 도구 호출 없이 일반 지식으로만 답한다면 연결이나 키 설정을 다시 점검하세요.

흔한 오류와 해결법

오류 / 증상	원인	해결 방법
`MCP server not found`	설정 파일 경로 오류 또는 JSON 문법 오류	파일을 JSON 검증기로 확인 후 재시작
`DART API key invalid`	DART 키 미입력 또는 오타	opendart.fss.or.kr에서 키 재확인
공시는 되는데 KRX 시세 조회가 실패	`KRX_API_KEY` 누락	Korea Stock MCP env에 KRX 키 추가 후 재시작
`npx: command not found`	Node.js 미설치	Node.js 18 이상 설치 후 재시도
`uv: command not found`	uv 미설치	curl 명령으로 uv 설치 후 재시도
MCP 아이콘이 나타나지 않음	Claude Desktop 버전이 낮음	Claude Desktop 최신 버전으로 업데이트

JSON 디버깅 팁: 마지막 항목 뒤에 쉼표(trailing comma)를 붙이면 파싱 오류가 납니다. 편집 후 반드시 JSON 검증기(jsonlint.com 등)로 확인하세요.

매매 판단에 쓰기 전 반드시 지킬 원칙

MCP로 연결된 Claude는 데이터를 모아 분석하고 전략을 제안하는 보조 도구입니다. 주문은 사람이 직접 판단해 실행하며, 다음을 지키세요.

모의투자 우선: 새 전략은 키움증권 모의투자 환경에서 충분히 검증한 뒤 소액으로 실거래를 시작하세요.
포지션 크기 관리: AI 제안이라도 단일 종목에 자산이 과도하게 쏠리지 않도록 비중을 통제하세요.
데이터 지연 인식: KRX·DART API 데이터는 실시간이 아닐 수 있습니다. 장중 실시간 호가가 필요하면 별도의 실시간 API 연동이 필요하며, 시세에 민감한 단기 트레이딩에는 한계가 있습니다. 지원 범위는 Korea Stock MCP 저장소에서 확인하세요.
키 보안: API 키는 설정 파일에 평문으로 저장됩니다. 파일을 외부에 공유하거나 저장소에 커밋하지 마세요.
투자 책임: 최종 매매 결정과 그 결과의 책임은 투자자 본인에게 있습니다. Claude와 MCP 서버는 손실에 대한 책임이 없습니다.

자주 묻는 질문

키움증권 Open API는 개인 투자자도 사용할 수 있나요?

네. 키움증권 계좌를 보유한 개인 투자자라면 누구나 Open API 사용 신청이 가능합니다. 신청 후 심사를 거쳐 승인되면 모의투자와 실투자 환경 모두 이용할 수 있습니다.

MCP를 통한 자동매매는 실제 주문을 자동으로 실행하나요?

아니요. 이 가이드의 Korea Stock MCP·DART MCP는 KRX·DART 데이터 조회에 특화된 서버입니다. 실제 주문 실행은 키움증권 Open API의 별도 주문 기능과 직접 연동해야 하며, 반드시 모의투자로 충분히 검증한 뒤 적용하세요.

Korea Stock MCP에는 왜 키가 두 개 필요한가요?

이 서버는 DART 공시와 KRX 시세를 모두 다루기 때문입니다. 공시·재무는 DART_API_KEY로, KOSPI·KOSDAQ·KONEX 시세는 KRX_API_KEY로 조회합니다. 시세 기능을 쓰지 않는다면 DART 키만으로도 공시 분석은 가능합니다.

키움증권 Open API는 Windows 전용인가요?

기존 OCX 기반 API는 Windows 전용입니다. 다만 MCP 서버를 통한 KRX·DART 데이터 수집은 macOS·Linux에서도 가능합니다. OCX 기반 주문 기능이 필요하면 Windows 환경을 사용하세요.

DART MCP와 Korea Stock MCP를 함께 쓸 수 있나요?

네. Claude Desktop 설정 파일에 두 서버를 모두 등록하면 동시에 사용할 수 있습니다. DART MCP로 재무·공시를 깊게 파고, Korea Stock MCP로 시세를 더하면 분석 범위가 넓어집니다.

자동매매 중 손실이 발생하면 누가 책임지나요?

최종 책임은 투자자 본인에게 있습니다. Claude와 MCP는 데이터 분석 도구이며, 매매 결정은 투자자가 직접 내려야 합니다. 모의투자로 전략을 검증한 후 소액으로 실거래를 시작하세요.

다음 단계

Korea Stock MCP 서버에서 제공하는 전체 도구 목록을 확인하고 시세·공시 조회 범위를 넓혀 보세요.
DART MCP 서버로 분기 실적 발표 시즌에 맞춘 이벤트 드리븐 분석을 시도해 보세요.
Korean DART MCP의 15개 도구로 공시 분석을 자동화하면 첨부 문서까지 빠르게 훑을 수 있습니다.
금융 카테고리에서 다른 한국 금융 MCP 서버를 둘러보고, 필요한 서버가 없다면 직접 등록해 기여해 보세요.
더 많은 활용법은 가이드 목록에서 확인하세요.