Calendesk MCP: podłącz swojego asystenta AI do Calendesk

Obsługiwane: ChatGPT, Claude.ai, Claude Desktop, Claude Code, Cursor oraz inne zgodne z MCP.

Ten artykuł opisuje integrację Calendesk opartą na MCP (Model Context Protocol). ChatGPT to jeden z obsługiwanych klientów, który najprościej połączysz go przez aplikację w sklepie ChatGPT, ale ta sama integracja działa również z Claude i innymi narzędziami zgodnymi z MCP. Poniżej znajdziesz komplet informacji: co potrafi integracja, jak ją włączyć w każdym z klientów oraz jak korzystać z niej bezpiecznie.

Czym jest MCP? Model Context Protocol to otwarty standard, dzięki któremu asystent AI może łączyć się z zewnętrznymi systemami. Serwer Calendesk MCP udostępnia Twoje konto Calendesk asystentowi, więc zamiast klikać przez panel, pytasz w języku naturalnym, a asystent w czasie rzeczywistym pobiera i tam, gdzie pozwolisz, modyfikuje dane.

Co możesz zrobić

Po podłączeniu asystent uzyskuje dostęp do następujących grup narzędzi Calendesk. Nazwy narzędzi podajemy poglądowo. W rozmowie posługujesz się językiem naturalnym, a asystent sam dobiera właściwe narzędzie.

Wydarzenia i rezerwacje

Przeglądanie kalendarza, tworzenie, zmiana i odwoływanie wizyt, sprawdzanie konfliktów oraz blokowanie czasu jako niedostępnego.

Narzędzia: list_events, get_booking, create_booking, update_booking, delete_booking, check_event_overlaps, create_unavailable_slot, update_unavailable_slot, delete_unavailable_slot.

Klienci

Wyszukiwanie klientów, podgląd ich danych i historii oraz zakładanie, edycja i usuwanie kont.

Narzędzia: search_users, get_user, list_users, create_user, update_user, delete_user.

Pracownicy

Lista pracowników i ich szczegóły.

Narzędzia: list_employees, get_employee, delete_employee.

Usługi i dostępność

Sprawdzanie usług, wolnych terminów i dostępności, a także produktów, tagów i grup.

Narzędzia: list_services, get_service, get_available_slots, list_availability, list_service_types, list_products, list_tags, list_user_groups.

Analityka

Wskaźniki z pulpitu: przychody, liczba rezerwacji, trendy i dane o wynikach.

Narzędzia: get_stats.

Ustawienia i powiadomienia

Podgląd ustawień, danych konta oraz wysyłka powiadomień do klientów.

Narzędzia: get_settings, get_me, send_notification.

Zanim zaczniesz

• Aktywne konto Calendesk w planie obejmującym dostęp do API/MCP.

• Klient zgodny z MCP: Claude.ai (zalecany OAuth, bez instalacji), Claude Desktop, Claude Code, Cursor lub inny klient MCP, albo ChatGPT (aplikacja w sklepie).

• Dla wariantów z kluczem API: klucz API oraz Tenant ID z panelu (Panel administracyjny → Ustawienia → API).

Jak połączyć Calendesk z asystentem AI

Wybierz wariant pasujący do Twojego klienta. Niezależnie od narzędzia adres serwera Calendesk jest ten sam: https://mcp.calendesk.com

Wariant A — ChatGPT (aplikacja w sklepie)

Najszybsza droga dla użytkowników ChatGPT. Połączenie wykonujesz raz, przez logowanie OAuth bez kluczy i konfiguracji.

1. Otwórz aplikację Calendesk w katalogu ChatGPT.

2. Kliknij Connect — pojawi się okno „Add Calendesk to ChatGPT".

3. Wybierz Sign in with Calendesk i zaloguj się swoimi danymi Calendesk (OAuth).

4. Zobaczysz potwierdzenie „Calendesk is now connected", a przycisk zmieni się na Start chat.

Alternatywa dla ChatGPT. Jeśli Twój klient pozwala dodać konektor ręcznie, możesz wskazać serwer MCP pod adresem https://mcp.calendesk.com zamiast instalować aplikację ze sklepu.

Wariant B — Claude.ai (zalecany)

Wykorzystuje OAuth, nie wymaga instalacji ani obsługi klucza API.

1. Zaloguj się na claude.ai.

2. Przejdź do Settings → Connectors.

3. Kliknij Add custom connector i wprowadź nazwę Calendesk oraz adres serwera https://mcp.calendesk.com.

4. Zapisz, kliknij Connect i przeprowadź logowanie przez OAuth swoimi danymi Calendesk.

Po podłączeniu narzędzia Calendesk są dostępne w każdej rozmowie.

Wariant C — Claude Desktop (klucz API)

1. W panelu Calendesk przejdź do Panel administracyjny → Ustawienia → API i wygeneruj klucz API. Skopiuj klucz oraz Tenant ID.

2. Otwórz Claude Desktop → Settings → Developer → Edit Config.

3. Dodaj poniższy fragment do pliku claude_desktop_config.json, zapisz plik i uruchom ponownie Claude Desktop.

