Hostkit MCP

Hostkit API용 MCP 서버입니다.

API 문서: https://hostkit.pt/api/

이 서버는 다음을 통해 공개 Hostkit API와 통신합니다:

https://app.hostkit.pt/api/{endpoint}?APIKEY=...

보안 강화를 위해 API 키는 숙소별로 생성되며, 각 숙소의 Hostkit 앱 -> 숙소(Properties) -> API 키 탭에서 생성 및 관리해야 합니다.

속도 제한(Rate limiting)이 적용되므로, 현재 제한 사항은 API 문서를 확인하시기 바랍니다.

요구 사항

• Node.js 20 이상

• Hostkit API 키

Related MCP server: guesty-mcp-server

확인

npm run check

실행

HOSTKIT_API_KEY="your-api-key" npm start

또는 npm 없이 실행:

HOSTKIT_API_KEY="your-api-key" node src/server.mjs

MCP는 읽기 및 쓰기 엔드포인트를 모두 노출합니다. API 키는 직접 Hostkit API에 액세스할 때와 동일하게 주의해서 사용하십시오.

MCP 클라이언트 설정

stdio 구성 예시:

{
  "mcpServers": {
    "hostkit": {
      "command": "npx",
      "args": ["-y", "github:hostkitpt/mcp"],
      "env": {
        "HOSTKIT_API_KEY": "your-api-key"
      }
    }
  }
}

게시 전 로컬 개발을 위한 설정:

{
  "mcpServers": {
    "hostkit": {
      "command": "node",
      "args": ["/path/to/api/mcp/src/server.mjs"],
      "env": {
        "HOSTKIT_API_KEY": "your-api-key"
      }
    }
  }
}

GitHub에 게시

git remote add origin https://github.com/hostkitpt/mcp.git
git push -u origin main

도구

• hostkit_get_license

• hostkit_get_properties

• hostkit_get_property

• hostkit_get_reservations

• hostkit_get_reservation

• hostkit_get_reservation_by_cm_id

• hostkit_get_payments

• hostkit_get_online_checkin

• hostkit_get_keycode

• hostkit_get_invoices

• hostkit_get_reservation_invoices

• hostkit_get_receipts

• hostkit_get_credit_notes

• hostkit_get_saft

• hostkit_get_expenses

• hostkit_get_last_siba_date

• hostkit_validate_siba

• hostkit_add_property

• hostkit_update_property

• hostkit_add_reservation

• hostkit_update_reservation

• hostkit_cancel_reservation

• hostkit_delete_reservation

• hostkit_add_guest

• hostkit_remove_guest

• hostkit_remove_all_guests

• hostkit_add_reservation_extra

• hostkit_delete_reservation_extras

• hostkit_add_invoice

• hostkit_add_invoice_line

• hostkit_close_invoice

• hostkit_delete_invoice

• hostkit_add_receipt

• hostkit_add_credit_note

• hostkit_generate_saft

• hostkit_send_siba

리소스

• https://hostkit.pt/api/ - 공식 Hostkit API 문서

참고 사항

• Hostkit 오류는 error, endpoint, status, payload를 포함한 구조화된 텍스트 콘텐츠로 반환됩니다.

• API 키는 이 서버에 의해 절대 로그에 기록되지 않습니다.

• 이 서버는 의도적으로 일반적인 제한 없는 엔드포인트 호출자를 노출하지 않습니다.