재무제표 MCP 분석 — DART 데이터를 Claude로 자동 해석하는 방법

Q: Claude Desktop과 Claude Code 중 어디에 설정해야 하나요?

두 곳 모두 사용할 수 있습니다. Claude Desktop은 ~/Library/Application Support/Claude/claude_desktop_config.json, Claude Code는 ~/.claude/settings.json의 mcpServers 항목에 동일한 방식으로 등록합니다.

DART 전자공시 MCP 서버를 Claude에 연결하면 기업명만 입력해도 최신 재무제표 데이터를 AI가 직접 호출해 분석합니다. OpenDART API 키 발급(무료)부터 MCP 서버 등록, 밸류에이션 프롬프트 실행까지 이 가이드 한 편으로 모두 해결할 수 있습니다. 설치는 터미널 한 줄, 분석은 자연어 질문 하나로 충분합니다.

왜 재무제표 MCP 분석인가

투자 분석을 위해 재무제표를 확인하려면 보통 DART 웹사이트에 접속해 기업을 검색하고, 사업보고서 PDF를 내려받고, 필요한 항목을 직접 찾아 옮겨 적는 과정이 필요합니다. 10개 기업을 비교하려면 이 과정을 10번 반복해야 합니다.

MCP(Model Context Protocol)를 이용하면 이 과정이 완전히 달라집니다. Claude 같은 AI 클라이언트가 MCP 서버를 통해 DART OpenAPI를 직접 호출하므로, “삼성전자와 SK하이닉스의 최근 3개년 ROE를 비교해 줘”라고 입력하면 AI가 알아서 데이터를 가져와 표로 정리합니다.

[사용자 질문]
    │
    ▼
[Claude (AI 클라이언트)]
    │  MCP 도구 호출
    ▼
[DART MCP 서버]
    │  DART / KRX OpenAPI 요청
    ▼
[금융감독원 OpenDART / 한국거래소 KRX]
    │  재무 데이터 반환
    ▼
[Claude 분석 결과 출력]

어떤 MCP 서버를 선택할까

현재 MCP모아에 등록된 DART 계열 서버는 세 가지입니다. 목적에 따라 하나 또는 여러 개를 함께 사용할 수 있습니다.

서버	지원 API	설치 방식	특징
한국 주식 MCP 서버	DART + KRX	npx	주가·시총 통합 분석
DART MCP 서버	DART(전자공시)	uvx (Python)	공시 텍스트 심층 분석
한국 DART MCP	OpenDART 83개 API	npx	15개 도구로 압축, 광범위한 공시 커버

투자자·주식 분석가: 한국 주식 MCP 서버 — 주가와 재무를 한 번에
공시 분석·IR 담당자: 한국 DART MCP — 83개 API 전체 커버
Python 환경 선호: DART MCP 서버 — uvx 기반 로컬 실행

준비물

Claude Desktop 또는 Claude Code (최신 버전)
Node.js 18 이상 (npx 방식 서버용)
Python 3.11 이상 + uv (uvx 방식 서버용, DART MCP 서버 한정)
OpenDART API 키 (무료, 아래 1단계에서 발급)

단계별 설치 및 설정

1단계: OpenDART API 키 발급

모든 DART 계열 MCP 서버는 OpenDART API 키가 필요합니다.

opendart.fss.or.kr에 접속합니다.
우측 상단 회원가입을 클릭해 이메일로 가입합니다.
로그인 후 인증키 신청/관리 메뉴로 이동합니다.
용도를 입력하고 신청합니다. 이메일 인증 후 즉시 40자리 인증키가 발급됩니다.
발급된 키를 안전한 곳에 보관합니다. 이 키는 외부에 노출하지 마세요.

2단계: MCP 서버 선택 및 설정 파일 등록

선택한 서버에 따라 설정 방법이 다릅니다.

옵션 A — 한국 주식 MCP 서버 (npx, 권장)

Claude Desktop 설정 파일(~/Library/Application Support/Claude/claude_desktop_config.json) 또는 Claude Code 설정 파일(~/.claude/settings.json)의 mcpServers 항목에 아래를 추가합니다.

{
  "mcpServers": {
    "korea-stock-mcp": {
      "command": "npx",
      "args": ["-y", "korea-stock-mcp@latest"],
      "env": {
        "DART_API_KEY": "발급받은_40자리_키"
      }
    }
  }
}

설치 명령은 npx -y korea-stock-mcp@latest이며, 설정 파일에 등록하면 클라이언트가 자동으로 실행합니다. 별도 설치 단계는 없습니다.

옵션 B — 한국 DART MCP (npx)

{
  "mcpServers": {
    "korean-dart-mcp": {
      "command": "npx",
      "args": ["-y", "korean-dart-mcp"],
      "env": {
        "DART_API_KEY": "발급받은_40자리_키"
      }
    }
  }
}

설치 명령은 npx -y korean-dart-mcp입니다. OpenDART 83개 API를 15개 MCP 도구로 래핑해 제공하므로 광범위한 공시 분석에 적합합니다.

옵션 C — DART MCP 서버 (uvx, Python 환경)

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

git clone https://github.com/2geonhyup/dart-mcp ~/Downloads/dart-mcp

설정 파일에는 아래와 같이 등록합니다.

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

실행 명령(uv --directory ~/Downloads/dart-mcp run dart.py)은 스펙에 명시된 그대로입니다. 사용자명 부분은 본인의 macOS 사용자 이름으로 교체하세요.

