OwnerRez MCP connector (호스팅형)

Claude가 OwnerRez 계정의 예약, 숙소, 게스트, 재무(견적, 결제, 환불, 수수료) 및 게스트 메시징을 읽고 처리할 수 있는 도구를 제공하는 원격 MCP 서버입니다.

오픈소스 ownerrez-mcp 프로젝트(MIT 라이선스)를 기반으로 합니다. 이 저장소는 여기에 Streamable HTTP 전송과 베어러 토큰 게이트를 추가하여, 로컬에서만 실행되는 대신 공개 웹 서비스로 실행되고 Claude에 사용자 지정 커넥터로 추가될 수 있게 합니다.

먼저 읽어보세요: 할 수 있는 일과 할 수 없는 일

OwnerRez의 계정 수준 API("API for Apps", 개인 토큰을 발급받는 종류)는 읽기+메시징 전용이며, 완전한 읽기/쓰기 예약 API가 아닙니다.

예약 생성과 날짜 차단은 OwnerRez의 별도 Channel API에만 존재하며, 이 API는 승인된 OTA/채널 파트너 통합(Airbnb, Vrbo 등)을 위해 예약되어 있습니다. 즉 개인 계정의 API 토큰으로는 사용할 수 없습니다. 따라서 "이 날짜들을 차단해 달라" 또는 "이 예약을 생성해 달라"는 이 커넥터 — 또는 개인 OwnerRez 자격 증명을 사용하는 어떤 도구 — 가 현재 할 수 있는 일이 아닙니다. 날짜를 프로그래밍 방식으로 차단해야 한다면 실질적인 옵션은 OwnerRez 자체 달력 UI를 사용하거나(이미 PriceLabs를 연결해 두었으므로) OwnerRez로 다시 동기화되는 PriceLabs의 날짜 오버라이드 도구를 사용하는 것입니다.

왼쪽 열에 있는 모든 기능은 실제이며 이 서버에서 작동합니다.

Related MCP server: Hospitable MCP Server

1. OwnerRez 개인 액세스 토큰 받기

OwnerRez에서: Settings → API → Personal Access Tokens로 이동합니다(정확히 그 위치가 아니라면 OwnerRez의 인증 문서를 참조하세요 — OwnerRez가 이 메뉴를 이전에 재구성한 적이 있습니다). 토큰을 생성하세요. 그러면 username과 token 값을 받게 됩니다. 둘 다 보관하세요 — 호스팅 플랫폼의 환경 변수에 붙여넣게 되며, 브라우저나 채팅에는 절대 붙여넣지 마세요.

2. 커넥터 액세스 토큰 생성

이것은 OwnerRez에서 받은 것이 아니라 별도로 생성하는 비밀 값입니다. Claude가 모든 요청에 이 값을 포함해 보내므로, 무작위 방문자가 서버에 접근하여 예약 데이터를 가져갈 수 없습니다. 하나 생성하세요:

python3 -c "import secrets; print(secrets.token_urlsafe(32))"

저장하세요. 3단계와 4단계에서 필요합니다.

3. 배포

옵션 A — Render(권장, 서버 운영 불필요)

1. 이 저장소는 이미 GitHub의 gcwharton-a11y/ownerrez-mcp에 있습니다.

2. Render 대시보드에서 New + → Blueprint를 선택하고, 메시지가 표시되면 GitHub 계정을 연결한 다음 이 저장소를 선택하세요. 여기 있는 render.yaml이 서비스를 자동으로 구성합니다.

3. 환경 변수를 묻는 메시지가 표시되면 다음을 설정하세요:

   • MCP_ACCESS_TOKEN — 2단계의 비밀 값

   • OWNERREZ_USERNAME / OWNERREZ_TOKEN — 1단계에서 받은 값

   • OWNERREZ_READ_ONLY — 읽기 전용으로 시작하려면 1로 두고, 게스트 메시지 전송과 웹훅 관리를 허용하려면 비우세요(위 표 참조 — OwnerRez API가 이를 제공하지 않으므로 이 설정으로 예약/날짜 쓰기가 활성화되지는 않습니다).

4. 배포하세요. Render가 https://ownerrez-mcp.onrender.com 같은 URL을 제공합니다. 커넥터 URL은 해당 URL에 /mcp/를 더한 것입니다 — 예: https://ownerrez-mcp.onrender.com/mcp/.

옵션 B — 모든 Docker 호스트(Railway, Fly.io, 자체 VM)

포함된 Dockerfile은 컨테이너와 PORT 환경 변수를 허용하는 모든 곳에서 실행됩니다:

docker build -t ownerrez-mcp .
docker run -p 8080:8080 \
  -e MCP_ACCESS_TOKEN=... \
  -e OWNERREZ_USERNAME=... \
  -e OWNERREZ_TOKEN=... \
  -e OWNERREZ_READ_ONLY=1 \
  ownerrez-mcp

로컬 테스트(배포 없음)

git clone https://github.com/gcwharton-a11y/ownerrez-mcp.git
cd ownerrez-mcp
pip install -r requirements.txt
MCP_ACCESS_TOKEN=devtoken OWNERREZ_USERNAME=... OWNERREZ_TOKEN=... \
  uvicorn http_app:app --host 0.0.0.0 --port 8080
curl http://localhost:8080/health   # -> ok

4. Claude에 사용자 지정 커넥터로 추가

1. Claude에서 Settings → Connectors → Add custom connector로 이동합니다(이 단계는 조직 관리자가 수행해야 합니다).

2. 서버 URL: https://<your-deployed-host>/mcp/ (끝에 슬래시 포함).

3. 인증 유형: request headers를 선택하세요(정적 헤더 / API 키 인증). 다음을 입력하세요:

   • 헤더 이름: Authorization

   • 헤더 값: Bearer <the MCP_ACCESS_TOKEN from step 2>

4. 저장하세요. Claude는 서버를 호출할 때마다 해당 헤더를 보내며, http_app.py의 미들웨어는 OwnerRez에 어떤 요청이 닿기 전에 이를 확인합니다.

사용 중인 Claude 플랜이 아직 사용자 지정 커넥터에 헤더 기반 인증을 제공하지 않는 경우(베타 기능), 차선책은 서버를 비공개로 유지하는 것입니다(URL을 공유하지 마세요). 토큰이 없는 사람은 모든 요청에서 여전히 401을 받으므로, 커넥터 수준 인증이 연결되어 있지 않아도 서버가 열려 있지 않습니다.

보안 참고 사항

• 베어러 토큰은 계정 전체의 OwnerRez 데이터에 대한 접근을 통제합니다 — 비밀번호처럼 취급하세요. 유출이 의심되면 새 MCP_ACCESS_TOKEN으로 재생성하고 재배포하여 교체하세요.

• OWNERREZ_READ_ONLY=1이 더 안전한 기본값입니다. Claude가 사용자를 대신해 게스트 메시지를 보내거나 웹훅 구독을 관리할 수 있게 하려는 경우에만 값을 비우세요.

• 이 서버의 어떤 기능도 예약을 생성·수정·취소하거나 가격을 변경할 수 없습니다. 이는 단순히 이 서버의 제한이 아니라 OwnerRez 계정 API가 제공하는 범위 밖입니다.

크레딧

도구 정의, OwnerRez API 클라이언트, 재시도/백오프, 읽기 전용 가드 로직은 buildwithmanag/ownerrez-mcp(MIT 라이선스, LICENSE.upstream으로 포함)에서 가져왔습니다. 이 저장소의 http_app.py와 배포 파일은 로컬 stdio 프로세스 대신 호스팅된 인증 원격 서버로 실행되게 하는 추가 사항입니다.