본문 바로가기
M MCP모아
튜토리얼

공시지가 조회 MCP — Claude로 부동산 공시가격 실시간 확인하기

국토교통부 공시지가·공동주택 공시가격 API를 MCP로 Claude에 연결해 실시간 조회하는 방법을 단계별로 설명합니다. 부동산 세금 기준가 확인에 바로 활용하세요.

Claude AI가 국토교통부 공시지가 API에 연결해 부동산 공시가격을 실시간으로 조회하는 흐름을 보여주는 표지 이미지

국토교통부 공시지가·공동주택 공시가격 API를 MCP(Model Context Protocol)로 Claude에 연결하면, 주소 하나만 입력해도 실시간으로 공시가격을 조회하고 세금 기준가를 즉시 확인할 수 있습니다. 2026년 11월 기준으로는 공시가격 조회 도구를 포함한 서버가 MCP모아에 이미 등록돼 있어 직접 만들지 않고도 연결할 수 있습니다. 이 가이드는 API 키 발급부터 Claude 연결, 실제 조회, 자주 발생하는 오류 해결까지 전 과정을 다룹니다.

왜 공시지가 조회에 MCP가 필요한가

부동산을 거래하거나 보유할 때 재산세·종합부동산세·취득세 계산의 기준이 되는 것이 바로 공시지가와 공동주택 공시가격입니다. 국토교통부 공시가격 알리미 사이트(www.realtyprice.kr)를 통해 수동으로 조회할 수 있지만, 여러 물건을 반복 조회하거나 다른 데이터와 조합·분석하려면 한계가 있습니다.

MCP를 사용하면 Claude가 직접 API를 호출해 다음과 같은 작업이 가능합니다.

  • 주소 목록을 한꺼번에 조회해 비교표 생성
  • 연도별 공시가격 추이 분석
  • 재산세 개략 계산 자동화
  • 법령 정보(과세 기준, 감면 요건)와 공시가격을 교차 검색
사용자 (Claude 대화창)
       │
       ▼
  Claude AI
       │  MCP 프로토콜 (stdio / HTTP)
       ▼
공시지가 MCP 서버
       │  HTTP REST
       ▼
공공데이터포털 API
(국토부 공시가격 데이터)

준비물

항목내용
Claude Desktop 또는 Claude CodeMCP 클라이언트 역할
공공데이터포털 회원 가입data.go.kr
공시지가 서비스 API 키포털에서 신청 후 발급 (무료)
Node.js 18 이상 또는 Python 3.10 이상MCP 서버 실행 환경

단계별 연결 방법

1단계 — 공공데이터포털 API 키 발급

  1. data.go.kr에 접속해 로그인합니다.
  2. 검색창에 “공시지가” 또는 “공동주택 공시가격” 을 입력합니다.
  3. 활용 신청 버튼을 클릭하고 서비스 용도를 작성합니다. 개인 학습·분석 목적으로 신청 가능하며 보통 1~2일 내 승인됩니다.
  4. 승인 후 마이페이지 → 개발계정 → 인증키 메뉴에서 일반 인증키를 확인합니다. 인코딩 키와 디코딩 키가 함께 표시됩니다.

설정 파일에는 보통 디코딩 키를 넣어야 오류가 없습니다. 서버가 키를 직접 가공하는지에 따라 다를 수 있으니, 인증 오류가 나면 다른 쪽 키로 바꿔 보세요.

2단계 — 관련 MCP 서버 확인

이 가이드를 처음 쓴 시점에는 공시가격 전용 서버가 없었지만, 2026년 11월 기준 MCP모아에는 공시지가나 공시가격 조회 도구를 포함한 서버가 있습니다. 목적에 따라 아래에서 고르세요. 어느 쪽이든 공시가격 자체는 국토교통부 공시가격 알리미와 대조해 확인하세요.

