MCP 금융 데이터 연동 한국 — DART·KRX·ECOS를 AI와 연결하는 방법

한국 금융 데이터(DART 전자공시, KRX 주가, ECOS 경제통계)를 MCP 프로토콜로 Claude AI에 직접 연결하면, 자연어 한 문장으로 상장기업 재무제표 요약·주가 조회·공시 검색을 처리할 수 있습니다. 이 글에서는 현재 검증된 한국 금융 MCP 서버 세 종류를 비교하고, API 키 발급부터 Claude Desktop 연결까지 실제로 동작하는 전체 흐름을 설명합니다. 설정 파일 한 번만 수정하면 반복 조회 작업을 AI가 대신 처리합니다.

왜 한국 금융 데이터 MCP 연동이 필요한가

기존 방식으로 DART 공시를 조회하려면 OpenDART 사이트에 직접 접속하거나, REST API를 파이썬 스크립트로 직접 호출해야 했습니다. 분기보고서 하나를 받아 재무비율을 계산하는 데만도 수십 분이 걸렸습니다.

MCP(Model Context Protocol)는 AI 클라이언트와 외부 데이터 소스 사이에 표준화된 통신 계층을 제공합니다. 금융 MCP 서버를 Claude Desktop에 등록하면 “삼성전자 2024년 연간 영업이익 알려줘”라는 질문만으로 AI가 DART API를 직접 호출해 답변을 돌려줍니다.

사용자 (Claude Desktop)
        │  자연어 질문
        ▼
  Claude AI 엔진
        │  MCP 도구 호출
        ▼
  금융 MCP 서버 (로컬 실행)
        │  REST API 호출 + API 키 인증
        ▼
  한국 금융 API
  ├─ DART (opendart.fss.or.kr) — 전자공시·재무제표
  ├─ KRX (정보데이터시스템) — 주가·시세
  └─ ECOS (한국은행) — 경제통계

이 구조 덕분에 사용자는 API 문서를 외울 필요 없이 Claude와 대화하듯 금융 데이터를 다룰 수 있습니다.

한국 금융 MCP 서버 비교

현재 MCP모아 금융 카테고리에 등록된 주요 서버 세 종류를 아래 표로 정리했습니다.

서버 이름	연동 API	설치 방식	API 키 필요	특징
한국 주식 MCP 서버	DART, KRX	npx	필요 (DART)	주가+공시 통합, 가장 범용
DART MCP 서버	DART(전자공시시스템)	uvx	필요 (DART)	Python 기반, 재무제표 특화
한국 DART MCP	OpenDART (83개 API)	npx	필요 (DART)	83개 API → 15개 도구로 압축

세 서버 모두 OpenDART API 키가 필요합니다. KRX 주가 조회는 Korea Stock MCP가 별도 지원합니다.

준비물

Claude Desktop 최신 버전 (claude.ai/download)
Node.js 18 이상 — npx 방식 서버에 필요
Python 3.10 이상 + uv — uvx 방식(DART MCP) 사용 시 필요
OpenDART API 키 — opendart.fss.or.kr 에서 무료 발급

OpenDART API 키 발급 방법

https://opendart.fss.or.kr 접속
우측 상단 “인증키 신청/관리” 클릭
회원가입 후 로그인
API 키 발급 신청 (즉시 발급, 무료)

발급된 키는 xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx 형태의 문자열입니다. 이 키를 아래 설정 파일에 입력합니다.

Claude Desktop에 금융 MCP 서버 연결하기

Claude Desktop의 MCP 설정 파일 위치는 운영체제별로 다릅니다.

운영체제	설정 파일 경로
macOS	`~/Library/Application Support/Claude/claude_desktop_config.json`
Windows	`%APPDATA%\Claude\claude_desktop_config.json`

방법 1: 한국 주식 MCP 서버 (DART + KRX, npx)

한국 주식 MCP 서버는 DART 공시와 KRX 주가를 동시에 지원하는 범용 서버입니다.

설정 파일을 열어 아래 내용을 추가하세요.

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

저장 후 Claude Desktop을 완전히 종료했다가 다시 실행합니다. 하단 도구 아이콘에 새 서버가 표시되면 연결 완료입니다.

확인 방법: Claude에게 “삼성전자의 최근 분기 재무제표 요약해 줘”라고 입력해 보세요. DART API를 호출해 결과를 반환하면 정상 동작입니다.

방법 2: DART MCP 서버 (uvx, Python 기반)

DART MCP 서버는 Python uv 환경으로 실행합니다. 먼저 저장소를 클론한 뒤 아래와 같이 설정합니다.

# 저장소 클론 (홈 디렉토리 기준)
git clone https://github.com/2geonhyup/dart-mcp ~/Downloads/dart-mcp

Claude Desktop 설정 파일에 추가:

{
  "mcpServers": {
    "dart-mcp": {
      "command": "uv",
      "args": ["--directory", "/Users/사용자명/Downloads/dart-mcp", "run", "dart.py"],
      "env": {
        "DART_API_KEY": "여기에_발급받은_DART_API_키_입력"
      }
    }
  }
}

사용자명 부분을 실제 macOS 계정명으로 교체하세요. Windows라면 C:\Users\사용자명\Downloads\dart-mcp 형태로 수정합니다.

방법 3: 한국 DART MCP (83개 API, npx)

