Kolekcja klepsydr w Twoim asystencie AI

Możesz podłączyć publiczną kolekcję klepsydr do swojego asystenta AI (Claude, ChatGPT, GitHub Copilot i innych klientów obsługujących standard MCP): wyszukiwać klepsydry, czytać ich opisy i parametry, oglądać zdjęcia oraz zgłaszać właścicielowi sugestie poprawek – po prostu rozmawiając.

Wygeneruj klucz (przycisk poniżej, bez rejestracji).
Wklej adres z kluczem jako własny serwer/konektor MCP w swojej aplikacji AI.
Pytaj o klepsydry – asystent sam skorzysta z kolekcji.

Co możesz zrobić

Po podłączeniu serwera Twój asystent AI zyskuje „ręce” do tej kolekcji. Możesz po prostu rozmawiać, a asystent sam wywoła odpowiednie narzędzia. Przykładowe polecenia:

„Użyj serwera klepsydry i znajdź breloki w kolekcji.”
„Pokaż mi zdjęcia klepsydry numer 934 i opisz, jak jest zbudowana.”
„Która klepsydra ma najdłuższy czas przesypywania?” albo „Pokaż pięć najwyższych klepsydr.”
„Jakie materiały i kolory występują w kolekcji?”
„Zgłoś właścicielowi, że klepsydra 934 pochodzi z lat 60. – źródło: …” (sugestia trafia do moderacji).

Dostępne narzędzia

Narzędzie	Do czego służy
`slowniki`	Listy funkcji, kolorów, materiałów i kształtów z identyfikatorami.
`szukaj_klepsydry`	Wyszukiwanie po słowach z nazwy i opisu oraz po funkcji, z sortowaniem (czas odmierzania, wysokość, masa) i filtrem czasu. W wynikach od razu czas, wymiary, masa i adres miniatury – pytanie „która klepsydra ma najdłuższy czas?” to jedno wywołanie.
`pobierz_klepsydre`	Pełna karta: opis, wymiary, masa, czas odmierzania, funkcje, elementy, lokalizacja (jeśli publiczna), lista zdjęć z adresami do wyświetlenia.
`zdjecia_klepsydry`	Zdjęcia jako obrazy (do 3 w jednym wywołaniu, kolejne po numerze zdjęcia). Filmy są tylko wymieniane.
`search` i `fetch`	To samo co wyszukiwanie i karta, ale w standardowym formacie wymaganym przez część aplikacji (np. ChatGPT). Wyszukiwanie przyjmuje zwykłe zdanie.
`zglos_sugestie`	Zgłoszenie poprawki lub uzupełnienia dla właściciela. Nie zmienia strony – czyta ją i zatwierdza właściciel.

Dostęp obejmuje wyłącznie klepsydry widoczne na stronie i to, co na niej widać (bez cen zakupu, sprzedawców, adresów i uwag prywatnych). Wymiary: x – szerokość, y – wysokość, z – głębokość (mm).

Jak podłączyć

W poniższych instrukcjach zamiast klucza widać wpis TWOJ_KLUCZ – po wygenerowaniu klucza instrukcje będą zawierały gotowy, Twój adres. Nazwy opcji w aplikacjach bywają zmieniane przez ich producentów, więc mogą się nieco różnić od opisanych.

Claude (czat w przeglądarce, aplikacja komputerowa, telefon)

Otwórz ustawienia konta i sekcję Konektory (Connectors).
Wybierz dodanie własnego (niestandardowego) konektora.
Jako adres serwera wklej cały adres z kluczem. Nazwa dowolna, np. „Klepsydry”. Pola uwierzytelniania (OAuth) zostaw puste.
Po dodaniu narzędzia są dostępne w każdym nowym czacie – włącz konektor w ustawieniach rozmowy i poproś np. o znalezienie klepsydry.

https://hourglasses.eu/mcp/TWOJ_KLUCZ

Własne konektory są dostępne w wybranych planach Claude; jeśli nie widzisz tej opcji, sprawdź ustawienia planu lub konta organizacji.

ChatGPT (przeglądarka, aplikacja)

Potrzebny jest płatny plan z trybem dewelopera (np. Plus, Pro, Business) – darmowy plan nie pozwala dodać własnego serwera MCP.
W Ustawieniach otwórz Aplikacje i konektory (Apps & Connectors) i w opcjach zaawansowanych włącz tryb dewelopera.
Wybierz Utwórz (Create) i wypełnij: nazwa „Klepsydry”, krótki opis, adres serwera (wklej adres z kluczem), uwierzytelnianie: brak (None).
W nowym czacie włącz ten konektor (tryb dewelopera / menu narzędzi) i zadaj pytanie o klepsydry.

