토스증권 MCP 서버

어떤 도구인가

토스증권 Open API를 Claude에 연결하는 로컬 MCP 서버입니다. 설치하면 Claude와의 대화에서 내 실계좌의 잔고, 시세, 호가, 체결 내역을 바로 조회하고, 주문까지 이어갈 수 있습니다. "내 포트폴리오 리스크 진단해줘" 한 문장이 실데이터 기반 분석으로 돌아옵니다.

TypeScript와 MCP SDK로 구현했고, 총 19개 도구를 제공합니다.

도구 구성

• 조회 16종: 계좌, 잔고, 보유 종목, 실시간 시세, 호가, 캔들, 환율, 거래 캘린더, 주문 내역, 매도 가능 수량, 종목 경고 등
• 주문 3종: 주문 생성, 정정, 취소

조회와 주문을 명확히 분리한 게 설계의 중심입니다.

주문 이중 게이트

AI에게 주문 권한을 주는 건 신중해야 합니다. 모델이 맥락을 잘못 읽고 주문을 내는 시나리오를 막기 위해, 주문 도구는 이중 확인 게이트를 거칩니다. 주문 파라미터를 받아도 바로 실행되지 않고, 안전 체크를 통과한 뒤 사용자가 매번 명시적으로 승인해야 실제 주문이 나갑니다.

분석과 제안은 자유롭게, 돈이 움직이는 동작은 항상 사람의 확인 뒤에. 이 원칙을 도구 구조 자체에 박았습니다.

위에 쌓은 것들

서버를 만들고 나니 그 위에 워크플로를 쌓을 수 있었습니다. 아침에 보유 종목 뉴스와 장 일정을 정리하는 모닝 브리핑, 집중도와 상관관계를 진단하는 퀀트 리스크 분석, 드리프트를 계산해 매매안을 제안하는 리밸런싱까지, 전부 이 MCP 서버를 데이터 소스로 쓰는 AI 스킬입니다.

배운 점

MCP 서버는 한 번 만들면 끝나는 도구가 아니라 플랫폼이 됩니다. 19개 도구를 잘 정의해두니 새로운 투자 워크플로가 코드 추가 없이 프롬프트 레벨에서 만들어졌습니다. 인터페이스 설계에 들인 시간이 가장 수익률 높은 투자였습니다.