M MCP모아
가이드

공시 데이터를 Claude로 분석하는 법 — MCP로 DART 연동하기

DART 전자공시 데이터를 Claude AI와 연결하는 MCP 서버 3종을 비교하고, API 키 발급부터 설치·실행까지 단계별로 안내합니다. 사업보고서·재무제표를 AI로 즉시 분석하세요.

DART 전자공시 데이터를 MCP 서버를 통해 Claude AI로 분석하는 워크플로 개요 이미지

DART 전자공시 데이터를 Claude AI에 직접 연결하면, 사업보고서·반기보고서·감사보고서를 대화 형식으로 즉시 분석할 수 있습니다. MCP(Model Context Protocol) 서버를 통해 Claude가 OpenDART API를 직접 호출하기 때문에, 공시 PDF를 직접 내려받아 복사·붙여넣기할 필요가 없습니다. 이 글에서는 현재 사용 가능한 DART MCP 서버 3종의 특징을 비교하고, API 키 발급부터 Claude 연결까지 전 과정을 안내합니다.

왜 DART 공시를 Claude로 분석해야 하나요

상장기업의 사업보고서 한 편은 수백 페이지에 달합니다. 투자자나 애널리스트가 특정 항목(예: 매출 구조 변화, 우발채무, 주요 계약 현황)을 찾으려면 PDF를 열어 Ctrl+F를 반복해야 합니다. DART MCP를 사용하면 이 과정이 달라집니다.

  • Claude에게 “삼성전자 2024년 사업보고서에서 연구개발비 추이를 알려줘”라고 입력하면
  • MCP 서버가 DART API를 호출해 해당 공시 데이터를 가져오고
  • Claude가 수치를 정리·요약·해석해 바로 답합니다

공시 원문을 직접 열지 않아도, 비교 분석이나 트렌드 파악이 대화 한 줄로 가능해집니다.

데이터 흐름 한눈에 보기

사용자 (Claude 채팅)
      │  질의
      ▼
Claude (LLM)
      │  MCP 도구 호출
      ▼
DART MCP 서버
      │  OpenDART REST API 호출 (API 키 필요)
      ▼
opendart.fss.or.kr
      │  공시 데이터 JSON 반환
      ▼
Claude → 사용자에게 분석 결과 전달

DART MCP 서버 3종 비교

현재 MCP모아에 등록된 DART 관련 서버는 세 가지입니다.

서버명설치 방식연동 API특징
한국 주식 MCP 서버npxDART + KRX주가 데이터와 공시를 함께 분석
DART MCP 서버uvx (Python)DARTPython 환경, 로컬 실행
한국 DART MCPnpxOpenDART 83개 API15개 MCP 도구로 압축, 설치 간편

세 서버 모두 OpenDART API 키가 필요하며, 공시 원문 조회·재무제표 분석 기능을 제공합니다. 주가 데이터도 함께 필요하다면 Korea Stock MCP를, 공시 분석만 집중적으로 한다면 korean-dart-mcp가 가장 빠르게 시작할 수 있습니다.

준비물

  1. DART API 키: 금융감독원 OpenDART(opendart.fss.or.kr) 무료 회원가입 후 발급
  2. Claude Desktop 앱 또는 Claude Code (MCP 지원 환경)
  3. Node.js 18 이상 (npx 방식 서버 사용 시)
  4. Python 3.10 이상 + uv (dart-mcp uvx 방식 사용 시)

DART API 키 발급 방법

  1. opendart.fss.or.kr 접속
  2. 오른쪽 상단 회원가입 클릭 → 이메일 인증 완료
  3. 로그인 후 개발자 센터 > API 신청 메뉴 선택
  4. 이용 목적 기재 후 신청 → 수 분 내 API 키 발급
  5. 마이페이지 > API 키 관리에서 발급된 키 복사 (32자리 영숫자)

서버별 설치 및 Claude 연결 방법

방법 1: korean-dart-mcp (npx, 권장)

가장 간단하게 시작할 수 있는 방법입니다. OpenDART 83개 API를 15개의 MCP 도구로 정리해 제공합니다.

Claude Desktop 설정 파일 위치

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

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

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

설정 파일을 저장한 뒤 Claude Desktop을 완전히 종료 후 재시작하면, 채팅 창에 MCP 도구 아이콘이 나타납니다.

방법 2: Korea Stock MCP (npx, DART+KRX 통합)

주가·거래량과 공시를 함께 조회하고 싶다면 이 서버를 선택하세요.

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

GitHub 저장소: github.com/jjlabsio/korea-stock-mcp

방법 3: dart-mcp (uvx, Python 환경)

Python 환경에 익숙하고 로컬에서 직접 실행하고 싶다면 이 방법을 사용하세요.

먼저 저장소를 내려받습니다.

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": "여기에_발급받은_API_키_입력"
      }
    }
  }
}

경로의 사용자명 부분은 실제 macOS 계정명으로 바꿔주세요.

연결 확인 및 첫 번째 분석

Claude Desktop을 재시작한 후 아래와 같이 입력해 연결을 확인할 수 있습니다.

삼성전자의 최근 사업보고서 제출일을 알려줘.

