M MCP모아
튜토리얼

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

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

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

국토교통부 공시지가·공동주택 공시가격 API를 MCP(Model Context Protocol)로 Claude에 연결하면, 주소 하나만 입력해도 실시간으로 공시가격을 조회하고 세금 기준가를 즉시 확인할 수 있습니다. 공공데이터포털 API 키와 MCP 설정 파일 편집만으로 5분 안에 연동이 완료됩니다. 이 가이드는 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. 승인 후 마이페이지 → 개발계정 → 인증키 메뉴에서 일반 인증키(Encoding 키) 를 복사합니다.

공공데이터포털 API 키는 URL 인코딩된 형태로 제공됩니다. 설정 파일에 넣을 때 URL 디코딩된 값(Decoding 키)을 사용해야 오류가 없습니다.

2단계 — 관련 MCP 서버 확인

현재 공시지가 API만 전용으로 래핑한 공개 MCP 서버는 공식적으로 별도 제공되지 않습니다. 실용적인 접근법은 두 가지입니다.

방법 A: 법령·부동산 MCP 서버 활용 후 Custom Tool 추가

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

npx korean-law-mcp setup

방법 B: 공공데이터포털 API를 직접 MCP Custom Server로 래핑

Claude Code의 MCP Custom Server 기능을 활용해 공시가격 API를 직접 연결합니다. 아래는 기본 구조의 예시입니다.

# Claude Code 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": "npx",
      "args": ["korean-law-mcp"],
      "env": {
        "LAW_API_KEY": "여기에_법제처_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 응답과 공식 사이트의 값이 일치하면 정상입니다.

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

목적활용 방법
재산세 개략 계산공시가격 × 공정시장가액비율(60%) × 세율
종합부동산세 대상 여부 확인주택 합산 공시가격 9억 원 초과 여부
취득세 산정 기준 확인실거래가와 공시가격 중 높은 쪽이 기준
임대차 기준 분석전세가율 계산 시 공시가격 참고

흔한 오류와 해결 방법

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를 활용하면 공시가격 조회 결과를 바탕으로 매매계약서·임대차계약서의 특약 사항을 자동으로 초안 작성하는 것도 가능합니다.

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

자주 묻는 질문

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

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

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

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

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

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

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

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

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

현재 공시지가 API를 전용으로 래핑한 공개 MCP 서버는 많지 않습니다. 이 가이드에서 안내한 방법처럼 공공데이터포털 API를 직접 커스텀 MCP 서버로 연결하거나, 법령·부동산 관련 MCP 서버와 조합해 활용하는 것이 현실적인 방법입니다.

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

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

다음 단계

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

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

이 글과 관련된 MCP 서버