API 키 없이 URL 한 줄로 붙는 한국 주식 MCP 커스텀 커넥터: 정체 분석, 사용법 & 팩트체크

복잡한 회원가입이나 API 키 발급 없이, 서버 URL 한 줄 설정만으로 KOSPI 및 KOSDAQ 시장 데이터와 기업 공시, 실적 리서치 정보를 AI 에이전트에 직결할 수 있는 MCP(Model Context Protocol) 커스텀 커넥터가 등장했습니다.

본 글에서는 많은 개발자와 리서처들이 궁금해하는 이 한국 주식 MCP 커넥터의 정체와 클라이언트별 구체적인 사용 방법(설정법), 그리고 실전 도구 테스트 결과와 팩트체크를 상세히 다룹니다.

1. 초보자를 위한 핵심 용어 사전

주식 데이터 연동 및 AI 에이전트 개발에서 자주 쓰이는 대표 용어 모음입니다.

MCP(Model Context Protocol): AI 에이전트와 외부 데이터베이스, API 도구를 안전하게 연결해 주는 오픈 표준 프로토콜입니다.
SSE (Server-Sent Events): 서버에서 클라이언트로 실시간 이벤트 및 MCP 메시지를 스트리밍 전송하는 웹 프로토콜 방식입니다.
T+1 확정 종가 스냅샷: 당일 장 마감 후 최종 정산이 완료된 시점의 정밀 데이터 모음입니다.
KIS API(한국투자증권 API): 장중 실시간 시세 조회 및 실제 주식 주문 매매를 가능하게 하는 증권사 전용 OpenAPI입니다.
시총 상위 1,500 유니버스: 코스피 및 코스닥 상장 종목 중 시가총액 기준 상위 1,500개 핵심 종목으로 구성된 분석 데이터 세트입니다.

2. 한국 주식 MCP 커넥터 정체 분석

이번에 테스트한 한국 주식 MCP 커넥터는 국내 주식 시장(KOSPI, KOSDAQ)의 시가총액 상위 1,500개 종목을 대상으로 일별 시계열, 기업 공시, 잠정 실적, 테마별 랭킹을 AI 모델이 즉시 조회할 수 있도록 구성된 전용 MCP 서버입니다.

이 MCP 커넥터의 주요 정체 요소

서버 형태: URL 연결 기반의 SSE(Server-Sent Events) 커스텀 MCP 커넥터 (또는 mcp-remote 래퍼)
데이터 수집 대상: 한국거래소(KRX) 및 금융감독원 DART 공시 기반 정제 데이터
오픈 인프라 특징: 사용자 개인별 API 키(Secret Key) 발급 절차를 철저히 생략하고, 공공 서버 엔드포인트 URL 등록만으로 즉시 구동 가능
인터페이스: Glama 및 주요 MCP 레지스트리에 등록되어 있으며, 총 12종의 리서치 특화 도구(Tools)를 제공합니다.

3. 클라이언트별 1분 설치 및 연동 사용 방법

AI 클라이언트(Claude Desktop, Cursor, Claude Code CLI 등)에서 이 MCP 커넥터를 추가하는 방법은 매우 간단합니다.

1) Claude Desktop 환경 설정 방법

설정 파일 경로: %APPDATA%\Claude\claude_desktop_config.json (Windows) 또는 ~/Library/Application Support/Claude/claude_desktop_config.json (Mac)

설정 파일의 mcpServers 항목에 아래와 같이 커넥터 URL을 추가합니다.

{
  "mcpServers": {
    "korea-stock-connector": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-fetch",
        "https://korea-stock-mcp.connector.url/sse"
      ]
    }
  }
}

(참고: Glama 또는 Custom URL 연동 인터페이스 지원 클라이언트의 경우, 설정 메뉴의 Add MCP Server 란에 제공된 커넥터 SSE URL 한 줄만 직접 붙여넣으시면 자동 로드됩니다.)

2) Cursor IDE 연동 방법

