M MCP모아
튜토리얼

DART MCP 서버 설치·사용법 — 한국 전자공시시스템(DART) API로 상장

DART-mcp-server를 Claude Desktop·Cursor에 연결해 상장사 공시·재무 데이터를 AI로 조회하는 단계별 설치 가이드. DART API 키 발급부터 Claude 연동·검증까지 완전 정리.

DART 전자공시시스템 MCP 서버가 Claude Desktop에 상장사 재무 데이터를 전달하는 흐름을 나타낸 표지 이미지

DART MCP 서버를 설치하면 Claude나 Cursor 안에서 자연어로 한국 상장사의 공시 내역과 재무제표를 바로 조회할 수 있습니다. 이 글에서는 금융감독원 전자공시시스템(DART) API 키 발급부터 Docker 기반 서버 설치, Claude Desktop 연동, 실제 동작 검증까지 전 과정을 단계별로 안내합니다. 설치에 걸리는 시간은 약 10~15분이며, Python이나 별도 언어 런타임은 필요하지 않습니다.

DART MCP 서버가 왜 필요한가요?

한국 주식 투자자나 재무 분석가라면 DART(Data Analysis, Retrieval and Transfer System)를 잘 아실 겁니다. 금융감독원이 운영하는 이 시스템에는 코스피·코스닥 상장사 수천 곳의 사업보고서, 분기보고서, 주요 경영 사항 공시, 감사보고서가 집적되어 있습니다. 문제는 원하는 데이터를 찾으려면 웹 사이트를 직접 탐색하거나 API를 별도로 코딩해야 한다는 점입니다.

DART MCP 서버는 이 과정을 없애 줍니다. MCP(Model Context Protocol)를 통해 Claude 같은 AI 어시스턴트가 DART API를 직접 호출할 수 있게 해주므로, “삼성전자 2023년 연결 재무제표 요약해 줘”처럼 일상적인 말로 물어보면 AI가 실제 공시 데이터를 가져와 답변합니다.

사용자 질문
    │
    ▼
Claude Desktop / Cursor
    │  MCP 프로토콜
    ▼
DART-mcp-server (Docker 컨테이너)
    │  DART OpenAPI (HTTPS)
    ▼
opendart.fss.or.kr
    │
    ▼
공시 데이터·재무제표 응답

사전 준비물

항목설명
DART API 키opendart.fss.or.kr 무료 회원가입 후 발급
Docker DesktopDART-mcp-server 실행에 필요
Node.js 18 이상Smithery CLI(npx) 사용 시 필요
Claude Desktop 또는 CursorMCP 클라이언트 역할

단계별 설치 방법

1단계 — DART API 키 발급

DART OpenAPI를 사용하려면 먼저 API 키를 발급받아야 합니다.

  1. opendart.fss.or.kr/api/signup.do 에 접속합니다.
  2. 회원가입을 완료하고 이메일 인증을 진행합니다.
  3. 로그인 후 마이페이지에서 API 키 신청을 클릭합니다.
  4. 사용 목적을 입력하고 신청을 완료합니다. 보통 1~2 영업일 내에 키가 이메일로 발급됩니다.

발급된 키는 다음과 같은 형식입니다(예시 값).

a1b2c3d4e5f6g7h8i9j0k1l2m3n4o5p6

이 키는 절대 공개 저장소에 올리지 마세요. 환경 변수로만 관리합니다.

2단계 — Docker Desktop 설치 확인

DART-mcp-server는 Docker 이미지로 배포됩니다. 아직 Docker가 없다면 docker.com 에서 Docker Desktop을 설치하세요.

설치 여부 확인:

docker --version

출력 예시:

Docker version 26.1.4, build 5650f9b

버전 숫자가 뜨면 정상입니다. Docker Desktop이 실행 중(상태 바 아이콘 확인)인지도 확인하세요.

3단계 — Smithery CLI로 DART-mcp-server 설치

Smithery CLI를 이용하면 Claude Desktop에 서버를 자동으로 등록할 수 있습니다.

npx -y @smithery/cli install snaiws/dart-mcp-server --client claude

이 명령은 다음을 자동으로 수행합니다.

  • Docker 이미지를 pull합니다.
  • Claude Desktop 설정 파일에 서버 항목을 추가합니다.

설치 중 DART API 키 입력을 요청하면 발급받은 키를 입력하세요.

4단계 — Claude Desktop 설정 파일 직접 확인·수정

Smithery CLI가 자동 등록을 완료했더라도 설정 파일을 직접 확인하는 것이 좋습니다.

macOS 설정 파일 경로:

~/Library/Application Support/Claude/claude_desktop_config.json

Windows 설정 파일 경로:

%APPDATA%\Claude\claude_desktop_config.json

파일을 열어 아래와 유사한 항목이 추가되어 있는지 확인합니다.

{
  "mcpServers": {
    "dart-mcp-server": {
      "command": "docker",
      "args": ["run", "--rm", "-i", "-e", "DART_API_KEY", "snaiws/dart-mcp-server"],
      "env": {
        "DART_API_KEY": "여기에_발급받은_API_키_입력"
      }
    }
  }
}

