건축물대장 MCP 서버 — 부동산 공공 API를 Claude에 연결하는 방법

건축물대장 MCP 서버를 사용하면 공공데이터포털(data.go.kr)의 건축물대장 API를 Claude 같은 AI 어시스턴트에 직접 연결할 수 있습니다. 주소 하나만 입력하면 AI가 건물의 면적, 용도, 층수, 건축연도 등 부동산 공공 정보를 즉시 조회해 분석·요약까지 해줍니다. 이 가이드에서는 API 키 발급부터 Claude Desktop 등록, 실전 사용, 흔한 오류 해결까지 한 번에 안내합니다.

건축물대장 MCP가 필요한 이유

부동산 투자나 계약 전에 건물 정보를 확인하는 과정은 번거롭습니다. 세움터(건축행정시스템)나 국토교통부 포털에 접속해 주소를 입력하고, 여러 탭을 오가며 데이터를 복사·붙여넣기해야 합니다. 여러 건물을 비교하거나 반복 조회가 필요할 때는 더욱 그렇습니다.

MCP(Model Context Protocol)를 활용하면 이 과정이 단순해집니다. AI가 직접 공공 API를 호출하고, 결과를 정리해 대화형으로 제공합니다. 중개업소 확인, 인허가 검토, 부동산 분석 보고서 작성 등 다양한 업무에 바로 적용할 수 있습니다.

사용자 ──▶ Claude Desktop ──▶ 건축물대장 MCP 서버 ──▶ data.go.kr API
                 ◀──────────────────────────────────────────────────
                   건물명 / 면적 / 용도 / 층수 / 건축연도 등 반환

준비물

시작하기 전에 다음 항목을 준비하세요.

항목	필요 여부	비고
공공데이터포털 계정	필수	data.go.kr 가입
건축물대장 API 키	필수	활용 신청 후 발급
Node.js 18 이상 또는 Python 3.10 이상	필수	서버 런타임
Claude Desktop	권장	MCP 클라이언트
Git	필수	저장소 클론

단계별 설치 및 설정

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

data.go.kr에 로그인한 뒤, 검색창에 “건축물대장” 을 입력합니다. 검색 결과에서 국토교통부가 제공하는 건축물대장 정보 서비스를 찾아 활용 신청 버튼을 클릭하세요. 신청 양식에 활용 목적을 간략히 적고 제출하면 됩니다. 일반 서비스는 보통 1~2 영업일 내에 승인됩니다.

승인 완료 이메일을 받으면 마이페이지의 내 오픈 API 메뉴에서 발급된 서비스 키를 확인할 수 있습니다. 이 키는 이후 환경 변수 설정에 사용됩니다.

2단계 — MCP 서버 저장소 클론 및 설치

현재 공개된 건축물대장 전용 MCP 서버 중 하나를 클론합니다. 아래는 일반적인 설치 절차입니다(서버 저장소의 README를 우선 확인하세요).

git clone https://github.com/Koomook/data-go-mcp-servers
cd data-go-mcp-servers

Node.js 기반 서버라면 다음과 같이 의존성을 설치합니다.

npm install

Python 기반 서버라면 uv를 사용합니다.

uv sync

공공데이터포털 MCP 서버 모음처럼 uvx 명령을 지원하는 경우에는 별도 클론 없이 바로 실행할 수도 있습니다.

uvx data-go-mcp.nps-business-enrollment@latest

3단계 — 환경 변수 설정

서버 루트 디렉터리에 .env 파일을 생성하고, 1단계에서 발급받은 API 키를 입력합니다.

# .env
SERVICE_KEY=여기에_발급받은_API_키를_붙여넣기

키 값 앞뒤에 공백이 없도록 주의하세요. 공공데이터포털 API 키는 URL 인코딩된 형태로 제공되는 경우가 있습니다. 서버 설정에 따라 디코딩된 값을 사용해야 할 수도 있으니, 저장소의 README 예시를 함께 참고하세요.

4단계 — Claude Desktop 설정 파일에 서버 등록

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

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

파일을 열고 mcpServers 섹션에 다음과 같이 서버 설정을 추가합니다. Node.js 서버 기준 예시입니다.

{
  "mcpServers": {
    "korea-building-register": {
      "command": "node",
      "args": ["/절대경로/data-go-mcp-servers/index.js"],
      "env": {
        "SERVICE_KEY": "여기에_발급받은_API_키"
      }
    }
  }
}

Python 기반 서버라면 command를 python 또는 uv 로 변경하고, args에 실행 스크립트 경로를 맞게 지정하세요. 경로는 반드시 절대 경로를 사용해야 합니다.

5단계 — Claude 재시작 및 동작 확인

설정 파일을 저장한 뒤 Claude Desktop을 완전히 종료하고 다시 실행합니다. 새 대화창에서 다음과 같이 입력해 동작을 확인하세요.

서울시 강남구 테헤란로 427의 건축물대장 정보를 조회해줘.

