hostaway-mcp

Hostaway를 위한 읽기 전용 호스피탈리티 특화 MCP 서버입니다.

이 저장소는 운영자 제품만을 포함합니다: 로컬/npm stdio, 6개의 읽기 전용 도구, Cloudflare Worker 없음, Seascape 예약 인터페이스 없음.

V1 목표

매번 원시 API 호출을 수동으로 작성하지 않고도 실제 Hostaway 워크플로우에서 Codex와 Claude를 유용하게 사용할 수 있도록 합니다.

V1은 의도적으로 범위를 좁혔습니다:

• 읽기 전용

• 원시 엔드포인트 패리티가 아닌 호스피탈리티 네이티브 도구

• 대화 컨텍스트, 예약 조회 및 숙소 조회에 최적화

Related MCP server: guesty-mcp-server

정확한 V1 인터페이스

• list_unread_guest_threads

• get_conversation_context

• get_reservation_brief

• get_listing_brief

• search_reservations

• search_conversations

로컬 개발

npm install
npm test
npm run check
npm run build

stdio 서버를 로컬에서 실행:

HOSTAWAY_API_TOKEN=your-token-here node dist/cli.js

로컬 npm 패키지 tarball 생성:

npm pack

배포 후 복제 없이 실행:

npx hostaway-mcp

MCP 클라이언트 연결

로컬 MCP 클라이언트의 경우, 환경 변수를 통해 HOSTAWAY_API_TOKEN을 제공하고 stdio를 통해 게시된 npm 패키지를 실행합니다.

아래 스니펫은 현재 게시된 버전에 고정되어 있습니다:

hostaway-mcp@0.2.0

업그레이드 시 해당 버전을 의도적으로 업데이트하십시오.

Claude Desktop (macOS)

~/Library/Application Support/Claude/claude_desktop_config.json을 편집합니다.

preferences와 같은 최상위 키가 이미 있는 경우, 이를 유지하고 그 옆에 mcpServers를 추가합니다:

{
  "mcpServers": {
    "hostaway": {
      "command": "npx",
      "args": ["-y", "hostaway-mcp@0.2.0"],
      "env": {
        "HOSTAWAY_API_TOKEN": "your-token-here"
      }
    }
  }
}

파일을 저장한 후 Claude Desktop을 다시 시작하십시오.

Codex

~/.codex/config.toml을 편집하고 다음을 추가합니다:

[mcp_servers.hostaway]
command = "npx"
args = ["-y", "hostaway-mcp@0.2.0"]

[mcp_servers.hostaway.env]
HOSTAWAY_API_TOKEN = "your-token-here"

서버가 등록되었는지 확인:

codex mcp list

로컬 빌드 CLI

npm 대신 저장소 체크아웃을 실행하려면 클라이언트를 빌드된 CLI로 직접 지정하십시오:

{
  "command": "node",
  "args": ["/absolute/path/to/hostaway-mcp/dist/cli.js"],
  "env": {
    "HOSTAWAY_API_TOKEN": "your-token-here"
  }
}

환경 변수

V1 비목표

• 게스트 메시지 전송

• 예약 또는 숙소 변경

• Cloudflare Worker 전송

• Seascape 예약/배포 흐름

• 웹훅 수신

• 백그라운드 동기화 파이프라인

• 대시보드 또는 소유자 보고

• 일반적인 REST-to-MCP 프록시 커버리지

소스 설계

docs/designs/v1-readonly-hostaway-mcp.md를 참조하십시오.