Bulliza베타
MCP SERVER

Claude Desktop 연결하기

Claude Desktop 의 설정 파일에 불리자 MCP 서버를 한 블록 추가하면 끝이에요. 다음 대화부터 Claude 가 자연어로 우리 데이터를 끌어다 답변해줘요.

설정 단계

  1. 1
    API 키 준비하기
    아직 키가 없으면 /my/api-keys 에서 발급받아요. REST 와 같은 키를 쓰면 돼요.
  2. 2
    Claude Desktop 설정 파일 열기
    macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
    Windows: %APPDATA%\Claude\claude_desktop_config.json
    파일이 없으면 새로 만들어요.
  3. 3
    불리자 MCP 서버 추가하기
    아래 JSON 블록을 mcpServers 안에 추가해요.
  4. 4
    Claude Desktop 재시작
    완전히 종료 후 다시 실행하면 새 MCP 서버가 인식돼요.
  5. 5
    대화에서 자연어로 호출
    "불리자에서 삼성전자 점수 알려줘" / "반도체 수출 추세 보여줘" 같이 물어보면 자동으로 tool 호출.

설정 파일 예시

json
{
  "mcpServers": {
    "richgo-finance": {
      "transport": "streamable-http",
      "url": "https://bulliza.com/api/mcp",
      "headers": {
        "Authorization": "Bearer rfk_live_<your-key>"
      }
    }
  }
}
키를 깃에 올리지 마세요
설정 파일에는 평문 키가 들어가요. 이 파일을 깃 저장소에 커밋하지 말고, dotfiles 동기화 도구를 쓴다면 .gitignore 에 추가해 주세요. 깃허브에 노출된 키는 대시보드 에서 즉시 폐기 후 새로 발급받으세요.

Claude.ai 웹 (Connector)

Claude.ai 웹에서는 Settings → Connectors → Add custom connector 에서 같은 정보를 입력해요.

  • Server URL: https://bulliza.com/api/mcp
  • Authentication: Bearer Token
  • Token: rfk_live_<your-key>

연결 확인

Claude 한테 "불리자 health 호출해줘" 라고 물어보면 다음 비슷한 응답이 와요.

text
{
  "ok": true,
  "plan": "free",
  "daily_limit": 1000,
  "rpm_limit": 30,
  "req_count_today": 1,
  "time": "2026-06-15T..."
}