Claude가 MCP 서버를 통해 공공 API를 호출하고, 건물의 기본 정보를 정리해 반환하면 설정이 완료된 것입니다.

활용 예시

건축물대장 MCP 서버를 연결하면 다음과 같은 작업을 AI와 대화하듯 처리할 수 있습니다.

특정 주소의 건물 용도·면적·층수를 즉시 확인
여러 건물을 한 번에 비교 분석 (임대 후보 물건 검토 등)
건물 정보를 포함한 부동산 리포트 자동 작성
계약 전 건축물 현황 사전 점검

한국 부동산 MCP와 함께 사용하면 건축물 기본 정보와 실거래가 데이터를 동시에 조회해 더 풍부한 분석이 가능합니다.

흔한 오류와 해결 방법

”SERVICE_NEED_AGREE_AND_OLD_SERVICE_TERMS” 오류

API 활용 신청이 아직 승인되지 않았거나, 약관 동의가 누락된 경우 발생합니다. 공공데이터포털 마이페이지에서 신청 상태를 확인하고, 약관 동의 여부도 함께 점검하세요.

연결 타임아웃 또는 빈 응답

API 키가 맞더라도 서버 IP가 차단됐거나, 일일 호출 제한을 초과한 경우 응답이 오지 않을 수 있습니다. 공공데이터포털의 마이페이지에서 API 사용 현황을 확인하세요.

MCP 서버가 Claude에 표시되지 않음

claude_desktop_config.json 파일의 JSON 형식이 유효한지 확인하세요. 쉼표 누락, 따옴표 불일치 같은 사소한 오타도 서버 로드를 막습니다. JSON 검증 도구를 활용하면 빠르게 문제를 찾을 수 있습니다.

경로 오류

args에 상대 경로를 사용하면 Claude Desktop이 파일을 찾지 못할 수 있습니다. 반드시 /Users/your-name/... 형태의 절대 경로를 사용하세요.

서비스	제공 정보	연계 방법
한국 부동산 MCP	아파트·오피스텔 실거래가, 청약 데이터	별도 MCP 서버 등록
공공데이터포털 MCP 서버 모음	data.go.kr 다양한 API	uvx로 즉시 실행
부동산 공공데이터 카테고리	기타 공공데이터 MCP 서버 목록	MCP모아 탐색

자주 묻는 질문

건축물대장 MCP 서버를 사용하려면 API 키가 꼭 필요한가요?

네, 공공데이터포털(data.go.kr)에서 건축물대장 정보 서비스 활용 신청을 완료하고 API 키를 발급받아야 합니다. 회원가입 후 즉시 신청 가능하며, 일반 서비스는 보통 1~2 영업일 내에 승인됩니다.

건축물대장 API는 무료인가요?

공공데이터포털을 통해 제공되는 건축물대장 정보 서비스는 기본적으로 무료로 활용 신청할 수 있습니다. 단, 일일 호출 횟수 제한이 있으므로 대량 조회가 필요한 경우 공식 정책을 확인하시기 바랍니다.

Claude Desktop 외에 다른 MCP 클라이언트에서도 사용할 수 있나요?

네, MCP 프로토콜을 지원하는 Cursor, Windsurf 등 다른 AI 클라이언트에서도 동일한 방식으로 설정 파일에 서버를 등록해 사용할 수 있습니다.

API 키가 맞는데도 인증 오류가 발생합니다. 어떻게 해야 하나요?

활용 신청 후 승인까지 시간이 걸릴 수 있습니다. 승인 완료 이메일을 받은 후 다시 시도해 보세요. 또한 API 키를 .env 파일에 저장할 때 앞뒤 공백이 없는지 확인하고, 인코딩된 특수문자가 포함된 경우 URL 디코딩 여부도 확인하세요.

조회할 수 있는 건축물 정보 항목에는 어떤 것이 있나요?

일반적으로 건물명, 주소, 대지면적, 연면적, 층수, 용도, 건축연도, 구조, 지붕 형태 등의 정보를 조회할 수 있습니다. 세부 항목은 연결하는 API 엔드포인트에 따라 다릅니다.

MCP 서버 실행 중 연결이 끊어지는 현상이 반복됩니다.

stdio 방식의 MCP 서버는 Claude Desktop과 같은 프로세스 생명주기를 공유합니다. 서버 로그를 확인해 오류 원인을 파악하고, Node.js 또는 Python 런타임 버전이 서버 요구 사양을 충족하는지 점검하세요.

다음 단계

건축물대장 MCP 서버 설정을 마쳤다면, 이제 AI가 부동산 공공 정보를 직접 조회하는 환경이 갖춰진 셈입니다. 더 나아가 한국 부동산 MCP로 실거래가 데이터를 추가 연결하거나, 공공데이터포털 MCP 서버 모음을 통해 사업자 정보, 조달청 데이터 등 다양한 공공 API를 한 번에 활용해 보세요. MCP모아의 서버 목록에서 더 많은 한국 MCP 서버를 찾아볼 수 있습니다.