Dla programistów · dla Gospodarze

Podłącz ChatGPT, Claude lub własnego agenta AI (MCP)

Podłącz ChatGPT, Claude, Cursor, n8n lub dowolnego klienta MCP do Guestbud przez logowanie lub klucz API: agent odpowiada gościom i zarządza rezerwacjami i ofertami.

Guestbud obsługuje Model Context Protocol (MCP) — otwarty standard, dzięki któremu asystenci AI współpracują z innym oprogramowaniem. Podłączasz własnego agenta AI do konta Guestbud raz. Potem mówisz mu zwykłym językiem, co ma zrobić, na przykład:

„Odpowiedz na nowe pytania o parking na czacie Airbnb.”
„Kto przyjeżdża jutro i czy wszyscy się zameldowali?”
„Zmień hasło Wi-Fi w Harbour Loft na SeaBreeze2026.”
„Napisz e-mail z danymi zameldowania przyjaźniej i dodaj zasadę dotyczącą ręczników plażowych.”
„Które zgłoszenia są wciąż otwarte i co zgłosił gość z mieszkania 3?”

Agent pracuje na Twoich danych, na Twoim koncie i tylko z uprawnieniami, które mu nadasz.

Co potrafi Twój agent #

Obszar	Co może zrobić	Wymagane uprawnienie roli
Konto	Sprawdzić, z jakim kontem i rolą jest połączony	—
Rezerwacje	Wyświetlać i wyszukiwać rezerwacje, czytać rezerwację z danymi zameldowania, statusem płatności i statusem kodów do drzwi	Bookings: view
Czat z gośćmi	Czytać rozmowę z Airbnb, Booking.com, Vrbo … i wysyłać wiadomości do gościa (przez Hostaway lub Channex)	Bookings: view / edit
Zameldowanie	Wysłać link do zameldowania lub przypomnienie e-mailem albo na czacie; wcześniej pokazać kody do drzwi przy uzgodnionym wcześniejszym zameldowaniu	Bookings: edit
Rezerwacje	Utworzyć rezerwację bezpośrednią, edytować notatki, gości i dane kontaktowe, anulować	Bookings: edit
Zgłoszenia	Wyświetlać zgłoszenia usterek od gości, oznaczać je jako w toku lub rozwiązane, dodawać notatki wewnętrzne	Bookings: view / edit
Plan sprzątania	Zameldowania i wymeldowania z najbliższych dni z godzinami przyjazdu / wyjazdu i lotami	Cleaning plan
Oferty	Czytać cały przewodnik dla gości; zmieniać sekcje (Wi-Fi, kroki zameldowania, regulamin, lokalne wskazówki, dodatki …); włączać i wyłączać obiekt	Properties: view / edit
Wiadomości do gości	Czytać i edytować automatyczne wiadomości do gości i szablony; podglądać wiadomość uzupełnioną danymi prawdziwej rezerwacji	Settings
Statystyki	Obłożenie, rezerwacje, opłata turystyczna, kaucje, sprzedane wcześniejsze zameldowania / późne wymeldowania i dodatki	Reports
Wszystko inne	Czytać dowolną część REST API (tylko odczyt)	jak API

Nigdy niedostępne dla agenta: zwroty, zwalnianie lub pobieranie kaucji, ustawienia płatności, użytkownicy i klucze API. To zostaje przy Tobie w panelu.

Dwa sposoby połączenia #

	Logowanie (zalecane)	Klucz API
Dla	ChatGPT, claude.ai, Claude Desktop i mobilnej aplikacji, Claude Code, Cursor	n8n, Make, frameworków agentowych, Twojego własnego kodu, serwerów bez obecności człowieka
Jak	Wklej adres serwera w aplikacji AI, zaloguj się do Guestbud, wybierz rolę, kliknij Allow	Utwórz klucz w Guestbud i wklej go do narzędzia
Kto	Osoba, która się loguje (potrzebuje uprawnienia do łączenia aplikacji, patrz niżej)	Ktoś, kto zarządza użytkownikami
Koniec	Gdy rozłączysz połączenie, gdy osoba zostanie usunięta, wyłączona, dostanie inną rolę lub zmieni hasło, albo po 60 dniach bez żadnego użycia	Gdy unieważnisz klucz