{ "mcpServers": { "calendesk": { "url": "https://mcp.calendesk.com", "headers": { "X-Api-Key": "twoj-klucz-api", "X-Tenant": "twoj-tenant-id" } } }
}

Wariant D — Claude Code (wiersz poleceń)

Wygeneruj klucz API w Ustawienia → API, a następnie wykonaj polecenie:

claude mcp add calendesk https://mcp.calendesk.com \ --transport http \ --header "X-Api-Key: twoj-klucz-api" \ --header "X-Tenant: twoj-tenant-id"

Wariant E — inne klienty MCP (tryb STDIO)

Dla klientów wymagających lokalnego serwera STDIO zainstaluj pakiet w Pythonie i ustaw zmienne środowiskowe, a następnie skieruj klienta na lokalny proces STDIO zgodnie z jego dokumentacją.

pip install calendesk-mcp-server
# albo, bez instalacji:
uvx calendesk-mcp-server

Sprawdź połączenie

W dowolnym kliencie zapytaj asystenta: „Czy jesteś podłączony do Calendesk? Wypisz dostępne narzędzia."

Powinieneś zobaczyć narzędzia Calendesk, takie jak list_events, get_booking, search_users czy get_stats. Jeśli ich nie ma, zajrzyj do sekcji „Rozwiązywanie problemów".

Przykłady użycia

Pisz tak, jak mówisz, a asystent sam dobierze odpowiednie narzędzie. Im konkretniej podasz zakres czasu, tym szybsza i trafniejsza odpowiedź.

Wskazówka. Zawsze podawaj zakres czasu („ostatnie 7 dni", „kwiecień 2026"), aby uniknąć przeszukiwania ogromnych ilości danych i przyspieszyć odpowiedź.

Przykład rozmowy: odwołanie wizyty i powiadomienie klienta

Operacje, które coś zmieniają lub wysyłają, zawsze kończą się prośbą o potwierdzenie, dzięki czemu masz pełną kontrolę nad tym, co trafia do klienta.

Ty: Jakie mam rezerwacje na dzisiaj?

Asystent: Na dzisiaj masz 8 zatwierdzonych rezerwacji typu „Konsultacja online" (po 60 min), od 09:00 do 17:00 — dzień jest zapełniony bez przerw.

Ty: Wyślij powiadomienie do klienta z wizyty o 15:00, że z przyczyn zdrowotnych spotkanie się nie odbędzie.

Asystent: Przygotowałem wiadomość do klienta z wizyty 15:00–16:00: „Dzień dobry, niestety z przyczyn zdrowotnych dzisiejsze spotkanie nie będzie mogło się odbyć. Przepraszam za niedogodności. Skontaktuję się w sprawie ustalenia nowego terminu." Potwierdź „wyślij", a wyślę powiadomienie do tego klienta.

Dobre praktyki

• Tam, gdzie to możliwe, korzystaj z OAuth (Claude.ai lub aplikacja ChatGPT). Unikasz wtedy przechowywania długoterminowych kluczy API na urządzeniach.

• Jeden klucz API na urządzenie lub integrację. Łatwiej go zidentyfikować i unieważnić w razie wycieku.

• Działaj świadomie z operacjami zapisu. Integracja może tworzyć, zmieniać i usuwać rezerwacje, klientów oraz blokady czasu — potwierdzaj operacje destrukcyjne, zanim je zatwierdzisz.

• Nie wklejaj kluczy API do czatów, zrzutów ekranu ani udostępnianych dokumentów.

• Łącz integrację z panelem, nie zastępuj go. MCP najlepiej sprawdza się przy pytaniach ad hoc i szybkich operacjach; cykliczne raporty rób w module Raportów.

Ważne — uprawnienia zapisu i usuwania. Calendesk MCP udostępnia zarówno narzędzia odczytu, jak i zapisu oraz usuwania (np. create_booking, update_booking, delete_booking, create_user, delete_user, send_notification). Każda osoba z ważnym kluczem API lub aktywnym połączeniem OAuth może wykonać te operacje za pośrednictwem asystenta. Klucz API traktuj jak poświadczenie o wysokich uprawnieniach.

Rozwiązywanie problemów

Cofanie dostępu

Aby unieważnić klucz API, przejdź do Panel administracyjny → Ustawienia → API, odszukaj klucz i go usuń. W przypadku połączeń OAuth (Claude.ai, ChatGPT) odłącz konektor lub aplikację w ustawieniach danego asystenta. Cofnij dostęp natychmiast, jeśli urządzenie zostało zgubione, pracownik odszedł lub podejrzewasz, że poświadczenie wyciekło.

Wsparcie

Jeśli coś nie działa zgodnie z opisem, sprawdź najnowsze zmiany w repozytorium github.com/calendesk/calendesk-mcp-server lub skontaktuj się z naszym wsparciem. W zgłoszeniu podaj klienta, którego używasz, metodę połączenia (OAuth / klucz API / STDIO) oraz dokładną treść błędu. Nigdy nie udostępniaj samego klucza API.