# 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).

## Jak podłączyć asystenta AI?

Każdy klient MCP, który obsługuje zdalne serwery Streamable HTTP, działa z tym samym adresem.

### Claude (web i desktop)

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

### ChatGPT (web)

1. W 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. Podaj adres https://lookly.pl/api/mcp, bez uwierzytelniania.
3. Wybierz Lookly w nowej rozmowie i zadaj pytanie.

### Claude Code

1. Uruchom polecenie w terminalu, potem sprawdź serwer przez /mcp.

Terminal:

```sh
claude mcp add --transport http lookly https://lookly.pl/api/mcp
```

### Cursor

1. Dopisz serwer do pliku ~/.cursor/mcp.json (albo .cursor/mcp.json w projekcie).

~/.cursor/mcp.json:

```json
{
  "mcpServers": {
    "lookly": {
      "url": "https://lookly.pl/api/mcp"
    }
  }
}
```

### VS Code (GitHub Copilot)

1. Dopisz serwer do .vscode/mcp.json i uruchom go w trybie Agent czatu.

.vscode/mcp.json:

```json
{
  "servers": {
    "lookly": {
      "type": "http",
      "url": "https://lookly.pl/api/mcp"
    }
  }
}
```

### Gemini CLI

1. Dopisz serwer do ~/.gemini/settings.json i uruchom gemini.

~/.gemini/settings.json:

```json
{
  "mcpServers": {
    "lookly": {
      "httpUrl": "https://lookly.pl/api/mcp"
    }
  }
}
```

Aplikacja Lookly w katalogu ChatGPT, bez ręcznego dodawania adresu: wkrótce.

### Bez klienta MCP: zapytanie JSON-RPC

```sh
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"}}}'
```

## O co można zapytać?

- „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`)

## Jak wygląda rozmowa?

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

```
search_artists {city: "Kraków", category: "paznokcie"}
  → beautynails-nikola, najbliższe wolne: wtorek 09:00 …
get_artist_services {slug: "beautynails-nikola"}
  → Manicure hybrydowy, 1 h, 100 zł; odwołanie do 3 h przed …
get_free_slots {slug, serviceIds: ["83b3…"], fromDate: "2026-11-10", days: 1, partOfDay: "afternoon"}
  → 2026-11-10: 12:00, 12:30, … 16:30
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
```

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ź.

## Jakie narzędzia udostępnia serwer?

Wszystkie narzędzia są tylko do odczytu. Parametry oznaczone * są wymagane.

### `search_artists`: 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.

- `city`*: miasto, tak jak pisze klientka: „Kraków”, „w Krakowie”, „Wodzisław”
- `category`: slug kategorii, np. makijaz, paznokcie, fryzjer, brwi-i-rzesy
- `limit`: 1–20, domyślnie 10

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

### `get_artist_services`: 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.

- `slug`*: z wyniku search_artists

### `get_free_slots`: Wolne terminy

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

- `slug`*: z wyniku search_artists
- `serviceIds`*: 1–5 id usług z get_artist_services, jedna wizyta
- `fromDate`: YYYY-MM-DD, domyślnie dziś
- `days`: ile dni z wolnymi godzinami, 1–14, domyślnie 7
- `partOfDay`: morning (do 12:00), afternoon (12–17), evening (od 17:00)

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

### `prepare_booking`: Link do rezerwacji

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

- `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”.

## 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.

Więcej dla agentów: https://lookly.pl/llms.txt, https://lookly.pl/skill.md