3단계: 클라이언트 재시작 및 연결 확인

설정 파일을 저장한 뒤 AI 클라이언트를 완전히 종료하고 다시 시작합니다.

Claude Code: 터미널에서 /mcp 명령을 입력해 등록한 서버가 connected 상태인지 확인합니다.
Claude Desktop: 앱 내 설정 → MCP 탭에서 서버 상태(초록 점)를 확인합니다.

서버 이름 옆에 오류 메시지가 보이면 아래 흔한 오류와 해결 섹션을 참고하세요.

4단계: 재무제표 분석 프롬프트 실행

연결이 확인됐다면 자연어로 바로 분석을 시작할 수 있습니다.

기본 재무 조회

삼성전자의 최근 사업보고서에서 매출액, 영업이익, 당기순이익을 연도별 표로 정리해 줘.

경쟁사 비교

현대차와 기아의 2023년 부채비율, 유동비율, ROE를 비교해 줘.

공시 목록 검색

최근 한 달간 SK하이닉스가 제출한 공시 목록을 보여 줘.

5단계: 밸류에이션 심화 분석

재무 데이터가 확보되면 AI에게 계산과 해석을 맡길 수 있습니다.

네이버의 최근 3개년 PER과 PBR을 계산하고, 동종 업계 평균과 비교해서 현재 주가가 과대·과소평가됐는지 의견을 줘.

카카오의 5개년 매출 CAGR을 계산하고, 영업이익률 추이와 함께 성장성을 분석해 줘.

AI가 DART MCP 도구를 통해 데이터를 가져온 뒤, 계산과 서사적 해석까지 한 번에 제공합니다.

흔한 오류와 해결

오류 상황	원인	해결 방법
서버가 `error` 상태	JSON 문법 오류	설정 파일을 JSON 유효성 검사 도구로 확인
`DART_API_KEY not found`	env 키 미설정	설정 파일의 `env` 항목에 키가 정확히 입력됐는지 확인
`npx: command not found`	Node.js 미설치	Node.js 18+ 설치 후 재시도
`uv: command not found`	uv 미설치	`pip install uv` 또는 공식 문서대로 uv 설치
기업 검색 결과 없음	비공식 기업명	종목코드 또는 DART에 등록된 정식 법인명 사용
API 호출 한도 초과	하루 허용량 초과	다음 날 재시도, 또는 조회 기업 수를 줄여 분산

자주 묻는 질문

DART OpenAPI 키는 유료인가요?

아닙니다. OpenDART API 키는 무료로 발급됩니다. opendart.fss.or.kr에서 회원가입 후 이메일 인증만 거치면 당일 발급됩니다. 단, 일일 호출 횟수 제한이 있으므로 대량 분석 시에는 호출 수를 고려해 쿼리를 설계하세요.

Claude Desktop과 Claude Code 중 어디에 설정해야 하나요?

두 곳 모두 사용할 수 있습니다. Claude Desktop은 ~/Library/Application Support/Claude/claude_desktop_config.json, Claude Code는 ~/.claude/settings.json의 mcpServers 항목에 동일한 방식으로 등록합니다.

재무제표 MCP로 비상장기업도 조회할 수 있나요?

DART에 공시 의무가 있는 비상장 법인은 일부 조회 가능하지만, 데이터 범위는 상장사에 비해 제한적입니다. 코스피·코스닥 상장기업이 가장 풍부한 데이터를 제공합니다.

기업명을 한글로 입력해도 인식하나요?

네. DART MCP 서버들은 내부적으로 기업명을 법인코드로 변환하는 로직을 갖추고 있어 한글 기업명으로도 검색됩니다. 다만 동명이인 기업이 있을 경우 종목코드를 함께 제공하면 더 정확합니다.

Korea Stock MCP와 DART MCP의 차이는 무엇인가요?

Korea Stock MCP는 DART와 KRX(한국거래소) 두 API를 동시에 지원해 주가·시총 같은 시장 데이터까지 통합 분석할 수 있습니다. DART MCP 계열은 공시·재무제표 분석에 특화되어 있습니다. 투자 분석이 목적이라면 Korea Stock MCP가, 공시 텍스트 심층 분석이 목적이라면 Korean DART MCP가 유리합니다.

MCP 서버가 연결되지 않을 때 어떻게 하나요?

설정 파일의 JSON 문법 오류, API 키 누락, Node.js 또는 Python 환경 미설치가 주요 원인입니다. Claude Code라면 /mcp 명령으로 오류 메시지를 확인하고, 해당 서버의 GitHub 저장소 Issues 탭에서 알려진 오류를 검색해 보세요.

다음 단계

DART MCP를 연결했다면 다음 단계로 나아가 보세요.

한국 주식 MCP 서버 상세 보기 — KRX 시장 데이터까지 통합 분석
DART MCP 서버 상세 보기 — Python 기반 공시 텍스트 분석
한국 DART MCP 상세 보기 — 83개 OpenDART API 전체 커버
금융 카테고리 전체 서버 보기 — 다른 한국 금융 MCP 서버 탐색
MCP 서버 전체 목록 — MCP모아에 등록된 모든 서버 보기

재무제표 분석 외에도 공공데이터 API MCP나 한국 경제 통계 ECOS MCP 같은 서버를 함께 활용하면 더욱 종합적인 경제 분석이 가능합니다.