AI 및 MCP · Luma Concierge 가이드

MCP를 사용한 AI 어시스턴트란 무엇인가

MCP는 외부 AI 어시스턴트를 Luma Concierge에 연결합니다. 오너와 매니저는 호텔 운영에 대해 질문하고 시스템의 현재 데이터를 기반으로 답변을 받을 수 있습니다. 이는 팀을 위한 별도의 연결이며, 게스트가 앱을 사용하는 데에는 필요하지 않습니다.

서버는 읽기 전용으로 작동합니다. AI는 실행 계획을 제안할 수 있지만, 담당자 지정, 상태 변경, 게스트 메시지 전송 및 결제 관련 작업은 Luma 인터페이스에서 수행됩니다.

어떤 데이터를 사용할 수 있는가

도구	AI가 받는 것	질문 예시
`get_operational_overview`	상태별 미완료 요청 수, 기한 초과 요청 및 활성 숙박	«교대 시작을 위한 간단한 요약을 준비해줘»
`list_open_requests`	최근 미완료 요청: 객실 번호, 제목, 상태, 우선순위, 담당자 및 날짜	«새 요청을 보여주고 처리 순서를 제안해줘»
`list_active_stays`	활성 숙박: 객실 번호 및 체크인·체크아웃 날짜	«활성 숙박 중 예정된 체크아웃은 무엇인가요?»
`list_service_catalog`	활성 서비스, 가격, 통화, 결제 방법, 이용 가능 시간 및 예약 규칙	«어떤 서비스를 이용할 수 있고 가격은 얼마인가요?»

목록은 기본적으로 최대 20개의 레코드를 반환하며, limit 매개변수는 1에서 50까지 설정합니다. 페이지네이션은 없습니다: 50개의 레코드 목록이 보고서의 완전성을 보장하지 않습니다. 요청은 최신순에서 오래된순으로 정렬되며, 숙박은 체크아웃 시간순으로 정렬됩니다. 전체 수를 확인하려면 요약을 사용하세요.

요청에는 status 필터가 있습니다: new, accepted, in_progress, waiting_guest, ready. 완료 및 취소된 요청은 미완료 목록에 포함되지 않습니다. 카탈로그는 영어로 된 이름과 설명을 반환하며, 어시스턴트가 답변을 번역할 수 있습니다. 가격은 price_minor에 저장됩니다: IDR의 경우 표시 금액이며, 기타 지원 통화의 경우 통화의 100분의 1 단위입니다.

연결 방법

오너 계정에 로그인하여 관리 메뉴에서 «AI 및 MCP»를 엽니다. 연결 이름을 입력하고 «토큰 생성»을 클릭합니다. 발급된 토큰을 복사하세요: 생성 후 이 페이지에서만 표시됩니다. 매니저는 호텔 오너로부터 토큰을 받습니다.
호환되는 AI 클라이언트 설정에서 HTTP 및 인증 헤더를 지원하는 원격 MCP 서버를 추가합니다.
주소 https://lalo.craabchee.com/mcp와 발급된 토큰으로 Bearer 인증을 지정합니다. 클라이언트는 각 요청마다 Authorization: Bearer <MCP_TOKEN> 헤더를 전송해야 합니다. 여기서 <MCP_TOKEN>은 표기이며 실제 키가 아닙니다.
연결을 저장하고 클라이언트가 위 표의 네 가지 도구를 인식하는지 확인합니다.
호텔 요약을 요청합니다. 결과를 계정의 현재 데이터와 비교하고 generated_at 시간을 확인합니다.

프로토콜 2025-11-25, JSON-RPC 2.0 및 POST 요청에 대한 JSON 응답이 지원됩니다. GET/SSE 스트림은 제공되지 않습니다. OAuth 로그인은 구현되지 않았습니다: OAuth가 반드시 필요한 클라이언트는 이 방법으로 연결할 수 없습니다. 구체적인 필드 이름은 AI 클라이언트에 따라 다릅니다.

팀을 위한 요청 예시

