다올투자증권 MCP

다올투자증권 계좌를 MCP 호환 AI 도구에서 본인 키로 직접 조회·주문할 수 있게 해 주는 로컬 MCP 서버입니다.

AI와 증권 계좌를 한 줄로 연결하다. mcp.daolfn.com

지원 기능

AI에게 자연어로 요청하면 아래를 대신 수행합니다. 주문류는 미리보기 → 확인 → 실행 순서로만 움직여, 예상 체결금액·수수료·위험 안내를 먼저 보여 주고 확인한 주문만 전송합니다.

조회 도구

• 계좌·잔고: 예수금·평가금액·총자산·평가손익, 보유 종목(마스킹된 계좌번호)
• 시세: 종목 현재가·등락률·거래량·호가
• 주문 내역: 체결·미체결 주문 목록과 개별 주문 상세

주문 도구 (미리보기 → 확인 후 실행)

• 매수·매도: 지정가·시장가 주문
• 정정·취소: 미체결 주문 정정·취소

현재는 국내주식을 우선 지원하며, 해외주식은 지원 예정입니다.

설치

먼저 다올투자증권 Fi 앱 → 고객 서비스 → MCP 이용 신청에서 App Key / App Secret 을 발급받으세요.

macOS / Linux

curl -fsSL https://mcp.daolfn.com/install.sh | sh

Windows (PowerShell)

irm https://mcp.daolfn.com/install.ps1 | iex

설치가 끝나면 설치 도우미가 떠서 App Key / App Secret 을 입력받습니다. 이어서 연결할 AI 도구를 고르면 등록까지 끝나고, 해당 앱을 재시작하면 바로 사용할 수 있습니다.

지원 AI 도구

Claude Desktop · Claude Code · Cursor · Codex · ChatGPT 데스크톱. (ChatGPT 데스크톱은 Codex와 같은 설정을 공유하므로, Codex를 따로 설치하지 않아도 됩니다. ChatGPT 웹은 로컬 설정을 읽지 않아 지원하지 않습니다.)

지원 환경

• macOS: Intel·Apple Silicon의 일반 사용자 터미널
• Windows 10/11 (x64): Windows PowerShell 또는 PowerShell 7의 일반 사용자 세션(32비트 Windows 미지원)
• Linux: GNOME Keyring·KWallet 등 Secret Service와 사용자 D-Bus 세션이 실행 중인 데스크톱

WSL 안에 설치한 MCP는 Windows용 Claude Desktop/Cursor 설정과 자동으로 공유되지 않습니다. Windows GUI 앱에서 사용할 때는 WSL이 아니라 Windows PowerShell에서 설치하세요. 헤드리스 Linux는 키체인을 별도로 구성해야 하므로 1차 일반 사용자 지원 대상이 아닙니다.

AI 도구를 찾지 못했다는 안내가 나오면 Claude Desktop/ChatGPT/Cursor 등을 한 번 실행해 설정 디렉터리를 만든 뒤 아래 방법으로 setup을 다시 실행하세요.

Windows는 공식 Python을 %LOCALAPPDATA%\DAOL\MCP에 설치합니다. 별도 Python·uv 설치나 관리자 권한은 필요하지 않습니다. 기존 daol-mcp.exe로 등록된 AI 도구는 설치 중 실행 경로가 갱신됩니다. 설치·업데이트 전에 AI 도구를 완전히 종료하고, 완료 후 다시 실행하세요.

명령어

Windows에서도 대부분의 PC 에서는 아래 표의 짧은 명령을 그대로 쓸 수 있습니다(설치 후 새로 연 PowerShell·명령 프롬프트에서). Smart App Control 이 켜진 PC 는 스크립트 실행이 막혀 짧은 명령을 만들지 않으므로, 설치 도우미가 안내하는 다음 형식을 씁니다. 마지막 doctor를 setup, accounts, update, logout 등으로 바꾸면 됩니다.

& "$env:LOCALAPPDATA\DAOL\MCP\runtime\python.exe" -I -X utf8 -m daol_local_mcp doctor

보안

• 비밀값은 OS 키체인에만. 평문 파일·로그·AI 도구 설정에 App Secret 을 저장하지 않습니다.
• 모든 서버 통신은 HTTPS 강제.
• MCP 서버는 로컬 stdio 로만 동작: 네트워크 포트를 열지 않습니다.
• 공식 PyPI의 공개 패키지를 설치하며 소스 빌드를 허용하지 않습니다.
• Windows Python·설치 도구는 버전과 SHA-256을 고정하고 Python의 PSF 코드 서명을 확인합니다.
• Smart App Control이 네이티브 의존성을 차단하면 설치 검사가 중단됩니다. 보안 설정을 끄지 말고 %TEMP%\daol-install.log와 차단 파일명을 지원팀에 전달해주세요.

제거

Windows PowerShell

먼저 연결을 해제한 뒤 AI 도구를 완전히 종료하고 프로그램 폴더를 삭제합니다.

& "$env:LOCALAPPDATA\DAOL\MCP\runtime\python.exe" -I -X utf8 -m daol_local_mcp logout
Remove-Item -LiteralPath "$env:LOCALAPPDATA\DAOL\MCP" -Recurse -Force

이전 uv 설치본도 남아 있다면 uv tool uninstall daol-mcp로 별도 제거할 수 있습니다.

macOS/Linux

daol-mcp logout
uv tool uninstall daol-mcp