Model Context Protocol

Lookly dla asystentów AI: serwer MCP dla każdego.

Publiczny serwer MCP Lookly pozwala ChatGPT, Claude, Gemini i innym asystentom AI znaleźć artystkę beauty w mieście, pokazać jej usługi, ceny i wolne terminy oraz przygotować link do rezerwacji. Bez logowania i bez klucza API.

Adres serwera

https://lookly.pl/api/mcp
  • Streamable HTTP
  • bez logowania
  • tylko odczyt
  • czas Europe/Warsaw
Konfiguracja

Jak podłączyć asystenta AI?

Każdy klient MCP, który obsługuje zdalne serwery Streamable HTTP, działa z tym samym adresem. Poniżej gotowe instrukcje dla najpopularniejszych.

  • Claude (web i desktop)

    1. 1Otwórz Settings → Connectors i wybierz „Add custom connector”.
    2. 2Wpisz nazwę „Lookly” i adres https://lookly.pl/api/mcp. Logowanie nie jest potrzebne.
    3. 3W nowej rozmowie włącz konektor Lookly i zapytaj o artystkę.
  • ChatGPT (web)

    1. 1W planach, które pozwalają dodać własny serwer MCP (np. Pro, Business), otwórz ustawienia aplikacji i dodaj własny serwer MCP. W planach Free i Plus może to być niedostępne.
    2. 2Podaj adres https://lookly.pl/api/mcp, bez uwierzytelniania.
    3. 3Wybierz Lookly w nowej rozmowie i zadaj pytanie.
  • Claude Code

    1. 1Uruchom polecenie w terminalu, potem sprawdź serwer przez /mcp.
    Terminal
    claude mcp add --transport http lookly https://lookly.pl/api/mcp
  • Cursor

    1. 1Dopisz serwer do pliku ~/.cursor/mcp.json (albo .cursor/mcp.json w projekcie).
    ~/.cursor/mcp.json
    {
      "mcpServers": {
        "lookly": {
          "url": "https://lookly.pl/api/mcp"
        }
      }
    }
  • VS Code (GitHub Copilot)

    1. 1Dopisz serwer do .vscode/mcp.json i uruchom go w trybie Agent czatu.
    .vscode/mcp.json
    {
      "servers": {
        "lookly": {
          "type": "http",
          "url": "https://lookly.pl/api/mcp"
        }
      }
    }
  • Gemini CLI

    1. 1Dopisz serwer do ~/.gemini/settings.json i uruchom gemini.
    ~/.gemini/settings.json
    {
      "mcpServers": {
        "lookly": {
          "httpUrl": "https://lookly.pl/api/mcp"
        }
      }
    }

Aplikacja Lookly w katalogu ChatGPT, bez ręcznego dodawania adresuwkrótce

Bez klienta MCP: zapytanie JSON-RPC

curl -s -X POST https://lookly.pl/api/mcp \
  -H 'Content-Type: application/json' \
  -H 'Accept: application/json, text/event-stream' \
  -H 'MCP-Protocol-Version: 2025-06-18' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"search_artists","arguments":{"city":"Kraków","category":"paznokcie"}}}'
Przykłady

O co można zapytać?

Pisz zwyczajnie, po polsku lub w innym języku. Asystent sam dobierze narzędzia.

  • „Znajdź mi manicure hybrydowy w Krakowie na jutro po południu.”

    • search_artists
    • get_artist_services
    • get_free_slots
  • „Ile kosztuje makijaż ślubny w Rybniku i kiedy jest najbliższy wolny termin?”

    • search_artists
    • get_artist_services
    • get_free_slots
  • „Jakie są zasady odwołania wizyty i zadatku u tej artystki?”

    • get_artist_services
  • „Pokaż wolne godziny w przyszłym tygodniu, tylko rano.”

    • get_free_slots
  • „Zarezerwuj mi czwartek o 10:00 na tę usługę.”

    • prepare_booking
  • „Find me a nail artist in Kraków this week and give me a booking link.”

    • search_artists
    • get_artist_services
    • get_free_slots
    • prepare_booking
Krok po kroku

Jak wygląda rozmowa?

  1. Klientka

    Znajdź mi manicure hybrydowy w Krakowie we wtorek po południu.

  2. search_artists {city: "Kraków", category: "paznokcie"}

    → beautynails-nikola, najbliższe wolne: wtorek 09:00 …

  3. get_artist_services {slug: "beautynails-nikola"}

    → Manicure hybrydowy, 1 h, 100 zł; odwołanie do 3 h przed …

  4. get_free_slots {slug, serviceIds: ["83b3…"], fromDate: "2026-11-10", days: 1, partOfDay: "afternoon"}

    → 2026-11-10: 12:00, 12:30, … 16:30

  5. prepare_booking {slug, serviceIds: ["83b3…"], date: "2026-11-10", time: "13:00"}

    → bookingUrl: https://lookly.pl/p/beautynails-nikola/umow?services=83b3…&start=2026-11-10T13:00

  6. Asystent

    Wtorek 13:00–14:00 u Beautynails.nikola, 100 zł. Termin nie jest jeszcze zarezerwowany: otwórz link, podaj imię i telefon i potwierdź.

