GenAI LabsBizGraph
로그인

MCP

내 AI에 BizGraph 연결하기

Claude · ChatGPT · Cursor · Codex에 BizGraph를 붙이면, 대화 안에서 서울 동네의 가게 수 · 개업 · 폐업 · 생존율 · 임대료를 바로 묻고 출처와 기준일이 붙은 답을 받습니다. 로그인 없이 서버 주소 하나로 연결합니다.

서버 주소

전송 방식 Streamable HTTP · 인증 없음

https://bizgraph.gensapps.com/mcp

모든 도구는 읽기 전용입니다. 무언가를 바꾸거나 저장하지 않습니다. 서울 상권 자료만 다룹니다.

도구별 연결 방법

메뉴 이름은 각 도구의 공식 문서 기준입니다(2026-10-18 확인). 버전에 따라 모양이 다를 수 있습니다.

Claude Code (CLI)

명령 한 줄로 추가합니다.

  1. 터미널에서 아래 명령을 실행합니다. --transport http를 빼면 연결되지 않습니다.
  2. 모든 프로젝트에서 쓰려면 --scope user를 붙입니다. 붙이지 않으면 지금 프로젝트에서만 보입니다.
  3. claude mcp list에서 Connected로 보이면 끝입니다. Claude Code 안에서는 /mcp로 확인합니다.
claude mcp add --transport http --scope user bizgraph https://bizgraph.gensapps.com/mcp

VS Code의 Claude Code 확장

채팅 패널의 /mcp 또는 통합 터미널로 추가합니다.

  1. Claude Code 확장의 채팅 패널에 /mcp를 입력합니다. 서버를 추가하고 켜고 끄는 창이 열립니다.
  2. 서버를 추가하고 주소에 위의 서버 주소를 입력합니다.
  3. 새 대화를 시작한 뒤 /mcp에서 Connected인지 확인합니다. 추가하기 전에 열려 있던 대화에는 적용되지 않습니다.

통합 터미널(Ctrl+`)에서 Claude Code와 같은 명령을 실행해도 됩니다. 확장과 CLI가 같은 설정을 씁니다.

Claude 데스크톱 앱 · claude.ai

사용자 지정 커넥터로 추가합니다.

  1. Customize > Connectors로 이동합니다.
  2. + Add를 누르고 Add custom connector를 선택합니다.
  3. 이름에 BizGraph를 입력하고 서버 주소를 넣은 뒤 Continue를 누릅니다.
  4. Authentication에서 No sign in을 선택하고 Add로 마칩니다.
  5. 채팅 입력창의 + > Connectors에서 BizGraph를 켭니다. 꺼져 있으면 Claude가 BizGraph 도구를 쓰지 않습니다.

무료 요금제는 사용자 지정 커넥터를 1개까지 추가할 수 있습니다.

ChatGPT

웹에서 사용자 지정 MCP 서버로 추가합니다.

  1. 웹에서 chatgpt.com/plugins를 엽니다.
  2. +를 누르고 Add custom MCP server를 선택합니다.
  3. 이름을 입력하고 Server URL에 서버 주소를 입력합니다.
  4. Authentication에서 No authentication을 선택하고, 안내를 읽은 뒤 I understand and want to continue를 선택합니다.
  5. Create as a plugin을 누른 뒤 만든 플러그인을 설치합니다. 설치하지 않으면 대화에서 쓸 수 없습니다.
  6. 새 대화의 입력창에 @를 입력해 방금 만든 플러그인을 선택한 뒤 묻습니다.

요금제와 워크스페이스 설정에 따라 이 메뉴가 보이지 않을 수 있습니다.

Cursor

설정 파일에 주소를 넣습니다.

  1. ~/.cursor/mcp.json 파일을 엽니다. 없으면 새로 만듭니다.
  2. mcpServers 안에 아래 내용을 넣습니다. 이미 있는 다른 서버는 그대로 둡니다.
  3. 저장하고 Cursor를 다시 시작합니다. Customize > MCPs 목록에 보이면 끝입니다.
{
  "mcpServers": {
    "bizgraph": {
      "url": "https://bizgraph.gensapps.com/mcp"
    }
  }
}

Codex

데스크톱 앱 화면이나 명령 한 줄로 추가합니다.

  1. Settings를 열고 MCP servers를 선택합니다.
  2. Add server를 누릅니다.
  3. 이름에 bizgraph를 입력하고 Streamable HTTP를 선택한 뒤 URL에 서버 주소를 입력합니다.
  4. 저장한 뒤 Restart를 누릅니다. 입력창에 /mcp를 입력하면 연결된 서버가 보입니다.

명령으로 추가하려면(Codex CLI) 아래를 실행합니다. 데스크톱 앱 · CLI · IDE 확장이 같은 설정 파일(~/.codex/config.toml)을 씁니다.

codex mcp add bizgraph --url https://bizgraph.gensapps.com/mcp

쓸 수 있는 도구

모두 읽기 전용 · 결과에 출처와 기준일이 붙습니다

  • 서울 지역 찾기 find_area

    행정동 · 구 · 상권 이름을 코드 후보로 바꿉니다. 이름이 애매할 때 씁니다.

  • 동네 가게 요약 area_summary

    한 동네의 영업 중 가게 수와 최근 1년 개업 · 폐업 · 증감. 업종을 고를 수 있습니다.

  • 반경 안 경쟁 가게 competitors

    한 곳을 중심으로 반경 안 같은 업종 가게 수(상가정보 · 최근 1년 개업 · 폐업).

  • 가게 생존율 survival_rate

    개업 후 1 · 3 · 5년을 넘긴 가게의 비율(업종 · 지역별).

  • 상가 임대료 · 공실률 commercial_rent

    한국부동산원 상권의 임대료(천원/㎡)와 공실률(%) · 분기 조사.

연결한 뒤 해 볼 질문

  • “성수동 카페 최근 1년 개업 · 폐업 알려줘”
  • “강남역 반경 500m 치킨집 몇 곳이야?”
  • “망원동 카페 3년 생존율은?”
  • “명동 상가 공실률 어때?”

답에는 자세한 분석으로 가는 BizGraph 화면 링크가 함께 옵니다. 지도는 그 링크에서 봅니다.

한도와 범위

인증
없음 · 누구에게나 같은 공개 통계입니다
한도
IP 하나당 분당 20번 · 무료. 넘으면 연결을 끊지 않고 잠시 뒤 다시 하라는 안내를 돌려줍니다.
범위
서울만 · 서울 밖은 답하지 않습니다
값이 없으면
“—”로 답합니다. 0과 다릅니다

자주 묻는 질문

BizGraph MCP는 로그인이나 토큰이 필요한가요?
필요 없습니다. 서버 주소(https://bizgraph.gensapps.com/mcp)만 등록하면 됩니다. 누구에게나 같은 공개 통계라 인증 없이 엽니다.
얼마나 자주 부를 수 있나요?
IP 하나당 분당 20번입니다. 넘으면 연결을 끊지 않고, 잠시 뒤 다시 하라는 안내를 도구 결과로 돌려줍니다.
서울 밖도 물을 수 있나요?
아닙니다. 서울 상권 자료만 다룹니다. 서울 밖을 물으면 답하지 않고 그렇게 알려 줍니다.

지도와 화면으로 보려면 BizGraph 지도로, 대화로 바로 물으려면 AI에게 질문으로 가세요.