ScoutingAPI — MCP 서버 연결하기
ScoutingAPI는 기본 Model Context Protocol 서버를 제공하여 에이전트가 Airbnb, Booking.com, Vrbo, Google Hotels의 숙소 데이터를 일급 도구로 조회할 수 있게 해줍니다. API 키를 에이전트에 입력할 필요가 없습니다.
- 서버 URL: https://mcp.scoutingapi.com (Streamable HTTP 전송)
- 인증: OAuth 2.1 + PKCE (S256) 방식의 동적 클라이언트 등록. 브라우저 팝업에서 한 번 인증하면 커넥터가 ScoutingAPI 계정 및 크레딧 잔액과 연결됩니다.
- OAuth 보호 리소스 메타데이터 (RFC 9728): https://mcp.scoutingapi.com/.well-known/oauth-protected-resource
연결하기 (Claude.ai / Claude Desktop / Claude Code)
- 에이전트의 커넥터 설정을 열고 사용자 지정 커넥터(MCP 서버)를 추가합니다.
- URL
https://mcp.scoutingapi.com을 입력합니다. - 브라우저 팝업에서 OAuth 프롬프트를 완료합니다. 이렇게 하면 커넥터가 ScoutingAPI 계정에 연결됩니다. (처음 사용자는 계정을 만들고 이메일을 인증해야 합니다. 샌드박스 계정은 평가 용도로 사용할 수 있습니다. 자세한 내용은 https://scoutingapi.com/docs/mcp를 참조하세요.)
- 아래 7가지 도구를 에이전트가 사용할 수 있게 됩니다.
7가지 읽기 전용 도구
search_stays— 위치, 날짜, 인원, 필터를 기준으로 여러 플랫폼의 숙소를 검색합니다.check_availability— 알려진 숙소의 특정 기간 동안 일별 가용성을 확인합니다.get_listing— 하나의 숙소에 대한 전체 상세 정보(편의시설, 사진, 호스트, 평점)를 가져옵니다.get_price— 하나의 숙소에 대해 특정 날짜와 인원에 대한 실제 가격 견적을 반환합니다.compare_prices— 하나의 숙소를 여러 OTA에서 비교하고 계산된 최소 가격과 중간값을 제공합니다.get_reviews— 하나의 플랫폼에 등록된 하나의 숙소에 대한 정규화된 리뷰를 페이지 단위로 조회합니다.get_job— 비동기 스크래핑 작업의 상태를 폴링하고 결과를 가져옵니다(비용 없음).
비동기 동작
이 도구들은 REST와 동일한 비동기 계약을 공유합니다: 실시간 호출로 스크래핑이 필요한 경우 대기 중인 작업을 반환하며, 에이전트(또는 도구 계층)는 반환된 jobId로 get_job을 폴링하여 작업이 완료되면 data.result 아래에 결과 페이로드가 도착합니다. 샌드박스 및 캐시 적중 시에는 즉시 결과를 반환합니다.
크레딧 및 제한
MCP 호출은 REST 키와 동일한 단일 크레딧 잔액을 사용하지만, 별도의 사용자별 버킷에서 속도 제한이 적용됩니다. 비용 및 속도 제한: https://scoutingapi.com/pricing.
MCP vs REST — 어떤 것을 사용할까요?
- MCP — 커넥터를 지원하는 대화형 에이전트/어시스턴트(예: Claude)에 가장 적합합니다. 키 관리 대신 OAuth를 사용하며, 도구가 모델에 기본적으로 표시됩니다.
- REST (스킬: scoutingapi-search) — 프로그래밍 방식의 백엔드, 서버, 크론 작업, MCP를 지원하지 않는 모든 런타임에 가장 적합합니다. Bearer 키와
@scoutingapi/sdk를 사용합니다.
둘 다 동일한 데이터와 통합 스키마를 사용합니다. 문서: https://scoutingapi.com/docs/mcp.