서버공시가격·공시지가 관련 도구API 키소스 점검
토지이음 토지·도시계획 MCP지목·공시지가 조회, 용도지역·지구단위계획V-World 키 필요안전
국토부 건축HUB MCP공시가격 시계열, 건축물대장·인허가원격은 키 불필요, 로컬은 data.go.kr 키사용 주의
업스테이지 세금 계산 MCP공시가격 조회 후 세액 계산기본 키 불필요안전
한국 법령 MCP공시가격 없음, 지방세법·종부세법 조문법제처 키 필요주의(원격 연결 시)

공시가격 조회가 목적이면 토지이음 서버나 건축HUB 서버를, 세금 계산이 목적이면 업스테이지 세금 계산 서버를, 과세 근거 조문 확인이 목적이면 한국 법령 MCP를 함께 쓰는 식으로 역할을 나누면 됩니다. 건축HUB의 원격 주소는 작성자의 공용 호스트를 거치므로 주소와 질의가 그 서버를 경유하고, 업스테이지 서버의 공시가격 조회 도구는 입력한 주소를 외부(V-World)로 보낸다고 도구 설명에 밝히고 있습니다. 민감한 주소는 로컬 실행 방식을 쓰세요.

직접 연결하기 전에 확인할 점

서버마다 입력 형식이 달라 주소 대신 PNU(필지고유번호)나 법정동 코드를 요구할 수 있습니다. 토지이음 서버는 주소·지번·PNU를 해석하는 도구를 따로 갖고 있어 일반 주소로도 묻기 쉽습니다. 서버 소개 페이지의 도구 목록을 먼저 읽어 보고 질문을 맞추세요.

방법 A: 법령 MCP로 근거 조문 확인하기

한국 법령 MCP는 법제처 42개 API를 MCP 도구로 래핑한 서버입니다. 공시가격 API 자체를 포함하지는 않지만, 부동산 세금 관련 법령(지방세법, 종합부동산세법 등)을 조회하는 데 함께 활용할 수 있습니다.

npx korean-law-mcp setup

방법 B: 공공데이터포털 API를 직접 MCP 서버로 감싸기

위 서버로 해결되지 않는 조건이라면 공시가격 API를 직접 감싸는 서버를 만들 수 있습니다. 아래는 기본 구조의 예시입니다.

# 직접 만드는 MCP 서버 디렉터리 생성
mkdir gosijiga-mcp && cd gosijiga-mcp
npm init -y
npm install @modelcontextprotocol/sdk node-fetch

3단계 — Claude Desktop 설정 파일 편집

Claude Desktop의 MCP 설정 파일은 운영체제에 따라 위치가 다릅니다.

운영체제설정 파일 경로
macOS~/Library/Application Support/Claude/claude_desktop_config.json
Windows%APPDATA%\Claude\claude_desktop_config.json

파일을 열어 아래와 같이 MCP 서버 항목을 추가합니다.

{
  "mcpServers": {
    "korean-law-mcp": {
      "command": "korean-law-mcp",
      "env": {
        "LAW_OC": "여기에_법제처_API_키_입력"
      }
    }
  }
}

공시지가 API를 별도 커스텀 서버로 연결하는 경우 항목을 추가합니다.

{
  "mcpServers": {
    "gosijiga": {
      "command": "node",
      "args": ["/절대경로/gosijiga-mcp/index.js"],
      "env": {
        "DATA_GO_KR_API_KEY": "디코딩된_인증키_입력"
      }
    }
  }
}

설정 파일 저장 후 Claude Desktop을 완전히 종료하고 재시작합니다.

4단계 — 공시지가 조회 요청 실행

Claude 대화창에서 자연어로 조회를 요청합니다.

서울시 강남구 대치동 123 아파트의 2024년도 공동주택 공시가격을 조회해 주세요.

또는 여러 주소를 한꺼번에 비교할 수도 있습니다.

다음 세 주소의 2023년, 2024년 공시가격을 비교 표로 정리해 주세요:
1. 서울시 마포구 합정동 OO아파트 101동 501호
2. 경기도 과천시 부림동 OO아파트 A동 302호
3. 인천시 연수구 송도동 OO타운 B동 1001호

5단계 — 결과 검증 및 활용

반환된 공시가격은 반드시 국토부 공시가격 알리미(www.realtyprice.kr)와 대조해 검증합니다. API 응답과 공식 사이트의 값이 일치하면 정상입니다.

