Claude·ChatGPT에서 쓰는 아파트 실거래·전망 (MCP)

무엇을 할 수 있나

아파트 인사이트는 Claude, ChatGPT, Claude Code 같은 AI 어시스턴트가 바로 부를 수 있는 공개 MCP(Model Context Protocol) 서버를 제공합니다. 대화 중에 단지 이름을 말하면 어시스턴트가 이 서버에서 국토교통부 실거래가 공개자료 기반의 최근 거래와 대표 시세, 그리고 1~24개월 뒤 원하는 달의 가격 전망 범위를 가져와 답합니다. 로그인이나 API 키는 필요 없습니다.

주소: https://mcp.apt-insights.com/mcp (Streamable HTTP)
인증: 없음. 누구나 연결할 수 있으며 계정과 연결되지 않습니다.
데이터: 홈페이지와 앱이 쓰는 것과 같은 실거래·전망 경로입니다. 같은 단지, 같은 날이면 앱·홈페이지와 같은 숫자가 나옵니다.
단위: 금액은 억 원, 면적은 전용면적 ㎡입니다.

연결 방법

2.1 Claude (웹·데스크톱·모바일)

설정 → 커넥터 → 사용자 지정 커넥터 추가에서 이름(예: 아파트 인사이트)과 위 주소를 넣고 저장합니다. 인증 항목은 비워 둡니다. 커넥터 디렉터리 등록은 진행 중이며, 등록되면 디렉터리에서 한 번에 추가할 수 있습니다.

2.2 Claude Code

터미널에서 한 줄로 추가합니다.

claude mcp add --transport http apt-insights https://mcp.apt-insights.com/mcp

2.3 ChatGPT

ChatGPT 앱 디렉터리 등록을 준비 중입니다(한국 사용자 대상). 그 전에는 설정 → 앱 및 커넥터 → 고급 → 개발자 모드에서 위 주소를 가진 커넥터를 만들어 연결할 수 있습니다.

2.4 그 밖의 MCP 클라이언트

설정 파일을 쓰는 클라이언트라면 다음처럼 적습니다.

{
  "mcpServers": {
    "apt-insights": { "type": "http", "url": "https://mcp.apt-insights.com/mcp" }
  }
}

제공 도구

어시스턴트가 상황에 맞게 고르는 도구 여섯 개입니다. 자료 준비 하나를 빼면 모두 읽기 전용입니다.

도구	하는 일
`search_apartments`	이름(초성도 가능)과 시군구로 단지를 찾습니다. 등록된 단지, 수집 중인 단지, 아직 수집하지 않은 단지를 구분해 돌려줍니다.
`get_apartment_overview`	준공연도·세대수, 대표 평형의 대표 시세, 최근 12개월 거래 수와 가격 범위, 최근 거래 10건, 시장 참고 지표와 입지 점수.
`get_recent_transactions`	최근 실거래를 최신순으로 최대 30건. 전용면적을 고를 수 있고 해제된 거래와 분양권 전매를 표시합니다.
`get_forecast`	목표 월(이번 달 기준 1~24개월 뒤, 기본 12개월)의 가격 전망. 현재 대표 시세와 중앙값, 대표 범위(P25~P75)와 넓은 범위(P10~P90), 표본 신뢰도, 기준일을 돌려줍니다.
`get_validation_summary`	공개 검증 지표(시계열 분할 R², 변동률 RMSE, 12개월 가격 MAPE)와 최근 주간 검증 결과, 방법 설명 링크.
`prepare_apartment`	아직 수집하지 않은 단지의 실거래 수집과 입지 분석을 시작합니다. 사용자가 그 단지가 맞다고 확인한 뒤에만 호출하며 보통 1~3분 걸립니다.

Claude와 ChatGPT에서는 현재 시세와 전망 중앙값·예상 범위를 카드로 확인할 수 있습니다. 넓은 범위와 모델 정보는 카드의 ‘자세히’에서 확인하며, 추가 조회나 로그인은 필요하지 않습니다.

이렇게 물어보세요

서초구 래미안원베일리 84㎡ 1년 뒤 가격 전망 알려줘
고양시 덕양구 삼송2차아이파크 최근 실거래 10건 보여줘
잠실엘스 2028년 3월 기준으로 전망하면 어때?
이 단지 현재 대표 시세랑 최근 1년 거래 범위는?
이 예측 모델은 어떻게 검증됐어?

단지 이름이 여러 지역에 있으면 어시스턴트가 지역을 되묻습니다. 시군구 이름을 함께 말하면 한 번에 찾습니다.

전망 결과 읽는 법

현재 대표 시세: 대표 평형(보통 84㎡)의 최근 거래를 바탕으로 계산한 현재 기준 가격입니다. 다른 평형을 말하면 그 평형으로 계산합니다.
중앙값: 목표 월의 전망 가격 중 가운데 값과 현재 대비 변화율입니다.
대표 범위: P25~P75, 즉 전망 분포의 가운데 50%입니다. 결과를 한 줄로 말할 때는 이 범위를 씁니다.
넓은 범위: P10~P90. 목표 시점이 멀수록 두 범위 모두 넓어집니다.
표본 신뢰도: 전망에 쓴 실거래 표본이 얼마나 충분한지 나타내는 등급입니다.
기준일: 전망을 계산한 날짜입니다. 전망은 하루 단위로 갱신됩니다.

전망은 기술 백서의 가격 예측 모델이 계산하며, 검증 요약 도구의 지표는 별도 검증 경로 기준입니다. 자세한 해석은 가격 예측 가이드와 검증 방법 가이드를 참고하세요.

한계와 고지

전망은 공개 데이터와 통계 모델로 계산한 참고용 추정값입니다. 투자 권유·투자 자문·매수·매도 추천이 아니며, 실제 가격·거래 가능성·수익을 보장하지 않습니다. 최종 판단과 책임은 이용자에게 있습니다.

이미 수집한 단지만 바로 답합니다. 아직 수집하지 않은 단지는 사용자가 확인한 뒤 자료 준비를 시작하며, 준비가 끝나면 다시 물어볼 수 있습니다.
거래가 너무 적어 비교 단지에 기대야 하거나 계산된 변화율이 서비스 안전 범위를 벗어나면 숫자 대신 그 이유를 돌려줍니다.
호출 한도가 있습니다(도구별 분당 300회, 연결당 분당 60회). 한도를 넘으면 잠시 뒤 다시 시도하라는 응답이 옵니다.
실거래는 국토교통부 실거래가 공개자료 기준이며 신고·해제 반영에 시차가 있을 수 있습니다.
운영상 필요하면 서버를 잠시 닫을 수 있습니다. 그동안은 "지금은 이용할 수 없습니다"로 답합니다.

개인정보와 기록

MCP 서버는 대화 내용, 계정 정보, 프롬프트 원문을 받지도 저장하지도 않습니다. 어시스턴트가 보낸 도구 이름과 입력값(단지 ID, 지역, 목표 월 등)으로 응답을 만들고, 운영을 위해 날짜·도구·결과 종류별 건수만 집계합니다. 호출 주소(IP)는 분당 한도 계산에만 쓰고 저장하지 않습니다. 자세한 내용은 개인정보처리방침과 이용약관의 MCP 절을 참고하세요.

문의·오류 신고: [email protected]

AI 어시스턴트에서 쓰기 (MCP)