Cursor 설정(Settings) -> Features -> MCP Servers 항목으로 이동합니다.
Add New MCP Server 버튼을 클릭합니다.
Name에 korea-stock, Type에 SSE (또는 command)를 선택합니다.
Server URL 란에 주어진 커넥터 엔드포인트 주소를 입력하고 저장합니다.

4. 12종 도구 실전 호출 테스트 결과 & 팩트체크

MCP 커넥터 주식 데이터 스트림 아키텍처

실제 커스텀 커넥터를 로드한 결과, 당초 일각에서 알려졌던 6개가 아닌 총 12개의 전체 도구가 정상 탐색되었습니다.

정상 작동 확인된 12종 도구 목록

get_today: 시장 당일 요약, 랭킹 및 주요 공시 조회
search_stock: 종목명 및 종목코드 검색
get_stock: 개별 종목 상세 정보 및 수급 분석
list_stocks: 유니버스 내 전체 종목 리스트 반환
get_earnings: 잠정 실적 및 분기 실적 데이터 조회
get_history: 일별 주가 시계열(최대 250일) 조회
get_disclosure_impact: 공시 발표 후 주가 변동성 및 영향도 분석
get_disclosures: 개별 종목 공시 목록 조회
get_earnings_calendar: 실적 발표 일정 달력 조회
get_rankings: 시가총액, 상승률, 실적 성장 랭킹 반환
get_market_summary: 코스피/코스닥 지수 및 수급 종합 요약
get_data_urls: 데이터 출처 및 원본 수집 링크 제공

실전 호출 테스트 팩트체크

get_today 호출 결과: 2026-08-11 T+1 확정 기준 데이터 정상 반환. (코스피 6,345.53 / 코스닥 857.84, 상승 896개 종목 우세, 위메이드·마녀공장·가비아 공시, SK하이닉스·삼성전자·펄어비스 성장 랭킹)
search_stock 호출 결과: 입력 키워드 ‘삼성전자’ -> 종목코드 005930, KOSPI, 시총 약 1,400조 원 정확 조회.

5. 데이터 스펙 및 운용 시 주의사항

해당 커넥터를 활용할 때 반드시 인지해야 하는 데이터 스펙 조건 2가지입니다.

구분 항목	세부 스펙 내용	개발 시 고려사항
데이터 갱신 주기	매 거래일 18:10 KST (T+1 확정 종가)	장중 틱 단위 실시간 시세가 아닌 저녁 스냅샷 데이터임
데이터 집계 범위	시가총액 상위 1,500 유니버스 (당일 1,463개)	우선주, 리츠, 스팩(SPAC) 종목은 집계 대상에서 제외됨
응답 데이터 구성	데이터 신선도, 수집 출처, 집계 범위, 면책 문구	LLM 프롬프트에 환각 없이 객관적 출처 명시 가능
인증 방식	API 키 미필요 (URL 연결 방식)	초기 도입 및 보조 데이터베이스 구축에 극도로 유리

6. 한국 주식 어드바이저 앱 연동 아키텍처 제안

현재 구축 중인 한국 주식 어드바이저 애플리케이션(FastAPI + React + KIS API)이 있다면, 본 MCP 커넥터를 결합하여 강력한 하이브리드 리서치 시스템을 완성할 수 있습니다.

역할 분담 아키텍처

KIS API (증권사 공식 API): 장중 초단위 실시간 체결가 조회, 호가창 데이터, 실제 주식 주문 및 계좌 잔고 조회 담당.
MCP 커스텀 커넥터: get_history를 활용한 250일 시계열 차트 분석, get_disclosure_impact를 통한 공시 후 주가 영향도 리서치, 분기 실적 모멘텀 및 테마 랭킹 분석 보조 담당.

이 두 데이터 소스를 결합하면 실시간 매매와 정밀 공시/실적 리서치를 동시에 제공하는 고성능 AI 주식 어드바이저를 손쉽게 구축할 수 있습니다!