공시가격 활용 예시입니다.

목적활용 방법
재산세 개략 계산공시가격 × 공정시장가액비율 × 세율 (비율과 세율은 주택·토지 유형과 연도에 따라 다름)
종합부동산세 대상 여부 확인보유 주택의 합산 공시가격이 공제 기준을 넘는지 확인 (기준은 1세대 1주택 여부 등에 따라 다름)
취득세 산정 기준 확인취득 원인에 따라 과세 기준이 다르므로 법령 조문으로 확인
임대차 기준 분석전세가율 계산 시 공시가격 참고

흔한 오류와 해결 방법

API 키 오류 (SERVICE_KEY_IS_NOT_REGISTERED_ERROR)

공공데이터포털 인증키를 URL 인코딩된 값 그대로 사용하면 발생합니다. 마이페이지에서 Decoding 키를 복사해 환경변수에 넣으세요.

응답 데이터가 비어 있음 (resultMsg: NORMAL SERVICE / 빈 items)

조회 조건(시도·시군구·읍면동·번지 코드)이 정확하지 않을 때 나타납니다. 행정안전부 도로명주소 API로 법정동 코드를 먼저 조회한 뒤 공시지가 API에 전달하면 해결됩니다.

Claude Desktop 재시작 후 MCP 서버 미인식

설정 파일 경로가 틀리거나 JSON 문법 오류가 있는 경우입니다. 터미널에서 아래 명령으로 JSON 유효성을 확인합니다.

cat ~/Library/Application\ Support/Claude/claude_desktop_config.json | python3 -m json.tool

오류 없이 출력되면 정상입니다. 오류가 있으면 해당 줄을 수정하고 Claude Desktop을 재시작합니다.

법령 정보와 연계 활용

공시가격만으로는 실제 세금을 정확히 계산하기 어렵습니다. 한국 법령 MCP를 함께 연결하면 지방세법·종합부동산세법의 최신 조문을 Claude가 직접 참조해 세율·공정시장가액비율·감면 요건을 확인할 수 있습니다.

참고로 한국 계약서 자동생성 MCP는 근로·프리랜서·외주용역 등 8종 계약서를 지원하며, 매매계약서·임대차계약서는 지원 목록에 없습니다.

법률·세금 카테고리에서 부동산 및 세금 관련 MCP 서버를 더 확인해 보세요.

공시가격 답변은 어디까지 믿을 수 있나요?

공시가격은 세금 기준이 되는 숫자라 작은 오차도 문제가 됩니다. 결과를 받았을 때 점검할 항목을 정리했습니다.

점검 항목이유확인 방법
기준 연도공시는 매년 1월 1일 기준으로 연 1회 고시됨답변에 연도가 명시됐는지 확인
필지·호수 일치같은 단지라도 동·호에 따라 가격이 다름주소와 동·호가 질문과 같은지 확인
경계 필지토지이음 서버는 필지 중심점 기준으로 판정해 경계에 걸린 경우 다를 수 있음경계 사안은 공식 열람으로 별도 확인
값이 없을 때건축HUB 서버는 값이 없으면 NOT_FOUND를 반환하도록 설계됨빈 값을 AI가 추정해 채우지 않았는지 확인

주소 대신 PNU를 쓰라는 이유는 무엇인가요?

PNU(필지고유번호)는 필지마다 붙는 19자리 번호로, 같은 주소 표기가 여러 필지를 가리킬 때 생기는 혼동을 막아 줍니다. 토지이음 서버는 주소와 지번에서 PNU를 찾아 주는 도구를 갖고 있어, 먼저 PNU를 확인한 뒤 용도지역이나 공시지가를 묻는 순서가 가장 정확합니다.

세금 계산은 어디까지 AI에게 맡기나요?

업스테이지 세금 계산 서버는 계산을 AI의 추측이 아니라 코드로 수행하고 결과마다 근거 조문을 붙이며, 연도별 세율표가 없는 해에는 추정하지 않고 멈추도록 만들어져 있습니다. 그래도 이 서버는 세무 자문을 대신하지 않는 참고용 계산 도구라고 스스로 밝히고 있습니다. 신고나 납부에 쓸 금액은 홈택스와 세무 전문가로 최종 확인하세요.