한국 DART MCP는 OpenDART의 83개 API 엔드포인트를 15개 MCP 도구로 정리한 서버입니다. 공시 검색, 재무비율 계산, 대량 보고서 조회 등 고급 분석에 적합합니다.

{
  "mcpServers": {
    "korean-dart-mcp": {
      "command": "npx",
      "args": ["-y", "korean-dart-mcp"],
      "env": {
        "DART_API_KEY": "여기에_발급받은_DART_API_키_입력"
      }
    }
  }
}

세 서버를 동시에 등록해도 충돌하지 않습니다. mcpServers 객체 안에 각각의 키로 나란히 넣으면 됩니다.

실제 활용 예시

서버 연결 후 Claude에게 아래와 같은 방식으로 질문할 수 있습니다.

질문 예시:
- "카카오 2024년 3분기 매출액과 영업이익 알려줘"
- "코스피 시총 상위 5개 기업의 PER 비교해 줘"
- "최근 1개월 내 삼성SDI 공시 목록 보여줘"
- "LG에너지솔루션 부채비율 계산해 줘"

AI가 직접 API를 호출해 데이터를 가져오고, 자연어로 해석까지 해 줍니다. 별도의 코드 작성이나 엑셀 작업 없이 대화만으로 재무 분석이 가능합니다.

흔한 오류와 해결 방법

”API key is invalid” 오류

OpenDART 키를 잘못 입력했거나, 키 발급 후 5~10분 활성화 대기 시간이 필요한 경우입니다. 키를 복사할 때 앞뒤 공백이 포함되지 않았는지 확인하세요.

”command not found: npx” 오류

Node.js가 설치되지 않은 환경입니다. nodejs.org에서 LTS 버전을 설치한 뒤 Claude Desktop을 재시작하세요.

”ModuleNotFoundError” (uvx 방식)

Python uv가 설치되지 않은 경우입니다. 터미널에서 아래 명령을 실행하세요.

curl -LsSf https://astral.sh/uv/install.sh | sh

설치 후 새 터미널 세션을 열고 Claude Desktop을 재시작합니다.

MCP 서버가 도구 목록에 표시되지 않는 경우

설정 파일의 JSON 문법 오류 여부 확인 (쉼표 누락, 따옴표 불일치 등)
Claude Desktop을 완전히 종료 후 재시작 (트레이 아이콘 우클릭 → 종료)
서버 로그 확인: macOS 기준 ~/Library/Logs/Claude/ 디렉토리

자주 묻는 질문

MCP 금융 서버를 쓰려면 API 키가 반드시 필요한가요?

네. DART·KRX 등 한국 금융 공공 API는 모두 인증 키를 요구합니다. OpenDART는 opendart.fss.or.kr에서 무료로 발급받을 수 있으며, 발급 후 즉시 사용 가능합니다.

Claude Desktop 외에 Cursor에서도 금융 MCP 서버를 쓸 수 있나요?

네. Cursor는 Claude Desktop과 동일한 MCP 설정 방식을 지원합니다. 각 서버의 설정 JSON 블록을 Cursor의 MCP 설정 파일에 붙여 넣으면 됩니다.

DART MCP와 한국 주식 MCP 중 어느 것을 먼저 써야 하나요?

목적에 따라 다릅니다. 재무제표·공시 분석이 목적이면 DART 계열 서버를, 실시간 주가·시세 조회가 목적이면 KRX를 지원하는 Korea Stock MCP를 선택하세요. 두 서버를 동시에 설정해도 충돌하지 않습니다.

ECOS(한국은행 경제통계) 연동 MCP는 별도로 있나요?

현재 MCP모아에 등록된 서버 중 DART·KRX 연동 서버가 가장 많이 검증된 상태입니다. ECOS 전용 서버는 별도 가이드를 참고하거나 전체 서버 목록에서 검색하세요.

npx 방식과 uvx 방식의 차이가 무엇인가요?

npx는 Node.js 기반으로 설치 없이 바로 실행합니다. uvx는 Python uv 패키지 매니저 기반으로 Python 환경이 필요하지만 Python 생태계 라이브러리를 활용할 수 있습니다. 서버마다 지원 방식이 다르므로 각 서버 페이지의 설치 명령을 확인하세요.

MCP 금융 서버 사용 중 API 호출 한도 초과 오류가 발생하면 어떻게 하나요?

OpenDART 등 공공 API는 일일 호출 횟수 제한이 있습니다. 오류 메시지에서 ‘rate limit’ 또는 ‘초과’가 보이면 다음 날 재시도하거나, 공공데이터포털에서 호출 한도 상향 신청을 진행하세요.

다음 단계

한국 금융 MCP 서버를 설정했다면 아래 리소스로 활용 범위를 넓혀 보세요.

한국 주식 MCP 서버 상세 페이지 — KRX 주가 조회 도구 목록 확인
DART MCP 서버 상세 페이지 — Python 환경 설정 상세 가이드
한국 DART MCP 상세 페이지 — 83개 OpenDART API 활용법
금융 카테고리 전체 보기 — 추가 금융 MCP 서버 탐색
MCP 서버 전체 목록 — 다른 분야 MCP 서버 검색

새로운 한국 금융 MCP 서버를 발견했다면 가이드 목록을 통해 커뮤니티와 공유해 주세요.