Asystent AI może sprawdzić wolne terminy konsultacji Bubble Development i na Twoje wyraźne polecenie utworzyć rezerwację przez publiczny interfejs MCP.
Jak zacząć
To działa tylko wtedy, gdy asystent pozwala dodać zewnętrzny serwer (MCP). Po połączeniu możesz napisać na przykład:
Znajdź wolny termin konsultacji w Bubble Development w przyszłym tygodniu i zarezerwuj go po moim potwierdzeniu.
Jeśli asystent nie obsługuje MCP, skorzystaj ze zwykłego formularza rezerwacji.
Połączenie asystenta
W aplikacji obsługującej zdalne serwery MCP dodaj poniższy adres jako serwer Streamable HTTP. Publiczny interfejs rezerwacji nie wymaga logowania ani klucza API. Obsługa i połączenie zależą od aplikacji; samo otwarcie strony nie podłącza automatycznie narzędzi do każdego asystenta.
https://services.bubbledevelopment.cz/api/booking/mcp
Jak przebiega rezerwacja
- Asystent odczytuje opublikowane typy konsultacji i wolne terminy. Sam odczyt niczego nie rezerwuje ani nie wysyła wiadomości.
- Przed rezerwacją pokazuje typ, cenę, czas trwania, termin w strefie Europe/Prague oraz warunki anulowania i informacje o danych osobowych.
- Wysyła rezerwację wyłącznie na wyraźne polecenie i po zaakceptowaniu warunków. Wymagane są imię, nazwisko, e-mail, telefon i firma, a przy konsultacji osobistej także adres. Numer identyfikacyjny firmy i uwagi są opcjonalne.
- System ponownie sprawdza dostępność i korzysta z tego samego procesu co formularz: rezerwacja w kalendarzu, powiązane dane CRM i potwierdzenia. Wynik wymagający sprawdzenia przez BD nie jest potwierdzoną rezerwacją.
Zakres i prywatność
Dostępne są tylko publiczne typy konsultacji i wolne terminy. Interfejs nie udostępnia cudzych rezerwacji, prywatnych kalendarzy, kontaktów ani administracji. Nie akceptuje ofert i nie podpisuje zamówień. Przekazuj tylko dane potrzebne do rezerwacji, bez haseł i poufnych załączników.
Dwa publiczne narzędzia
booking_availability
Opublikowane typy konsultacji i dostępność. Puste arguments zwracają katalog; dodaj type, from i to, aby odczytać terminy (YYYY-MM-DD, maksymalnie 31 dni).
W booking_availability ustaw lang na cs, en lub pl i zachowaj ten sam lang w booking_book.
booking_book
Tworzenie rezerwacji. Wymaga slotToken, timezone: Europe/Prague, intent: book_consultation, consent: true, danych kontaktowych i idempotencyKey. Asystent nie może domniemywać zgody ani zamiaru użytkownika.
Dla programistów i agentów
Dostępność zwraca podpisany wybór terminu ważny przez 15 minut. Ponawiaj identyczną rezerwację z tym samym losowym idempotencyKey. Zmiana danych pod tym samym kluczem lub zajęcie terminu powoduje błąd. Daty zawierają UTC offset; reguły korzystają z Europe/Prague i czasu letniego. Częstotliwość i rozmiar żądań są ograniczone.
Obsługiwane wersje: 2026-07-28 (metadane każdego żądania i server/discover) oraz 2025-11-25 (initialize, notifications/initialized, tools/list, tools/call). Odpowiedzi mają format JSON, bez stałego połączenia SSE. Stary transport HTTP+SSE nie jest obsługiwany.
Tylko dla klientów działających po stronie serwera; bezpośrednie połączenia z przeglądarki nie są obsługiwane. Wysyłaj Accept: application/json, text/event-stream. Zgodę deklaruje asystent; interfejs nie może sprawdzić, co użytkownik faktycznie potwierdził.
