설명서

MCP 연결하기

MCP는 AI 프로그램(Cursor, Claude 등)이 주차트·공시 데이터를 도구처럼 불러오게 하는 연결 방식입니다. 웹사이트의 「짧은 상담」과는 별개이며, 내 컴퓨터의 AI 앱에서 설정합니다.

MCP가 뭔가요?

일반 채팅 AI는 인터넷에 없는 최신 공시·재무를 모를 수 있습니다. MCP를 연결하면 AI가 직접 조회 도구를 써서 데이터를 가져온 뒤 답합니다.

API Key 받기

  1. joochart MCP는 서버에 설정한 JCHART_MCP_API_KEY로 인증합니다.
  2. 키는 운영자에게 받거나, 직접 호스팅하는 경우 서버 환경변수로 발급합니다.
  3. Key는 비밀번호처럼 다루세요. 채팅·공개 저장소에 붙여 넣지 마세요.

키가 필요하면 문의하기로 요청해 주세요. (MVP는 공유 키 방식)

Cursor에 연결하기 (가장 흔함)

Cursor를 쓰는 경우 아래만 따라 하면 됩니다.

  1. Cursor에서 Settings → MCP (또는 Features → MCP)를 엽니다.
  2. 새 MCP 서버를 추가하고, 아래 JSON을 붙여 넣습니다.
  3. <YOUR_API_KEY> 자리를 발급받은 Key로 바꿉니다.
  4. 저장 후 Cursor를 한 번 재시작하거나 MCP를 Refresh 합니다.
{
  "mcpServers": {
    "joochart": {
      "url": "https://joochart.com/mcp-sse/mcp",
      "headers": {
        "JCHART_API_KEY": "<YOUR_API_KEY>"
      }
    }
  }
}

설정 파일 이름이 mcp.json인 경우도 있습니다. Cursor 버전에 따라 메뉴 위치가 조금 다를 수 있어요.

잘 됐는지 확인

  1. Cursor 채팅을 엽니다.
  2. 예: 「삼성전자 최근 공시 알려줘」처럼 물어봅니다.
  3. AI가 MCP 도구(search_company, list_disclosures 등)를 호출하는지 확인합니다.

연결이 안 되면 Key 오타, 서버 주소, 방화벽·재시작 여부를 순서대로 점검하세요.

무엇을 할 수 있나요? (MVP)

투자 권유·수익 보장이 아닙니다. 원문·수치는 이용자가 최종 확인하세요. 공시 원문 조항 파싱·단타 신호는 MVP에 없습니다.

로컬 개발자용 (선택)

주차트 서버를 직접 돌릴 때만 필요합니다. 일반 사용자는 건너뛰어도 됩니다.

$env:JCHART_MCP_API_KEY="로컬_테스트_키"
$env:JCHART_DART_API_KEY="OpenDART_키"
$env:JCHART_KIS_APP_KEY="..."
$env:JCHART_KIS_APP_SECRET="..."
python server.py

로컬 Cursor URL 예: http://127.0.0.1:5175/mcp-sse/mcp

연동 문의 주식백과 보기