숙소나루(stay-mcp) 사용 안내

버전 0.5.3 · 이 페이지의 도구 목록은 서버의 tools/list에서 그대로 만들어집니다.

무엇인가

숙소나루는 국내 숙소를 찾는 MCP(Model Context Protocol) 서버입니다. Claude 같은 AI 도구에 연결하면 지역·종류 조건으로 숙소를 찾고, 숙소 하나의 등록 정보를 확인하고, 원본 플랫폼의 검색 페이지로 가는 링크를 받을 수 있습니다.

데이터는 행정안전부 인허가 원장 4종(숙박업·농어촌민박업·외국인관광도시민박업·한옥체험업)의 영업 중인 82,349건과 한국관광공사 TourAPI 관광 숙박 2,962건을 합친 인덱스입니다. 폐업·휴업·취소·말소·정지된 곳은 뺐습니다. 인증 없이 무료로 쓸 수 있습니다.

연결하는 법

MCP 엔드포인트: https://api.naru.build/stay-mcp (Streamable HTTP, 인증 없음). https://stay.sallim.app/mcp도 같은 서버로 연결됩니다.

claude.ai에서 커스텀 커넥터로 추가하는 순서:

claude.ai에서 설정 → 커넥터로 갑니다.
커스텀 커넥터 추가를 누릅니다.
이름은 원하는 대로(예: 숙소나루), URL에 https://api.naru.build/stay-mcp를 넣고 추가합니다. OAuth 설정은 비워 둡니다.
대화창의 도구 메뉴에서 커넥터를 켠 뒤 "강릉 경포 근처 한옥체험업 숙소 찾아줘"처럼 물어보면 됩니다.

Claude Desktop·Claude Code 등 다른 MCP 클라이언트에서도 같은 URL을 원격(HTTP) 서버로 등록하면 됩니다. Claude Code는 한 줄입니다:

claude mcp add --transport http stay-mcp https://api.naru.build/stay-mcp

도구

이름	제목	종류	하는 일
`stay_search`	숙소 검색	조회	조건에 맞는 국내 숙소를 찾는다.
`stay_detail`	숙소 상세	조회	숙소 하나의 상세 정보(이름·주소·좌표·종류·원장 출처)를 조회한다. 재고는 조회하지 못한다 — 이 서버에 붙은 재고 채널이 0개라 날짜·인원을 줘도 availability는 항상 unknown이다(사유는 unavailable_reason에 실린다). 만실도 빈방 있음도 아니다. 빈방·요금은 stay_booking_link로 원본 검색 링크를 받아 직접 확인하라.
`stay_booking_link`	예약 페이지 링크	조회	원본 플랫폼(네이버·구글·관광공사)의 검색 결과로 가는 링크를 만든다.
`report_issue`	답변 오류 신고	쓰기(신고 기록)	사용자가 답변 오류 제보나 개선 요청을 전해 달라고 했을 때만 운영자에게 전달한다.

report_issue는 사용자가 답변 오류 신고나 개선 요청을 전해 달라고 했을 때만 쓰이며, 그 밖의 도구는 데이터를 바꾸지 않습니다.

한계 — 이 서버가 모르는 것

아래 내용은 AI 클라이언트에게도 서버 지시문으로 똑같이 전달됩니다. 응답에 없는 값은 없는 것이며, 추측으로 채우지 않습니다.

요금: 요금 데이터는 없습니다. 인덱스에 가격 칼럼이 없고 재고 채널도 0개라, 1박 요금은 어떤 응답에도 실리지 않습니다. 금액은 원본 페이지에서 확인하셔야 합니다.
빈방(재고): 빈방 여부(availability)는 지금 항상 unknown입니다. 이 서버에 연결된 재고 채널이 0개라서, 만실인지 빈방이 있는지 알 수 없습니다. stay_booking_link로 원본 검색 링크를 받아 직접 확인하셔야 합니다.
숙소 종류(kind): 원천 데이터가 준 라벨을 그대로 씁니다. 고쳐 부르지 않으므로 '모텔'로 분류된 곳의 이름이 '○○호텔'일 수 있습니다.
'펜션'·'게스트하우스': 법적 업종명이 아니라 마케팅 용어입니다. 법에서는 숙박업(여관·모텔·호텔)·농어촌민박업(펜션·시골독채)·외국인관광도시민박업(게스트하우스)·한옥체험업으로 나뉩니다. 그래서 '펜션'을 찾으면 kind가 '농어촌민박업'으로 나올 수 있습니다.
빠진 숙소: 미등록·무허가 숙소와 야놀자·에어비앤비 등 플랫폼에만 올라온 매물은 인덱스에 없습니다. 검색 결과에 없다고 해서 그 지역에 숙소가 없다는 뜻은 아닙니다.

개인정보·약관

개인정보처리방침 · 이용약관

기계용 상태 정보(JSON)는 루트 https://stay.sallim.app/를 브라우저가 아닌 클라이언트로(Accept: application/json 또는 헤더 없이) 요청하면 받을 수 있습니다. 이 안내 페이지(/docs)는 언제나 HTML입니다. 헬스 체크는 /stay-mcp/health입니다.

이 안내 페이지는 쿠키 없는 익명 방문 통계(페이지 열람·복사 버튼 클릭 수)를 셉니다. 개인정보처리방침 페이지에는 어떤 통계 스크립트도 없습니다.