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

단지 이름을 말하면 최근 실거래와 대표 시세, 1~24개월 뒤 가격 전망을 확인할 수 있습니다. 로그인이나 API 키 없이 아래 주소로 연결하세요.

MCP 서버 주소 · Streamable HTTP

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

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

Claude Code

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

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

ChatGPT

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

그 밖의 MCP 클라이언트

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

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

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

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

어시스턴트가 상황에 맞게 고르는 도구 19개입니다. 조회 도구 18개와 자료 준비 도구 1개가 있습니다.

전체 도구 19개 보기

search_apartments

이름(초성도 가능)과 시군구로 단지를 찾습니다. 등록된 단지, 수집 중인 단지, 아직 수집하지 않은 단지를 구분해 돌려줍니다.

list_regions

지역명에 맞는 시군구와 코드를 찾아줍니다.

list_region_apartments

시군구에 저장된 공개 단지 목록을 보여줍니다.

rank_region_apartments

최근 12개월 거래 건수나 100세대당 거래 건수로 저장된 단지를 비교합니다. 미수집 단지는 제외합니다.

get_region_trade_trend

시군구의 최근 12개월 월별 거래 건수 추이를 보여줍니다.

get_preparation_status

요청한 단지의 자료 준비 상태를 확인합니다. 새 수집은 시작하지 않습니다.

get_apartment_size_options

저장된 거래에서 확인되는 전용면적과 면적별 거래 수를 보여줍니다.

get_apartment_price_history

선택한 전용면적의 최근 12개월 월별 실거래 중간값을 보여줍니다.

get_apartment_trade_analysis

단지의 최근 거래 활동과 세대수 대비 거래 비율을 알려줍니다.

compare_apartments

단지 2~3곳의 대표 시세와 거래 수를 나란히 비교합니다.

get_market_context

단지가 속한 지역의 시장 참고 지표를 보여줍니다.

get_location_scores

단지의 입지 참고 점수를 보여줍니다.

get_jeonse_summary

최근 매매·전세 거래를 비교한 참고 비율만 보여줍니다. 개별 전세 계약 목록은 실거래 도구에서 조회합니다.

get_apartment_overview

준공연도·세대수, 대표 평형의 대표 시세, 최근 12개월 거래 수와 가격 범위, 최근 거래 10건, 시장 참고 지표와 입지 점수.

get_recent_transactions

저장된 매매·전세 실거래를 구분해 최신순으로 모두 제공합니다. 전용면적을 고를 수 있고, 매매 거래의 해제·분양권 전매와 자료 동기화 중 여부를 표시합니다.

get_forecast

목표 월(이번 달 기준 1~24개월 뒤, 기본 12개월)의 가격 전망. 현재 대표 시세와 모델 예측가, 별도의 중앙 50% 예측 범위(P25~P75), 표본 신뢰도, 기준일을 돌려줍니다.

get_forecast_text

기존 연결을 위한 호환 전망 도구입니다. get_forecast와 같은 계산과 기준을 사용합니다.

get_validation_summary

공개 검증 지표(시계열 분할 R², 변동률 RMSE, 12개월 가격 MAPE)와 최근 주간 검증 결과, 방법 설명 링크.

prepare_apartment

아직 수집하지 않은 단지의 실거래 수집과 입지 분석을 시작합니다. 단지명·지역·주소를 확인한 뒤 요청하며 보통 1~3분 걸립니다.

모든 도구는 수치와 설명을 AI 앱에 전달합니다. AI 앱이 기본 대화 화면에서 전망과 실거래·검색·비교 결과를 설명합니다. 모델 예측가와 별도의 예측 범위, 기준일을 함께 확인하세요.

데이터

홈페이지와 앱이 쓰는 것과 같은 실거래·전망 경로입니다. 같은 단지, 같은 날이면 앱·홈페이지와 같은 숫자가 나옵니다.

단위

금액은 억 원, 면적은 전용면적 ㎡입니다.

현재 대표 시세

대표 평형(보통 84㎡)의 최근 거래를 바탕으로 계산한 현재 기준 가격입니다. 다른 평형을 말하면 그 평형으로 계산합니다.

예측가

목표 월의 모델 예측 가격입니다. 현재 대비 변화율도 이 값을 기준으로 계산합니다.

대표 범위

P25~P75, 즉 시뮬레이션 분포의 가운데 50%입니다. 실제 가격이 반드시 이 범위에 들어간다는 뜻은 아닙니다.

표본 신뢰도

전망에 쓴 실거래 표본이 얼마나 충분한지 나타내는 등급입니다.

기준일

전망을 계산한 날짜입니다. 전망은 하루 단위로 갱신됩니다.

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

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

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

문의·오류 신고

[email protected]