MCP 도구가 정상 연결됐다면 Claude가 DART API를 호출해 공시 접수 일자와 링크를 응답합니다. 이후 다음과 같은 심층 분석도 가능합니다.

카카오의 2023년 연결 재무제표에서 영업이익과 당기순이익을 비교해줘.
SK하이닉스의 최근 3년 부채비율 변화를 표로 정리해줘.
LG에너지솔루션이 올해 제출한 공시 목록을 보여줘.

흔한 오류와 해결법

오류 1: “DART_API_KEY is not set” 또는 인증 실패

원인: 설정 파일의 API 키 값이 비어 있거나 오타가 있을 때 발생합니다.

해결: claude_desktop_config.json을 열어 DART_API_KEY 값이 정확히 입력됐는지 확인하세요. 키 앞뒤에 공백이 없어야 하며, 32자리인지 체크하세요.

오류 2: Claude가 MCP 도구를 인식하지 못함

원인: Claude Desktop을 설정 변경 후 완전히 종료하지 않고 재실행했을 때 자주 발생합니다.

해결: 시스템 트레이(macOS: 메뉴바, Windows: 작업표시줄)에서 Claude를 완전히 종료(Quit)한 뒤 다시 시작하세요. 단순 창 닫기로는 프로세스가 유지됩니다.

오류 3: npx 실행 시 패키지를 찾을 수 없음

원인: Node.js가 설치되지 않았거나 버전이 낮을 때 발생합니다.

해결: 터미널에서 node --version으로 버전을 확인하세요. 18 미만이면 nodejs.org에서 LTS 버전을 설치합니다.

오류 4: uvx 방식에서 모듈을 찾을 수 없음

원인: uv가 설치되지 않았거나 경로가 다를 때 발생합니다.

해결:

pip install uv
# 또는
curl -LsSf https://astral.sh/uv/install.sh | sh

설치 후 uv --version으로 확인하고, 설정 파일의 --directory 경로가 실제 저장소 위치와 일치하는지 점검하세요.

실전 활용 팁

토큰 한도 대응: 사업보고서 전문은 수십만 자에 달할 수 있습니다. “재무 상태표만”, “주석 5번 항목만”처럼 섹션을 특정해서 요청하면 더 정확한 분석을 얻을 수 있습니다.

비교 분석: 여러 기업을 한꺼번에 비교하려면 기업별로 나눠 질의한 뒤 결과를 정리해 달라고 요청하는 것이 효과적입니다.

공시 유형 지정: DART에는 사업보고서, 반기보고서, 분기보고서, 주요사항보고서 등 다양한 공시 유형이 있습니다. 질의할 때 “2024년 반기보고서”처럼 유형을 명시하면 더 빠르고 정확한 결과를 얻습니다.

다음 단계

DART 연동이 완료됐다면 금융 카테고리에 등록된 다른 MCP 서버도 함께 활용해 보세요. 주가·지수 데이터와 공시를 결합하면 더욱 풍부한 분석이 가능합니다. 새로운 한국 금융 MCP 서버는 서버 목록 전체 보기에서 확인할 수 있으며, 직접 개발한 서버가 있다면 MCP모아에 등록해 더 많은 사람과 공유할 수 있습니다.

자주 묻는 질문

DART API 키는 어디서 발급받나요?

금융감독원 OpenDART 사이트(opendart.fss.or.kr)에 회원가입 후 ‘개발자 센터 > API 신청’에서 무료로 발급받을 수 있습니다. 발급까지 보통 수 분 내외가 소요됩니다.

DART MCP 서버를 사용하려면 유료 Claude 구독이 필요한가요?

Claude Desktop 앱 또는 Claude Code를 통해 MCP를 연결합니다. Claude.ai 무료 플랜에서는 MCP 기능이 제한될 수 있으므로, Claude Pro 이상 또는 Claude Code(API 과금) 환경을 권장합니다.

세 가지 서버 중 어떤 것을 선택해야 하나요?

단순히 DART 공시 검색과 재무제표 조회가 목적이라면 korean-dart-mcp가 가장 빠르게 시작할 수 있습니다. DART와 KRX 주가 데이터를 함께 분석하려면 Korea Stock MCP를, Python 환경에 이미 익숙하다면 dart-mcp(uvx 방식)를 선택하세요.

공시 문서 전문을 Claude가 읽어줄 수 있나요?

DART MCP 서버는 공시 원문 텍스트를 API로 가져와 Claude에게 전달합니다. 다만 수백 페이지짜리 사업보고서는 토큰 한도 때문에 섹션별로 나눠 질의하는 것이 좋습니다.

설치 후 Claude가 ‘DART API 키가 없다’고 오류를 내면 어떻게 하나요?

Claude Desktop 설정 파일(claude_desktop_config.json)의 env 항목에 DART_API_KEY 값이 정확히 입력됐는지 확인하세요. 키 앞뒤에 공백이 들어가거나 따옴표가 빠지면 인증 오류가 발생합니다.

DART 공시 데이터는 실시간인가요?

OpenDART API는 공시 접수 즉시 반영됩니다. 다만 API 호출 빈도 제한(일별 요청 한도)이 있으므로, 대량 조회 시 공식 문서에서 호출 한도를 확인하시기 바랍니다.

이 글과 관련된 MCP 서버