hostaway-mcp

Claude Desktop, Claude Code, Cursor와 같은 AI 어시스턴트를 Hostaway 부동산 관리 API에 연결하는 오픈소스 Model Context Protocol (MCP) 서버입니다. 자연어로 예약, 숙소 목록, 달력, 재무 및 게스트 대화를 조회할 수 있습니다.

빠른 시작

1. Hostaway 대시보드의 Settings > API에서 Account ID와 Client Secret을 가져옵니다.

2. **Node.js 18+**가 설치되어 있는지 확인합니다.

3. 아래에서 AI 클라이언트를 선택하고 구성을 추가하세요. 클로닝이나 빌드가 필요 없습니다.

Related MCP server: Lodgify MCP Server

설정

Claude Desktop (Mac & Windows)

Claude Desktop 구성 파일을 엽니다:

• Mac: ~/Library/Application Support/Claude/claude_desktop_config.json

• Windows: %APPDATA%\Claude\claude_desktop_config.json

다음을 추가합니다 (다른 서버가 구성된 경우 기존 mcpServers와 병합):

{
  "mcpServers": {
    "hostaway": {
      "command": "npx",
      "args": ["-y", "@matt-long-plux/hostaway-mcp"],
      "env": {
        "HOSTAWAY_ACCOUNT_ID": "YOUR_ACCOUNT_ID",
        "HOSTAWAY_CLIENT_SECRET": "YOUR_CLIENT_SECRET"
      }
    }
  }
}

Claude Desktop을 다시 시작하면 준비 완료입니다.

Claude Code

옵션 1 — CLI 명령 (가장 빠름):

claude mcp add hostaway \
  -e HOSTAWAY_ACCOUNT_ID=YOUR_ACCOUNT_ID \
  -e HOSTAWAY_CLIENT_SECRET=YOUR_CLIENT_SECRET \
  -- npx -y @matt-long-plux/hostaway-mcp

옵션 2 — 프로젝트 루트의 .mcp.json (팀원과 공유하기 좋음):

{
  "mcpServers": {
    "hostaway": {
      "command": "npx",
      "args": ["-y", "@matt-long-plux/hostaway-mcp"],
      "env": {
        "HOSTAWAY_ACCOUNT_ID": "YOUR_ACCOUNT_ID",
        "HOSTAWAY_CLIENT_SECRET": "YOUR_CLIENT_SECRET"
      }
    }
  }
}

Cursor

동일한 구성을 프로젝트의 .cursor/mcp.json에 추가하거나, Cursor Settings > MCP Servers > Add Server로 이동하여 붙여넣으세요:

{
  "mcpServers": {
    "hostaway": {
      "command": "npx",
      "args": ["-y", "@matt-long-plux/hostaway-mcp"],
      "env": {
        "HOSTAWAY_ACCOUNT_ID": "YOUR_ACCOUNT_ID",
        "HOSTAWAY_CLIENT_SECRET": "YOUR_CLIENT_SECRET"
      }
    }
  }
}

업데이트

npx를 통해 이전 버전을 설치한 경우 시스템에 캐시된 복사본이 있을 수 있습니다. 최신 릴리스로 업데이트하려면:

npx clear-npx-cache

그런 다음 AI 클라이언트(Claude Desktop, Cursor 등)를 다시 시작하세요. 다음 실행 시 자동으로 최신 버전을 가져옵니다.

또는 구성에서 @latest를 고정하여 재시작할 때마다 항상 최신 버전을 가져올 수 있습니다:

"args": ["-y", "@matt-long-plux/hostaway-mcp@latest"]

도구 참조

예약

숙소 목록

달력

재무

대화

읽기 전용 모드

HOSTAWAY_READ_ONLY=true로 설정하면 모든 쓰기/변경 도구가 비활성화됩니다. 활성화되면 다음 도구는 실행 대신 오류를 반환합니다:

• update_reservation_host_note

• create_calendar_block

• delete_calendar_block

• send_message

공유 계정이나 실수로 인한 수정을 방지하려는 경우에 유용합니다.

환경 변수

예시 쿼리

연결되면 Claude에게 다음과 같이 물어보세요:

• "예정된 모든 예약을 보여줘"

• "다음 달 내 숙소의 점유율은 어떤가요?"

• "향후 90일 동안 모든 숙소의 공백 숙박을 찾아줘"

• "지난달 수익은 얼마였나요?"

• "읽지 않은 게스트 메시지를 보여줘"

• "예약 12345의 재무 내역은 무엇인가요?"

• "3월 에어비앤비 예약에 대한 지급 보고서를 생성해줘"

기여

피드백과 풀 리퀘스트를 환영합니다! GitHub에 이슈를 열거나 matt@plux.com으로 이메일을 보내주세요.

라이선스

MIT