Uwaga: ChatGPT zmienia wymagania wobec serwerów MCP. Jeśli odrzuci uwierzytelnianie „brak”, daj znać właścicielowi strony.

GitHub Copilot w VS Code

Otwórz paletę poleceń (Ctrl+Shift+P) i uruchom MCP: Add Server, wybierz typ HTTP i wklej adres – albo ręcznie dopisz serwer do pliku mcp.json (w projekcie .vscode/mcp.json lub w konfiguracji użytkownika):

{
  "servers": {
    "klepsydry": {
      "type": "http",
      "url": "https://hourglasses.eu/mcp/TWOJ_KLUCZ"
    }
  }
}

W oknie Copilot Chat przełącz tryb na Agent i sprawdź w liście narzędzi, że pojawił się serwer „klepsydry”.

Zwykły Copilot w przeglądarce nie oferuje (według dostępnej nam dokumentacji) dodawania własnych serwerów MCP. Własne serwery obsługuje też Microsoft Copilot Studio (Narzędzia → Dodaj narzędzie → Model Context Protocol, uwierzytelnianie: brak).

Claude Code (terminal)

claude mcp add --transport http klepsydry https://hourglasses.eu/mcp/TWOJ_KLUCZ

Po dodaniu uruchom nową sesję i poproś o wyszukanie klepsydry.

Inny klient MCP

Serwer używa transportu streamable HTTP (JSON-RPC przez POST na jeden adres), bez strumieni SSE. Uwierzytelnianie nie jest osobnym nagłówkiem – klucz jest częścią adresu, więc w kliencie wybierz „bez uwierzytelniania”.

https://hourglasses.eu/mcp/TWOJ_KLUCZ

Test z linii poleceń (powinien zwrócić listę narzędzi):

curl -X POST -H "Content-Type: application/json" -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}' https://hourglasses.eu/mcp/TWOJ_KLUCZ

Limity i zasady

Klucz jest ważny 7 dni od wystawienia; potem wystaw nowy na tej stronie.
Do 600 wywołań narzędzi na minutę na klucz (wywołania obsługi protokołu się nie liczą). Pobranie zdjęć liczy się jak kilka wywołań. Po przekroczeniu narzędzie zwraca komunikat z czasem oczekiwania – wystarczy chwilę odczekać i ponowić.
Z jednego adresu IP można wystawić do 40 kluczy na dobę.
Sugestie: do 5 na dobę na klucz. Podawaj konkretne, rzeczowe informacje i źródło; reklamy i treści niezwiązane z klepsydrami będą odrzucane.

Bezpieczeństwo i prywatność

Adres z kluczem jest jak hasło. Nie publikuj go i nie wklejaj w publicznych miejscach. Gdy wycieknie, po prostu poczekaj do wygaśnięcia albo wystaw nowy i przestań używać starego – klucz publiczny daje tylko dostęp do danych, które i tak są na stronie.
Serwer nie pozwala niczego usuwać ani zmieniać. Jedyny zapis to sugestia, która trafia do moderacji.
Nie zapisujemy Twojego adresu IP – tylko jego nieodwracalny skrót, używany do limitów i ochrony przed nadużyciami. Zwykłe logi serwera WWW mogą natomiast zawierać adres zapytania.
Treści zwracane przez narzędzia są danymi, nie poleceniami – dobry asystent nie powinien wykonywać instrukcji znalezionych w opisach.

Rozwiązywanie problemów

Objaw	Co zrobić
Błąd 401 / „nieprawidłowy klucz”	Klucz wygasł, został wpisany z błędem albo ucięty (ma 43 znaki). Wystaw nowy na tej stronie i wklej cały adres.
„Limit przekroczony” (komunikat narzędzia lub błąd 429)	Odczekaj minutę i ponów. Poproś o mniej klepsydr lub zdjęć naraz – asystent nie powinien pobierać dziesiątek kart równocześnie.
Narzędzi nie widać w czacie	Włącz konektor w danej rozmowie (menu narzędzi), rozpocznij nową rozmowę albo odśwież listę narzędzi w ustawieniach konektora. W niektórych aplikacjach wymagany jest płatny plan lub tryb dewelopera.
Zdjęcia się nie wyświetlają	Nie każdy asystent pokazuje obrazy z narzędzi. W wynikach są adresy zdjęć i adres strony klepsydry – poproś asystenta: „pokaż zdjęcia jako obrazy”.
„Nie ma klepsydry … w publicznej kolekcji”	Pozycja jest niewidoczna na stronie (np. nie jest jeszcze opublikowana) albo numer jest błędny.