Refindi · Lost & Found dla hoteli i obiektów

Refindi dla agentów AI (MCP)

Publiczny serwer MCP, dzięki któremu asystent AI może pomóc gościowi odzyskać rzecz zostawioną w hotelu lub innym obiekcie: wyjaśnić usługę, znaleźć właściwy obiekt, zebrać informacje „co, kiedy, gdzie” i podać link do formularza Refindi. Zgłoszenie, dane kontaktowe, akceptacja regulaminu i płatność odbywają się na refindi.com.

Endpoint

Adres MCP: https://ai.refindi.com/mcp
Transport: Streamable HTTP (JSON-RPC przez HTTPS POST), tryb bezstanowy, odpowiedzi JSON
Uwierzytelnianie: brak — narzędzia publiczne, tylko do odczytu
Stan usługi: https://ai.refindi.com/health (dostępność i świeżość danych)
Dokumentacja tekstowa: https://ai.refindi.com/llms.txt

Jak podłączyć

Klient MCP musi obsługiwać transport Streamable HTTP. Wpisz adres endpointu w ustawieniach klienta albo poproś asystenta: „Dodaj serwer MCP Refindi: https://ai.refindi.com/mcp”.

Konfiguracja JSON (Cursor, Windsurf i większość klientów desktopowych)

{
  "mcpServers": {
    "refindi": { "type": "http", "url": "https://ai.refindi.com/mcp" }
  }
}

Claude Code

claude mcp add --transport http refindi https://ai.refindi.com/mcp

Claude.ai / Claude Desktop

Ustawienia → Connectors → Add custom connector → adres https://ai.refindi.com/mcp, bez uwierzytelniania.

ChatGPT (tryb deweloperski / własny konektor)

Dodaj serwer MCP z adresem https://ai.refindi.com/mcp, bez uwierzytelniania.

Szybki test z linii poleceń

curl -s https://ai.refindi.com/mcp \
  -H 'Content-Type: application/json' \
  -H 'Accept: application/json, text/event-stream' \
  -d '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2025-06-18","capabilities":{},"clientInfo":{"name":"curl","version":"0"}}}'

Narzędzia

Wszystkie narzędzia są tylko do odczytu i nie mają skutków ubocznych. Każda odpowiedź zawiera structuredContent, czytelne summary, informację o użytym języku oraz źródło danych z datą aktualizacji. Błędy mają jawne kody: invalid_input, location_not_found, temporarily_unavailable.

Narzędzie	Parametry	Co zwraca
`get_service_info`	`locale?`	Jak działa Refindi, kolejne kroki, co przygotować, zasady kosztów (bez kwot), wysyłka, wyjątki, linki do stron źródłowych.
`search_locations`	`query`, `city?`, `country?`, `limit?`, `locale?`	Kandydaci z publicznego katalogu obiektów: stabilny `location_id`, nazwa, adres, typ, czy partner, link do zgłoszenia. Flaga `ambiguous`, gdy trzeba zapytać użytkownika o wybór.
`get_location_details`	`location_id`, `locale?`	Publiczne informacje o obiekcie i sposób rozpoczęcia zgłoszenia. Bez magazynu rzeczy i danych personelu.
`get_claim_instructions`	`location_id?`, `item_category?`, `locale?`	Checklista (co, gdzie, kiedy, kontakt), postępowanie gdy użytkownik nie pamięta miejsca, reguła dla przedmiotu ze słownika Refindi (np. dokumenty tożsamości i gotówka nie są wysyłane).
`get_claim_start_link`	`location_id?`, `locale?`	Kanoniczny adres formularza i komunikat „Otwórz link, aby uzupełnić i wysłać zgłoszenie”. Nie tworzy zgłoszenia, nie wysyła powiadomień, nie zamawia kuriera; bez danych osobowych w URL.

Zalecana kolejność: get_service_info → search_locations → get_claim_instructions → get_claim_start_link. Parametr locale to tag BCP 47; teksty są po polsku i angielsku (inne języki dostają angielski), linki w 22 językach strony refindi.com.

Scenariusze użycia

„Zostawiłem czarne słuchawki w hotelu X w Warszawie wczoraj.” Agent wyszukuje obiekt, pokazuje kandydatów do potwierdzenia, pomaga doprecyzować opis i podaje link do rozpoczęcia zgłoszenia. Nie mówi, że rzecz została znaleziona ani że zgłoszenie wysłano.
„Nie pamiętam, w którym hotelu to zostawiłem.” Agent pyta o miasto i przedział czasu, pokazuje obiekty z katalogu i kieruje do kreatora, w którym można wskazać kilka możliwych miejsc.
„Zgubiłem paszport.” Agent sprawdza regułę dla przedmiotu: dokumenty tożsamości nie są wysyłane przesyłką i trafiają do właściwych organów; podaje, gdzie szukać pomocy.
„Ile to kosztuje?” Agent wyjaśnia, że zgłoszenie jest bezpłatne, a koszt zwrotu to wycena przesyłki akceptowana przed wysyłką, i linkuje regulamin. Nie podaje kwot.

Dane i prywatność

Serwer udostępnia wyłącznie publiczne dane obiektów (nazwa, adres, typ, czy partner) i publiczne zasady usługi. Katalog odświeża się co ok. 10 minut; każda odpowiedź niesie datę aktualizacji i flagę stale, gdy dane mogą być nieaktualne.
Nie ma dostępu do rzeczy znalezionych, zdjęć, cech potwierdzających własność, danych gości, numerów pokoi, statusów spraw ani płatności. Znajomość numeru sprawy nie daje dostępu do sprawy — status jest dostępny tylko z linków w e-mailach od Refindi.
Nie da się anonimowo utworzyć zgłoszenia, uruchomić płatności ani wysyłki. Serwer nie ma operacji zapisu.
Logujemy metadane wywołań (narzędzie, status, kod błędu, czas, liczba wyników, wersja danych, język). Nie logujemy treści wyszukiwań, opisów zgub, danych kontaktowych ani treści żądań.
Zasady przetwarzania danych: polityka prywatności, regulamin serwisu.

Kontakt

Refindi Sp. z o.o. · https://refindi.com/pl/kontakt · info@refindi.com · strona główna: https://refindi.com/

English summary

Public, read-only MCP server (Streamable HTTP, no authentication) that lets an AI agent help a guest recover an item left at a hotel or venue: explain the Refindi service, find the venue in the public catalogue, prepare the claim (what / where / when / contact) and hand over the link to the existing Refindi form. The claim itself, contact details, acceptance of terms and payment happen on refindi.com.

Endpoint: https://ai.refindi.com/mcp
Tools: get_service_info, search_locations, get_location_details, get_claim_instructions, get_claim_start_link
Languages: locale as BCP 47; texts in Polish and English, links in the 22 site languages
Privacy: no found-item inventory, guest data or private case status; metadata-only analytics
Docs: llms.txt with parameters, examples and client configuration