Adres Twojego serwera jest podany w Settings → AI agent (MCP):

https://guestbud.io/mcp lub
Twoja własna domena z /mcp na końcu, na przykład https://stay.example.com/mcp.

1. Wybierz, co agent może robić #

Agent zawsze pracuje z rolą — dokładnie tak jak osoba w Twoim zespole (zobacz Użytkownicy, role i logowanie):

Staff — zalecana do odpowiadania gościom: czyta rezerwacje, wysyła wiadomości i linki do zameldowania, obsługuje zgłoszenia usterek, widzi plan sprzątania. Nie może zmieniać ofert ani ustawień.
Manager — dodatkowo edytuje oferty, szablony wiadomości i ustawienia oraz czyta statystyki.
Viewer — tylko odczyt; nie może niczego wysłać.
Cleaning — tylko plan sprzątania.

Zacznij od Staff. Przy logowaniu wybierasz rolę na stronie Guestbud, która się otworzy; nigdy nie może być wyższa niż Twoja własna rola i nigdy nie może to być Owner.

Gdzie dodać adres serwera (https://guestbud.io/mcp) w aplikacji AI:

claude.ai, Claude Desktop i aplikacja mobilna: Settings → Connectors → Add custom connector, wklej adres, Add, potem Connect.
ChatGPT: Settings → Apps & Connectors, utwórz konektor (tryb deweloperski), wklej adres, uwierzytelnianie OAuth.
Claude Code: uruchom claude mcp add --transport http guestbud https://guestbud.io/mcp, potem wpisz /mcp w Claude Code i wybierz Authenticate.
Cursor: Settings → MCP → Add server z { "mcpServers": { "guestbud": { "url": "https://guestbud.io/mcp" } } }, potem Connect.

Następnie:

W aplikacji AI dodaj Guestbud z adresem swojego serwera, jak pokazano wyżej, i rozpocznij połączenie.
Otworzy się strona Guestbud. Zaloguj się swoim zwykłym loginem Guestbud (na guestbud.io podajesz też krótką nazwę firmy).
Sprawdź nazwę aplikacji i adres, do którego wraca (na przykład claude.ai), wybierz rolę dla aplikacji i kliknij Allow.
Po powrocie do aplikacji AI narzędzia Guestbud są dostępne. Zapytaj na przykład: „Którzy goście przyjeżdżają w tym tygodniu?”.

Pozostaje połączona: aplikacja automatycznie odnawia dostęp w tle (co godzinę). Nie musisz łączyć się ponownie, dopóki agent jest używany co najmniej raz na 60 dni.

Kto może łączyć: w Settings → AI agent (MCP) → Who may connect AI apps with sign-in wybierasz Team members who manage users (domyślnie), All team members (każdy do poziomu własnej roli) lub Nobody. Przełączenie na Nobody od razu kończy wszystkie połączenia przez logowanie.

Połączone aplikacje: ta sama strona pokazuje każdą połączoną aplikację z osobą, która się zalogowała, jej rolą i ostatnim użyciem. Disconnect natychmiast ją rozłącza.

3. Połącz kluczem API (narzędzia do automatyzacji i własny kod) #

Klucza używaj dla narzędzi działających bez logowania osoby: n8n, Make, frameworków agentowych, skryptów i serwerów.

Otwórz Settings → AI agent (MCP) i rozwiń For automation tools and your own code (API key) (potrzebujesz uprawnienia do zarządzania użytkownikami).
Wpisz Name, na przykład n8n — odpowiedzi dla gości, i wybierz Role.
Kliknij Create key and show the setup.
Pełny klucz (gpk_…) jest wyświetlany tylko raz, razem z gotowymi liniami konfiguracji, które już go zawierają. Skopiuj je teraz. Jeśli zgubisz klucz, unieważnij go i utwórz nowy.

Klucz działa tylko dla Twojego konta. Na domenie innej firmy zostanie odrzucony.

n8n i inne narzędzia do automatyzacji #

W n8n dodaj AI Agent z narzędziem MCP Client Tool:

Endpoint: https://guestbud.io/mcp
Server transport: HTTP Streamable
Authentication: Bearer Auth, token = Twój klucz gpk_…

Każdy inny klient MCP, który potrafi wysłać nagłówek, działa tak samo:

URL: https://guestbud.io/mcp
Transport: Streamable HTTP
Nagłówek: Authorization: Bearer gpk_…

Claude Code, Claude Desktop, Cursor, Windsurf z kluczem #

Dla tych aplikacji lepiej użyć logowania. Jeśli mimo to chcesz klucz (na przykład na serwerze):

claude mcp add --transport http guestbud https://guestbud.io/mcp --header "Authorization: Bearer gpk_…"

Aplikacje uruchamiające serwery MCP z pliku konfiguracyjnego korzystają z darmowego mostka mcp-remote (wymaga Node.js):

{
  "mcpServers": {
    "guestbud": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://guestbud.io/mcp", "--header", "Authorization:${GUESTBUD_AUTH}"],
      "env": { "GUESTBUD_AUTH": "Bearer gpk_…" }
    }
  }
}

