🛠️ Developers

Paradise 서비스를 AI 클라이언트에서 활용하기 위한 개발자 도구 및 연동 가이드

📊 FinSight MCP Server

FinSight의 재무 분석 결과를 Claude, ChatGPT, Cursor, Windsurf 등 MCP(Model Context Protocol)를 지원하는 AI 클라이언트에서 직접 조회할 수 있습니다.

MCP Protocol무료읽기 전용

제공 도구

도구	설명	비용
finance_get_analysis	분석 결과 조회 — analysisId로 스토리, 인사이트, 지표, ScoreCard 조회	무료

사용 흐름

1FinSight 웹에서 기업을 분석합니다.
2분석 완료 후 URL에서 analysisId를 복사합니다.
3AI 클라이언트에서 finance_get_analysis를 호출합니다.

AI 클라이언트 연동

Claude Desktop

설정 파일: ~/Library/Application Support/Claude/claude_desktop_config.json (macOS)

{
  "mcpServers": {
    "paradise": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://paradise-mcp-446936867636.asia-northeast3.run.app/mcp"]
    }
  }
}

mcp-remote가 원격 Streamable HTTP 서버를 로컬 stdio로 브릿지합니다. Node.js 18+ 필요.

ChatGPT Desktop

설정 파일: ~/Library/Application Support/OpenAI/ChatGPT/mcp.json (macOS)

{
  "mcpServers": {
    "paradise": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://paradise-mcp-446936867636.asia-northeast3.run.app/mcp"]
    }
  }
}

Cursor IDE

전역: ~/.cursor/mcp.json / 프로젝트: .cursor/mcp.json

{
  "mcpServers": {
    "paradise": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://paradise-mcp-446936867636.asia-northeast3.run.app/mcp"]
    }
  }
}

Windsurf IDE

설정 파일: ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "paradise": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://paradise-mcp-446936867636.asia-northeast3.run.app/mcp"]
    }
  }
}

Claude Code (CLI)

claude mcp add paradise \
  --transport http \
  --url https://paradise-mcp-446936867636.asia-northeast3.run.app/mcp \
  -s user

Claude Code는 Streamable HTTP를 네이티브로 지원합니다.

사용 예시

AI 클라이언트에서 이렇게 요청하세요:

"analysisId abc123의 재무 분석 결과를 보여줘"

→ finance_get_analysis 자동 호출 → 스토리, 지표, ScoreCard, 투자 인사이트 반환

서버 정보

엔드포인트: https://paradise-mcp-446936867636.asia-northeast3.run.app/mcp
프로토콜: MCP (Model Context Protocol) over HTTP
인증: 불필요 (읽기 전용)
버전: v0.2.0
상태: Health Check ↗

🔮 향후 계획

📊FinSight 분석 요청 — 인증 + Rate Limit 추가 후 분석 요청 도구 공개 예정
📈추이/주가 데이터 — DART/SEC 추이 및 주가 차트 데이터 조회
🔌추가 서비스 플러그인 — 새로운 서비스 도구 순차 공개