질문은 이렇게 던지세요

공시가격 질문은 지역·단지·호수·연도를 모두 적을수록 정확합니다. 아래는 가상의 예시입니다.

한 필지의 토지 정보를 알고 싶을 때

“경기도 OO시 OO동 123번지의 PNU를 확인하고, 용도지역과 최근 공시지가를 알려 줘. 경계에 걸려 있으면 그 사실도 말해 줘.”처럼 필요한 항목을 나열하면 도구가 여러 번 호출됩니다.

건물 정보와 가격을 함께 보고 싶을 때

“이 주소의 건축물대장 기준 용도와 층별 구성을 알려 주고, 공시가격이 있다면 최근 몇 년 추이를 표로 보여 줘.”라고 요청하면 건축HUB 서버의 건축물대장·시계열 도구를 조합합니다. 건축물대장 자체의 사용법은 건축물대장 MCP 가이드에 있고, 실거래가 조회는 부동산 실거래가 MCP 연동에 정리돼 있습니다.

개인정보와 소유자 정보는 어떻게 되나요?

건축HUB 서버는 소유자 정보 조회가 범위 밖이라고 밝히고 있습니다. 공시가격 조회에서도 특정 개인의 부동산을 추적하려는 질문은 하지 마세요. 조회한 주소와 질문은 서버와 AI 서비스를 거치므로, 공개된 부동산 정보 확인 용도로만 쓰는 것이 안전합니다.

자주 묻는 질문

공시지가와 공시가격은 같은 건가요?

엄밀히 다릅니다. 공시지가는 토지에 대한 단위 면적(㎡)당 가격이고, 공시가격(공동주택 공시가격)은 아파트·연립주택 등 공동주택 전체 호(號)에 대한 가격입니다. 재산세·종합부동산세·취득세 산정의 기준이 되는 가격이라는 공통점은 있습니다.

API 키 없이 공시지가를 조회할 수 있나요?

국토부 공시가격 알리미 웹사이트(www.realtyprice.kr)에서는 로그인 없이 조회할 수 있습니다. 그러나 MCP를 통해 Claude에 자동 연결하려면 공공데이터포털 API 키가 필요합니다.

공시가격 API는 실시간으로 업데이트되나요?

공시지가와 공동주택 공시가격은 매년 1월 1일 기준으로 연 1회 고시됩니다. API는 최신 고시 연도 데이터를 제공하며, 조회 시점이 아닌 고시 기준일 데이터입니다.

공시가격을 세금 계산에 직접 사용할 수 있나요?

공시가격은 재산세·종합부동산세 등의 과세 기준이 됩니다. 단, 실제 세금 계산에는 공정시장가액비율·세율·감면 등 추가 변수가 적용되므로, 정확한 세액은 세무사 또는 국세청 홈택스를 통해 확인하는 것을 권장합니다.

MCP 서버가 공시지가 API를 직접 지원하지 않으면 어떻게 하나요?

MCP모아에는 지목·공시지가를 조회하는 토지이음 MCP, 공시가격 시계열을 제공하는 건축HUB MCP, 공시가격 조회와 세금 계산을 묶은 업스테이지 세금 계산 MCP가 등록돼 있습니다. 조건이 맞지 않으면 공공데이터포털 API를 직접 감싸는 MCP 서버를 만들 수 있습니다.

Claude Code와 Claude Desktop 중 어떤 것을 써야 하나요?

일회성 조회나 대화형 분석은 Claude Desktop이 편리합니다. 반복 조회·스크립트 자동화·CI 통합이 필요하면 Claude Code를 사용하세요. 두 환경 모두 동일한 MCP 설정 방식을 사용합니다.

다음 단계

공시지가 MCP 연동을 마쳤다면 다음 활용을 추천합니다.

공시지가 MCP 서버를 직접 개발하셨다면 MCP모아에 등록해 한국 개발자 커뮤니티와 공유해 주세요.

이 글과 관련된 MCP 서버