Narzędzia (4)

Jakie narzędzia udostępnia serwer?

Typowa ścieżka: search_artists → get_artist_services → get_free_slots → prepare_booking. W ChatGPT, Claude i innych klientach z MCP Apps wyniki pokazują się też jako karty. Parametry oznaczone * są wymagane.

  • search_artists

    tylko odczyt

    Szukaj artystek w mieście

    Artystki z rezerwacją online: ocena, cena od, najczęstsze usługi, najbliższe wolne terminy, link do profilu. Gdy w mieście nikogo nie ma, podpowiada pobliskie miasta.

    Parametry search_artists
    ParametrOpis
    city*miasto, tak jak pisze klientka: „Kraków”, „w Krakowie”, „Wodzisław”
    categoryslug kategorii, np. makijaz, paznokcie, fryzjer, brwi-i-rzesy
    limit1–20, domyślnie 10

    Karta w czacie: karty artystek z przyciskami „Usługi i terminy” i „Profil”

  • get_artist_services

    tylko odczyt

    Usługi i zasady artystki

    Usługi w grupach (id, nazwa, czas, cena, opis) oraz zasady odwołania, zadatku, spóźnień i płatności, tak jak na profilu.

    Parametry get_artist_services
    ParametrOpis
    slug*z wyniku search_artists
  • get_free_slots

    tylko odczyt

    Wolne terminy

    Wolne godziny rozpoczęcia wizyty dzień po dniu (do 60 dni naprzód), z łącznym czasem i ceną wybranych usług.

    Parametry get_free_slots
    ParametrOpis
    slug*z wyniku search_artists
    serviceIds*1–5 id usług z get_artist_services, jedna wizyta
    fromDateYYYY-MM-DD, domyślnie dziś
    daysile dni z wolnymi godzinami, 1–14, domyślnie 7
    partOfDaymorning (do 12:00), afternoon (12–17), evening (od 17:00)

    Karta w czacie: wybór godziny; kliknięcie od razu przygotowuje link

  • prepare_booking

    tylko odczyt

    Link do rezerwacji

    Sprawdza, czy godzina jest nadal wolna, i zwraca bookingUrl: stronę rezerwacji z wybraną usługą i terminem. Nie rezerwuje.

    Parametry prepare_booking
    ParametrOpis
    slug*z wyniku search_artists
    serviceIds*jak w get_free_slots
    date*YYYY-MM-DD
    time*HH:MM, jedna z godzin z get_free_slots

    Karta w czacie: karta wizyty z przyciskiem „Potwierdź na lookly.pl”

FAQ

Pytania i odpowiedzi

Czy asystent AI sam rezerwuje wizytę?

Nie. Narzędzie prepare_booking sprawdza termin i zwraca link do strony rezerwacji z wybraną usługą i godziną. Klientka otwiera link, podaje imię i telefon i potwierdza. Termin jest zajęty dopiero wtedy.

Czy trzeba się logować albo mieć klucz API?

Nie. Serwer udostępnia tylko dane, które są już publiczne na lookly.pl, więc nie wymaga logowania, OAuth ani klucza API.

Jakie dane widzi asystent?

Usługi, ceny, czas trwania, zasady wizyt i wolne godziny opublikowanych profili, które przyjmują rezerwacje online. Nigdy nie widzi wizyt ani danych innych klientek, a przez serwer nie przechodzą żadne dane osobowe.

Czy są limity zapytań?

60 zapytań na minutę z jednego adresu IP. Po przekroczeniu serwer odpowiada kodem 429 z nagłówkiem Retry-After.

Czy działa po angielsku?

Tak. Asystent odpowiada w języku klientki, a nazwy usług zostają takie, jak napisała je artystka (zwykle po polsku). Daty i godziny są w czasie Europe/Warsaw.

Jestem artystką. Czy muszę coś włączyć?

Nie. Każdy profil, który przyjmuje rezerwacje online, jest dostępny przez serwer MCP automatycznie, także w planie Free.

Dla agentów czytających strony: llms.txt, skill.md i ta strona w Markdown.

Twoja pierwsza rezerwacja online jeszcze dziś.

Załóż profil w 10 minut, wklej link do bio i daj klientkom rezerwować same.

Załóż darmowy profil