오너: «MCP를 통해 최신 요약을 받아주세요. 상태별 미완료 요청, 기한 초과 및 활성 숙박 수를 보여주세요. 팀을 위한 세 가지 우선순위를 제안해주세요. 데이터 시간과 샘플링 제한을 명시해주세요».

매니저: «list_open_requests를 status: new로 사용하여 최대 50개의 새 요청을 받아주세요. 우선순위별로 그룹화하고 담당자가 없는 요청을 표시하며 처리 순서를 제안해주세요. 아무것도 변경하지 마세요».

체크아웃 준비: «최대 50개의 활성 숙박을 받아주세요. 객실 번호와 시간이 포함된 가장 가까운 체크아웃을 강조해주세요. 게스트의 신원을 확인하지 말고 목록이 제한된 경우 명시해주세요».

카탈로그: «활성 서비스를 받아주세요. 가격과 사전 예약 규칙을 쉬운 말로 설명해주세요. 특정 날짜의 이용 가능성을 약속하지 마세요: MCP는 잔여 좌석을 반환하지 않습니다».

AI 어시스턴트를 위한 지침

이 지침은 어시스턴트 설정에 저장할 수 있습니다:

Luma MCP 도구를 사용하여 현재 데이터를 가져오세요. 서버 응답의 사실과 권장 사항을 구분하세요. 요약 시간과 목록 제한을 명시하세요. 누락된 데이터를 만들어내지 말고 객실 번호와 날짜로 게스트의 신원을 확인하지 마세요. MCP는 읽기 전용으로만 사용할 수 있습니다. 요청 변경, 결제 또는 메시지 전송을 위해서는 매니저에게 Luma에서 작업을 수행하도록 제안하세요. 데이터를 사용할 수 없는 경우 이를 명확히 알리세요.

연결 관리 및 개인정보 보호

각 토큰은 하나의 호텔에 연결됩니다. MCP는 게스트의 이름과 연락처, PIN 코드, 요청 설명, 내부 메모 및 결제 데이터를 반환하지 않습니다. 그러나 객실 번호, 요청 제목 및 지정된 직원 이름은 어시스턴트가 사용할 수 있으므로 팀이 신뢰하는 AI 클라이언트를 선택하세요.

토큰은 보호된 연결 설정에 보관하세요. 메시지, 주소 표시줄, 스크린샷 또는 공용 문서에 토큰을 붙여넣지 마세요. 각 클라이언트마다 별도의 토큰을 발급하세요. 접근 권한을 잃거나 직원이 변경된 경우 오너는 계정에서 «AI 및 MCP»를 열고 해당 연결에서 «취소»를 클릭해야 합니다.

연결이 작동하지 않는 경우

401: 토큰이 없거나, 잘못되었거나, 취소되었습니다; 또한 관리자와 함께 호텔 활성 상태 및 구독 접근 권한을 확인하세요.
403: 브라우저 클라이언트의 Origin이 허용되지 않았습니다. 관리자가 허용된 출처 설정을 확인해야 합니다; 검사를 비활성화할 필요는 없습니다.
405: 클라이언트가 GET을 사용하고 있습니다. 연결은 JSON 응답과 함께 POST를 통해 작동해야 합니다.
429: 요청 한도를 초과했습니다. 기다렸다가 요청을 다시 시도하세요; 경로는 분당 60개 요청으로 제한됩니다.
빈 목록: 적합한 데이터가 없을 수 있습니다. 상태, 숙박 날짜 및 필터를 확인하세요; 누락된 데이터를 추측으로 대체하지 마세요.
OAuth 필요: 현재 통합은 Bearer 토큰을 사용합니다; 호환되는 클라이언트를 선택하세요.

오너 계정에는 연결 이름, 생성 날짜, 마지막 사용 및 상태가 표시됩니다. AI 클라이언트를 비활성화하려면 «취소»를 클릭하세요. 취소하면 이 토큰의 접근이 중단됩니다; 다시 연결하려면 새 토큰을 생성하세요. 다른 호텔의 토큰은 사용할 수 없으며, 매니저는 토큰을 발급하거나 취소할 수 없습니다.