Klucz celowo znajduje się w części env: dzięki temu unikasz problemów ze spacjami w systemie Windows.

4. Korzystaj z niego #

Pytaj zwykłym językiem, tak jak zapytałbyś współpracownika. Kilka przykładów, które dobrze działają:

Czat z gośćmi: „Sprawdź rezerwacje z przyjazdem w najbliższych trzech dniach. Przeczytaj rozmowy na Airbnb i Booking.com i przygotuj odpowiedzi na pytania bez odpowiedzi. Pokaż mi je przed wysłaniem.”
Przypomnienie o zameldowaniu: „Kto przyjeżdża jutro i nie zameldował się online? Wyślij im przypomnienie przez czat rezerwacji.”
Wcześniejsze zameldowanie: „Gość z rezerwacji GP-7KQ2XD może zameldować się o 12:00 — odblokuj kody wcześniej i napisz mu to na czacie.”
Oferty: „Pokaż mi kroki zameldowania w Capua Flats i popraw kod do windy na 3044.”
Zgłoszenia: „Wypisz otwarte zgłoszenia; oznacz to dotyczące Wi-Fi w Harbour Loft jako rozwiązane z notatką ‚router zrestartowany’.”
Sprzątanie: „Co ekipa sprzątająca ma do zrobienia w sobotę, posortowane według godziny wyjazdu? Zaznacz zmiany gości tego samego dnia.”
Wiadomości: „Przepisz e-mail z danymi zameldowania cieplejszym tonem, zachowaj wszystkie symbole zastępcze i pokaż mi podgląd z najbliższą rezerwacją.”
Liczby: „Ile późnych wymeldowań sprzedaliśmy w zeszłym miesiącu i które dodatki sprzedawały się najlepiej?”

Wskazówka: niech agent najpierw przygotowuje wiadomości do gości i pokazuje je Tobie („pokaż mi je przed wysłaniem”). Gdy mu zaufasz, możesz pozwolić mu wysyłać bezpośrednio.

Bezpieczeństwo #

