roomesto.com
가이드

AI 어시스턴트에 Roomesto 호텔 검색 연결

roomesto.com은 공개 MCP 서버를 운영합니다. 한 번 연결하면 Claude Desktop, Cursor 또는 기타 MCP 클라이언트가 일반 대화에서 실시간 호텔 가격과 예약 가능 여부를 찾아드립니다.

요청 한도

  • 등록 없이 — IP 주소당 하루 최대 10회 요청.
  • 개인 키 사용 시 (무료, 등록 사용자용) — 하루 최대 100회 요청.
  • 카운터는 UTC 자정에 리셋됩니다.

1개인 키 받기

등록 또는 로그인 후 계정 페이지를 열면 'MCP 액세스' 섹션에 키가 준비되어 있습니다: 내 계정 열기 →

2서버 주소

MCP 클라이언트에 원격 HTTP 서버로 이 URL을 추가하세요:

https://roomesto.com/mcp

3서버를 구성에 추가

Claude Desktop / Cursor (mcp.json / claude_desktop_config.json):

{
  "mcpServers": {
    "roomesto": {
      "url": "https://roomesto.com/mcp",
      "headers": { "Authorization": "Bearer rms_YOUR_KEY" }
    }
  }
}

또는 터미널에서 한 줄 (Claude Code):

claude mcp add --transport http roomesto https://roomesto.com/mcp --header "Authorization: Bearer rms_YOUR_KEY"

요청할 수 있는 예시

  • “로마 트레비 분수 근처 호텔, 9월 12–15일, 1박 €150 이하”
  • “안탈리아 키즈 클럽과 올인클루시브 식사가 있는 가족 호텔”
  • “이스탄불 시내 4성급 호텔 주말 숙박 비교”
  • “소치에서 7월에 2인용 가장 저렴한 해변 호텔”

MCP로 예약하기

등록된 여행자는 같은 MCP 연결로 예약을 마칠 수 있습니다. 도구는 단계별로 진행되므로 예약이나 결제 전에 최종 가격과 조건을 확인할 수 있습니다.

  1. search_hotels는 실시간 상품을 찾고, get_hotel_rates는 객실, 결제 수단, 세금, 공급업체가 제공한 취소 조건을 반환합니다.
  2. prepare_booking은 선택한 요금을 다시 확인하고 모든 투숙객 정보를 받습니다. 요청을 다시 보낼 때는 같은 request_id를 사용하세요.
  3. tokenize_booking_card는 선택한 요금에 카드가 필요할 때만 사용합니다. 카드 번호와 CVC는 기존 결제 처리 업체로 전송되며 MCP 서버에는 저장되지 않습니다.
  4. confirm_booking은 정확한 총액과 통화에 대한 여행자의 명시적 확인을 요구합니다. 이후 get_booking_status가 확인이나 은행 검증을 추적하고, cancel_booking은 같은 키로 만든 예약의 취소를 요청합니다.

문제 발생 시

  • 429 “일일 무료 한도 도달” — 일일 할당량을 모두 사용했습니다. UTC 자정에 리셋되며, 개인 키를 등록하면 하루 100회 요청이 가능합니다.
  • 401 “알 수 없는 API 키” — rms_로 시작하는 전체 키가 공백 없이 복사되었는지 확인하세요.

AI 에이전트 및 크롤러용: llms.txt