DART_API_KEY 값을 실제 발급받은 키로 교체하세요.

5단계 — Claude Desktop 재시작 및 연결 검증

설정 파일을 저장한 뒤 Claude Desktop을 완전히 종료하고 다시 실행합니다. 메뉴 바(macOS) 또는 시스템 트레이(Windows)에서 완전 종료를 선택하세요.

재시작 후 Claude 채팅창에 다음과 같이 입력해 보세요.

삼성전자의 최근 공시 목록을 보여줘.

Claude가 실제 DART 데이터를 가져와 응답하면 연동이 완료된 것입니다.

uvx 방식 대안 — DART-MCP (dart-mcp)

Docker 없이 Python uv를 선호한다면 별도 구현체인 DART-MCP를 사용할 수 있습니다. 이 서버는 GitHub 저장소를 로컬에 클론한 뒤 아래 명령으로 실행합니다.

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

uv가 설치되어 있지 않다면 docs.astral.sh/uv 를 참고해 설치하세요. Claude Desktop 설정 파일에는 command를 위 경로로 지정합니다.

함께 사용하면 좋은 서버

DART 공시 데이터에 더해 실시간에 가까운 주가 데이터까지 분석하고 싶다면 한국 주식 MCP 서버도 설치해 보세요. DART와 KRX(한국거래소) 공식 API를 모두 지원하며, Claude 안에서 공시 내용과 주가 흐름을 함께 비교 분석할 수 있습니다.

서버주요 데이터설치 방식
DART-mcp-server공시·재무제표·감사보고서Docker (Smithery)
한국 주식 MCP 서버DART + KRX 주가npx
DART-MCP공시·재무제표uvx (uv)

흔한 오류와 해결 방법

오류: “Cannot connect to the Docker daemon”

Docker Desktop이 실행 중이지 않을 때 발생합니다. Docker Desktop 앱을 먼저 실행하세요.

오류: API 키 인증 실패 (401 Unauthorized)

설정 파일의 DART_API_KEY 값이 잘못됐거나 키 발급이 아직 완료되지 않은 경우입니다. DART 마이페이지에서 키 상태를 확인하세요.

오류: Claude Desktop에서 DART 서버가 목록에 없음

  1. 설정 파일(claude_desktop_config.json)이 올바른 JSON 형식인지 확인합니다(쉼표 누락, 따옴표 오류 등).
  2. Claude Desktop을 완전 종료 후 재시작합니다.
  3. Smithery CLI 설치를 다시 실행해 덮어쓰기합니다.

오류: “docker: command not found”

Node.js 환경에서 npx가 Docker를 찾지 못하는 경우입니다. 터미널을 재시작하거나 Docker Desktop의 PATH 설정을 확인하세요.

자주 묻는 질문

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

opendart.fss.or.kr/api/signup.do 에서 회원가입 후 발급받을 수 있습니다. 개인·법인 모두 무료로 신청 가능하며, 심사 후 보통 1~2 영업일 내에 키가 발급됩니다.

DART-mcp-server는 왜 Docker로 실행하나요?

이 서버는 Python 의존성과 실행 환경을 Docker 이미지로 패키징해 배포합니다. 따라서 로컬에 Python을 별도 설치하지 않아도 되고, 운영 환경 차이로 인한 오류를 줄일 수 있습니다.

Cursor에서도 DART MCP 서버를 사용할 수 있나요?

네, 가능합니다. Cursor의 MCP 설정(Settings → MCP)에서 Claude Desktop과 동일한 방식으로 서버 커맨드와 API 키를 등록하면 됩니다.

조회할 수 있는 데이터 범위는 어떻게 되나요?

DART OpenAPI가 제공하는 범위 내에서 공시 목록, 사업보고서, 재무제표(연결·별도), 주요 경영 사항 등을 조회할 수 있습니다. 실시간 주가 데이터는 DART의 범위 밖입니다.

API 호출 한도가 있나요?

DART OpenAPI는 1일 10,000건의 무료 호출 한도를 제공합니다. 개인 분석 용도로는 충분한 수준이며, 초과 시 다음 날 자정에 초기화됩니다.

설치 후 Claude에서 DART 서버가 인식되지 않을 때 어떻게 해야 하나요?

Claude Desktop을 완전히 종료 후 재시작하고, 설정 파일 경로와 JSON 형식이 올바른지 다시 확인하세요. macOS는 ~/Library/Application Support/Claude/claude_desktop_config.json, Windows는 %APPDATA%/Claude/claude_desktop_config.json입니다.

다음 단계

DART MCP 서버가 정상적으로 동작한다면 금융(finance) 카테고리에서 ECOS, KRX 등 다른 한국 금융 데이터 MCP 서버도 살펴보세요. MCP모아 서버 목록에서 분야별 서버를 검색할 수 있으며, 새로운 한국 MCP 서버가 있다면 가이드 목록에서 관련 설치 가이드를 확인하거나 직접 서버를 등록해 주세요.

이 글과 관련된 MCP 서버