Pawstay MCP

Pawstay pet otel yönetim sistemi için Model Context Protocol (MCP) sunucusu — URL tabanlı erişim.

Sunucu Adresi

POST https://mcp.pawstay.net/mcp

Bu sunucu herhangi bir API anahtarı tutmaz. Her kullanıcı, Pawstay'de kendi oteli için kendi Integration App'ini oluşturur ve aldığı paw_live_... anahtarını her isteğe Authorization: Bearer <anahtar> header'ı olarak ekler. Sunucu anahtarı olduğu gibi Pawstay API'sine iletir; izolasyonu, scope kontrolünü ve audit log'u Pawstay yapar.

Anahtar Nasıl Alınır?

1. Pawstay'e giriş yapın ve JWT alın:

   curl -s -X POST https://pawstay.net/api/v1/login -H "Content-Type: application/json" -d '{ "email": "sen@ornek.com", "password": "sifre" }'

2. Otelunuzun alabileceği scope'ları görün:

   curl -s https://pawstay.net/api/v1/integration_apps/scopes -H "Authorization: Bearer <jwt>"

3. Kendi Integration App'inizi oluşturun (cevapta paw_live_... anahtarınız olur):

   curl -s -X POST https://pawstay.net/api/v1/integration_apps -H "Content-Type: application/json" -H "Authorization: Bearer <jwt>" -d '{ "integration_app": { "name": "MCP Bağlantım", "scopes": ["hotels:read", "customers:write"] } }'

4. Anahtarı MCP istemci ayarlarınıza header olarak ekleyin (aşağıya bakın).

İstemci Yapılandırması

Claude Code — .mcp.json:

{ "mcpServers": { "pawstay": { "type": "http", "url": "https://mcp.pawstay.net/mcp", "headers": { "Authorization": "Bearer paw_live_..." } } } }

Cursor — ~/.cursor/mcp.json: aynı yapı ("url" + "headers").

stdio-only istemciler için npx mcp-remote https://mcp.pawstay.net/mcp kullanılabilir; ancak mcp-remote'un header desteği sınırlı olduğundan Claude Code / Cursor önerilir.

Kullanabileceğiniz Araçlar (61)

• pawstay_get_current_pet_hotel — Get the current user's pet hotel information
• pawstay_list_customers — List all customers for the current pet hotel. Supports filtering by name, phone, and pet name.
• pawstay_get_customer — Get a specific customer by ID
• pawstay_create_customer — Create a new customer
• pawstay_update_customer — Update an existing customer
• pawstay_delete_customer — Delete a customer
• pawstay_list_pets — List all pets for the current pet hotel. Supports Ransack search predicates.
• pawstay_get_pet — Get a specific pet by ID
• pawstay_create_pet — Create a new pet
• pawstay_update_pet — Update an existing pet
• pawstay_delete_pet — Delete a pet
• pawstay_list_dog_breeds — List all available dog breeds
• pawstay_get_dog_breed — Get a specific dog breed by ID
• pawstay_list_reservations — List reservations with optional filters. Supports status filter and ransack search predicates.
• pawstay_get_reservation — Get a specific reservation by ID with full details including financial summary and reservation days
• pawstay_create_reservation — Create a new reservation
• pawstay_update_reservation — Update an existing reservation
• pawstay_fire_reservation — Change reservation state. Allowed transitions: pending→check_in, checked_in→check_out, pending→cancel
• pawstay_assign_room — Assign or unassign a room to/from a reservation. Fails if the reservation is a training reservation with training_location='at_customer_home' — change training_location to 'at_facility' first.
• pawstay_reschedule_reservation — Reschedule reservation dates
• pawstay_list_folio_items — List all folio items for a reservation
• pawstay_create_folio_item — Add a new folio item (payment, expense, or discount) to a reservation
• pawstay_list_invoices — List all invoices across all reservations
• pawstay_get_invoice — Get a specific invoice by ID
• pawstay_list_reservation_invoices — List all invoices for a specific reservation
• pawstay_create_reservation_invoice — Create a new invoice for a reservation
• pawstay_preview_reservation_invoice — Preview the invoice for a reservation before creating it
• pawstay_list_reservation_notes — List all notes for a reservation
• pawstay_create_reservation_note — Add a note to a reservation
• pawstay_update_reservation_note — Update an existing reservation note
• pawstay_delete_reservation_note — Delete a reservation note
• pawstay_list_rooms — List all rooms for the current pet hotel
• pawstay_create_room — Create one or more rooms
• pawstay_update_room — Update a room
• pawstay_delete_room — Delete a room
• pawstay_list_room_categories — List all room categories
• pawstay_create_room_category — Create a new room category
• pawstay_update_room_category — Update a room category
• pawstay_delete_room_category — Delete a room category
• pawstay_list_ledger_entries — List all ledger entries for a customer
• pawstay_get_ledger_balance — Get the current ledger balance for a customer
• pawstay_create_debit_entry — Create a debit ledger entry for a customer
• pawstay_create_payment_entry — Create a payment (credit) ledger entry for a customer
• pawstay_get_training_intake — Get the training intake for a reservation
• pawstay_create_training_intake — Create the training intake for a reservation
• pawstay_update_training_intake — Update the training intake for a reservation
• pawstay_list_training_sessions — List all training sessions for a reservation
• pawstay_get_training_session — Get a specific training session by ID
• pawstay_create_training_session — Create a new training session for a reservation
• pawstay_update_training_session — Update an existing training session
• pawstay_delete_training_session — Delete a training session
• pawstay_get_pet_training_history — Get a pet's full training history: all training intakes and sessions across every reservation
• pawstay_list_cash_flow_accounts — List all cash flow accounts (cash boxes / bank accounts) for the hotel, with current balances and this month's totals
• pawstay_get_cash_flow_account — Get a specific cash flow account by ID
• pawstay_create_cash_flow_account — Create a new cash flow account (cash box or bank account)
• pawstay_update_cash_flow_account — Update a cash flow account's name, type, IBAN, or active status (currency and opening_balance cannot be changed after creation)
• pawstay_list_cash_flow_entries — List income/expense entries for a cash flow account. Without page/per_page, returns every entry ever recorded on the account.
• pawstay_create_cash_flow_entry — Create a new income or expense entry on a cash flow account
• pawstay_update_cash_flow_entry — Update a cash flow entry. Only possible within 2 minutes of creation — after that the backend rejects the change
• pawstay_delete_cash_flow_entry — Delete a cash flow entry. Only possible within 2 minutes of creation — after that the backend rejects the deletion
• pawstay_get_cash_flow_entry_history — Get the full audit history (creates, updates, deletes) of a cash flow entry

Doğrudan Test (curl)

Anahtar olmadan (beklenen: "anahtar eksik" hatası):

curl -s -X POST https://mcp.pawstay.net/mcp -H "Content-Type: application/json" -H "Accept: application/json, text/event-stream" -d '{"jsonrpc":"2.0","id":1,"method":"tools/list","params":{}}'

Güvenlik