Ty wybierasz uprawnienia: o wszystkim decyduje rola klucza lub logowania. Agent widzi tylko narzędzia dozwolone dla jego roli, a serwer ponownie sprawdza każde wywołanie.
Żadnych przepływów pieniędzy: zwroty, kaucje, ustawienia płatności, użytkownicy i klucze są niedostępne przez MCP.
Niezaufany tekst gości: goście mogą wpisać cokolwiek na czacie lub w formularzu zameldowania. Guestbud każe agentowi traktować wszystko, co napisał gość, jako informację, nigdy jako polecenie. Każe mu też nie wysyłać kodów do drzwi, zanim rezerwacja nie pokaże ich jako widocznych. Mimo to sprawdzaj, co wysyła agent, zwłaszcza na początku.
Każda zmiana jest rejestrowana: każda czynność, która coś zmienia (wysłana wiadomość, zmieniona rezerwacja lub oferta, odblokowany kod …), widnieje w Settings → Audit trail pod nazwą aplikacji lub klucza. Samo odczytywanie danych nie jest rejestrowane, dzięki czemu dziennik pozostaje czytelny.
Mniej danych osobowych: agent dostaje to, czego potrzebuje, by pomagać gościom, i nic więcej. Szczegóły rezerwacji nie zawierają danych z dokumentów tożsamości i przesłanych plików, adresów IP ani kodu inteligentnego zamka rezerwacji. Dostęp do API tylko do odczytu wyklucza pliki, użytkowników, klucze API, dziennik audytu, webhooki, dane meldunkowe gości oraz ustawienia płatności, e-maili i zamków.
Limity: najwyżej 120 wywołań narzędzi na minutę i 40 wiadomości do gości na godzinę na połączenie lub klucz; najwyżej 10 zapytań w jednej paczce, a bardzo długie odpowiedzi są skracane.
Bezpieczne logowanie: Guestbud korzysta ze standardu logowania aplikacji AI (OAuth 2.1 z PKCE). Aplikacja nigdy nie widzi Twojego hasła; dostaje token dostępu ważny przez godzinę i token odświeżania, który zmienia się przy każdym użyciu. Jeśli token odświeżania zostanie kiedykolwiek użyty dwa razy, Guestbud zamyka połączenie. Token z logowania działa tylko dla połączenia agenta AI, a nie dla reszty API.
Unieważnienie w każdej chwili: Settings → AI agent (MCP) → Disconnect (logowanie) lub Revoke (klucz). Agent natychmiast traci dostęp.
Twój dostawca AI: dane, które czyta agent, przetwarza podłączona przez Ciebie usługa AI (na przykład Anthropic w przypadku Claude). Sprawdź, czy jest to zgodne z Twoją informacją o prywatności dla gości.

Najczęściej zadawane pytania #

Którzy agenci AI współpracują z Guestbud? #

Każdy klient MCP. ChatGPT, claude.ai, Claude Desktop i aplikacja mobilna, Claude Code i Cursor łączą się przez logowanie. n8n, frameworki agentowe i Twój własny kod łączą się kluczem API.

Jak długo działa połączenie przez logowanie? #

Tak długo, jak z niego korzystasz. Aplikacja automatycznie odnawia dostęp co godzinę; połączenie kończy się dopiero po 60 dniach bez żadnego użycia, gdy je rozłączysz albo gdy osoba, która się zalogowała, zostanie usunięta, wyłączona, dostanie inną rolę lub zmieni hasło.

Czy agent może wysyłać gościom kody do drzwi? #

Tylko jeśli jego rola może czytać rezerwacje i oferty, i tylko gdy rezerwacja gościa pokazuje kody jako widoczne: zameldowanie i płatności zakończone, a godzina zameldowania nadeszła (lub kody zostały przez Ciebie wcześniej odblokowane). Agent zna tę zasadę. Twoje szablony wiadomości z {doorCodes} automatycznie stosują tę samą zasadę.

Czy kilku agentów może jednocześnie korzystać z Guestbud? #

Tak. Każde logowanie i każdy klucz to osobne połączenie z własną rolą, widoczne osobno w dzienniku audytu — możesz rozłączyć jedno bez wpływu na pozostałe.

Czy agent kosztuje coś w Guestbud? #

Nie. Dostęp MCP jest częścią Twojego konta. Za samego agenta płacisz swojemu dostawcy AI.

Czy jest też API dla programistów? #

Tak — agent korzysta z tych samych uprawnień co REST API i webhooki; zobacz szybki start z API.