Przejdź do głównej zawartości

Serwery MCP

Narzędzia MCP Wink są udostępniane jako zestawy narzędzi — wyspecjalizowane endpointy, z których każdy obejmuje jedno zadanie. Łączysz swojego klienta AI z jednym lub dwoma, które odpowiadają Twojej pracy, a nie ze wszystkimi.

Każdy endpoint korzysta z interaktywnego logowania OAuth2 (PKCE authorization code flow): Twój agent AI otwiera kartę przeglądarki, logujesz się na swoje konto Wink i to wszystko. Nie ma sekretów klienta do zarządzania.

Integrator channel managera łączy się z jednym endpointem
claude mcp add wink-channel-manager https://integrations.wink.travel/mcp/channel-manager --transport http
Hotelarz zarządzający własnymi stawkami łączy się z innym
claude mcp add wink-rates https://api.wink.travel/mcp/extranet/rates --transport http

Wink udostępnia około 500 narzędzi. Przekazanie ich wszystkich agentowi naraz jest technicznie możliwe — ale złym pomysłem.

Definicje narzędzi kosztują kontekst. Każde narzędzie reklamowane przez serwer MCP jest ładowane do okna kontekstowego modelu przed wykonaniem pracy, wraz z opisem i pełnym schematem parametrów. Pięćset takich narzędzi pochłania dużą część budżetu, którego potrzebuje Twoje rzeczywiste zadanie, przy każdym żądaniu.

Jakość wyboru spada wraz z długością listy. Agent wybierający spośród 500 podobnie nazwanych narzędzi podejmuje gorsze decyzje niż ten wybierający spośród 40. Jeśli integrujesz channel managera, około dwadzieścia narzędzi jest dla Ciebie istotnych; pozostałe 480 to szum utrudniający znalezienie właściwego narzędzia.

Praca jest faktycznie podzielna. Ktoś synchronizujący dostępność z PMS i ktoś tworzący strony afiliacyjne prawie nie dzielą narzędzi. Podział według zadania oznacza, że każde połączenie niesie słownictwo jednego zadania.


Dwa hosty obsługują zestawy narzędzi. Liczby narzędzi są przybliżone i rosną z czasem.

EndpointNarzędziaCo obejmuje
/mcp/extranet/facilities~64Rezerwowany i dostępny na miejscu inwentarz: pokoje gościnne i typy pokoi, spa, restauracje, sale konferencyjne, atrakcje, miejsca, inne sprzedawalne elementy
/mcp/extranet/property~62Rekord nieruchomości i jej warunki handlowe: profil i zawartość, dodatki, polityki anulacji, korzyści, ogłoszenia
/mcp/settings~60Administracja kontem: profil i branding jednostki zarządzającej, menedżerowie i ich uprawnienia, personalizacja, webhooki, preferencje powiadomień
/mcp/studio/embeds~48Publikowanie wyselekcjonowanego inwentarza: widgety, siatki i siatki rankingowe, karty, mapy, głębokie linki do inwentarza i stron dostawców
/mcp/extranet/rates~44Ceny i dostępność: okresy i limity stawek inwentarza, plany taryfowe, stawki główne, stawki specjalne i promocyjne
/mcp/extranet/operations~39Zarządzanie działającą nieruchomością: rezerwacje i ich cykl życia, opinie gości i odpowiedzi, kalendarze, zaplanowane zadania
/mcp/extranet/distribution~37Gdzie sprzedawany jest inwentarz: kanały sprzedaży i modyfikatory stawek, prośby o relacje afiliacyjne i dostawców, rejestracja, pozyskiwanie leadów
/mcp/studio/curation~35Tworzenie kolekcji do sprzedaży: statyczne i dynamiczne listy, listy rankingowe, zapisane wyszukiwania, agregaty nieruchomości
/mcp/link-manager~28Kolekcje linków syndykowanych, ich projekt, kategorie i tagi, plus skrócone URL-e
/mcp/reference~24Dane do odczytu: kraje, waluty i kursy wymiany, języki, strefy czasowe, wyszukiwania geograficzne, geolokalizacja IP
/mcp/analytics~18Analizy rezerwacji i przychodów: przeglądy, wykresy liniowe, rankingi, wyniki afiliacji, metryki udziału
/mcp/payment~18Operacje finansowe: księga, wypłaty i szacunki opłat, agregaty środków rezerwacyjnych
/mcp/booking-engine~17Ścieżka zakupowa dla podróżnych: wyszukiwanie i odczyt, koszyk i finalizacja, listy życzeń, personalizacja kampanii
/mcp/social~17Połączone konta społecznościowe, publikowanie i planowanie postów, odczyt statystyk postów
/mcp/travel-agent~8Rezerwacje realizowane przez agentów w imieniu podróżnych oraz raporty agentów

https://integrations.wink.travel — integracje channel managerów

Dział zatytułowany „https://integrations.wink.travel — integracje channel managerów”

Jeden endpoint, ponieważ ten host istnieje dla jednego zadania.

EndpointNarzędziaCo obejmuje
/mcp/channel-manager~9Łączenie i weryfikacja integracji channel managera, PMS lub CRS

Każdy endpoint ma też narzędzie ping, aby potwierdzić, że połączenie jest aktywne przed wykonaniem rzeczywistej pracy.

Dla kompletnego procesu rezerwacji podróżnego połącz Wink Booking Engine pod https://api.wink.travel/mcp/booking-engine oraz kompatybilny portfel płatniczy. Dodanie MCP Wink otwiera logowanie w przeglądarce i wybór uprawnień; Twój klient następnie obsługuje uwierzytelnianie.

Booking Engine zawiera wyszukiwanie destynacji, wyszukiwanie hoteli i pokoi, agentic_booking_quote, agentic_booking_pay, agentic_booking_book, pobieranie rezerwacji i potwierdzenia, gdy agentic booking i płatności są włączone dla tego środowiska. Zobacz Agentic Payments dla konfiguracji połączenia, uprawnień do wyboru i kroków od wyszukiwania do potwierdzenia.


Jeśli jesteś…Połącz się z
Integrujesz channel managera, PMS lub CRSintegrations.wink.travel/mcp/channel-manager — tylko ten
Zarządzasz zawartością nieruchomości/mcp/extranet/property + /mcp/extranet/facilities
Zarządzasz pokojami i typami pokoi/mcp/extranet/facilities
Zarządzasz cenami i dostępnością/mcp/extranet/rates
Prowadzisz codzienne rezerwacje/mcp/extranet/operations
Rozwijasz dystrybucję/mcp/extranet/distribution + /mcp/analytics
Tworzysz strony afiliacyjne/mcp/studio/curation + /mcp/studio/embeds
Prowadzisz strony link-in-bio/mcp/link-manager + /mcp/social
Rezerwujesz w imieniu podróżnych/mcp/travel-agent
Rozliczasz pieniądze/mcp/payment
Rezerwujesz pokój z agentem AI/mcp/booking-engine + kompatybilny portfel płatniczy — zobacz Agentic Payments
Budujesz doświadczenie rezerwacji/mcp/booking-engine; opcjonalnie /mcp/reference dla dodatkowych wyszukiwań

Booking Engine zawiera podstawowy workflow rezerwacji. Zapewnia odkrywanie konta i personalizację, wyszukiwanie destynacji, dostępność hoteli i szczegóły stawek pokoi, koszyki, finalizację i zarządzanie rezerwacjami podróżnych. Narzędzia agentic booking i płatności są również włączone, gdy aktywne dla tego środowiska.

Dla wyszukiwania hoteli w mieście użyj destination_lookup_search_suggestions do rozpoznania destynacji, potem inventory_search_city do znalezienia dostępnych hoteli i stawek. Oba narzędzia są w /mcp/booking-engine, więc ten przepływ nie wymaga połączenia z Reference.

Dodaj /mcp/reference, gdy potrzebujesz wspierających wyszukiwań, takich jak kraje, waluty i kursy wymiany, obsługiwane języki, strefy czasowe, szersze wyszukiwania geograficzne, klasyfikacje OTA lub publiczną wiedzę o nieruchomościach. To opcjonalne dodatki do przepływu rezerwacji.

Zacznij od jednego. Dodaj kolejny, gdy zauważysz, że czegoś nie potrafi — każde połączenie jest niezależne i dodanie jednego nie wpływa na pozostałe.


Serwery MCP Wink używają przepływu OAuth2 Authorization Code + PKCE i wspierają Dynamic Client Registration (RFC 7591). Oto co się dzieje przy pierwszym połączeniu:

  1. Twój klient AI odkrywa serwer autoryzacji z metadanych endpointu MCP /.well-known/oauth-protected-resource.
  2. Klient sam się rejestruje przez Dynamic Client Registration — nie jest potrzebna ręczna konfiguracja aplikacji.
  3. Klient otwiera kartę przeglądarki pod https://iam.wink.travel. Logujesz się na konto Wink i zatwierdzasz wymagane uprawnienia na ekranie zgody.
  4. Wink wydaje token dostępu powiązany z Twoim kontem i tożsamością.
  5. Klient AI dołącza token do każdego żądania MCP. Wszystkie wyniki narzędzi są automatycznie ograniczone do Twojej jednostki zarządzającej.
  6. Tokeny wygasają po 3 godzinach. Twój klient AI odświeża je cicho w tle bez ponownego pytania.

Każde wywołanie narzędzia działa pod Twoją tożsamością — te same zasady ACL, które chronią portal internetowy, obowiązują agenta AI.


Dodaj każdy zestaw narzędzi do Claude jako niestandardowy konektor. Nie ma pliku konfiguracyjnego do edycji ani aplikacji czy sekretu do tworzenia.

  1. W Claude otwórz Customize › Connectors, kliknij Add, potem Add custom connector.

  2. Wpisz Nazwa (np. Wink Link manager) i jako URL serwera MCP podaj zestaw narzędzi z katalogu powyżej, np.:

    https://api.wink.travel/mcp/link-manager

    Kliknij Continue.

  3. Claude wykrywa logowanie Wink. Zachowaj Authentication: Sign in now i OAuth client: Register automatically, następnie kliknij Add.

  4. Kliknij Connect. Otworzy się strona logowania Wink pod https://iam.wink.travel. Zaloguj się do Wink i zatwierdź uprawnienia na ekranie zgody.

  5. Narzędzia konektora są teraz dostępne w Twoich czatach. Powtórz dla każdego zestawu narzędzi potrzebnego w pracy; każdy jest osobnym konektorem.


Po zatwierdzeniu ekranu zgody zobaczysz podział żądań agenta. Klienci MCP używają tego samego słownictwa uprawnień co reszta platformy — zobacz pełny referencyjny zakres na stronie Uwierzytelniania.

Trzy rzeczy są specyficzne dla MCP:

  • Zakresy mcp.read, mcp.write, mcp.remove są dodatkowo wymagane do otwarcia transportu MCP. Klient posiadający zakres mcp.* ma dostęp do dowolnego endpointu MCP Wink, ale każde wywołanie narzędzia nadal wymusza zakres sekcji endpointu, który opakowuje (np. booking.read).
  • MCP zawsze działa jako zalogowany użytkownik. Klient AI otrzymuje zakresy mcp.* przez Twoje logowanie, nigdy z Aplikacji, którą tworzysz. Tokeny maszynowe (client-credentials) nie mogą otworzyć transportu MCP; do pracy serwer-serwer używaj REST API.
  • Klient AI żąda tylko potrzebnych zakresów. Możesz odmówić pojedynczych uprawnień na ekranie zgody — narzędzia wymagające odmówionego zakresu zwrócą błąd przy wywołaniu.

Zestawy narzędzi tego nie zmieniają. Endpoint, do którego się łączysz, decyduje, które narzędzia są wymienione, a nie co mogą wykonywać. Połączenie z /mcp/payment nie daje żadnych dodatkowych uprawnień finansowych, których już nie masz, a połączenie z /mcp/reference nie powstrzymuje narzędzia od wymuszania własnego zakresu. Autoryzacja jest decydowana przy każdym wywołaniu narzędzia, na podstawie Twojego tokena i uprawnień konta.


Karta przeglądarki się nie otwiera

Twój klient AI może jeszcze nie wspierać interaktywnego przepływu PKCE. Sprawdź, czy masz najnowszą wersję:

  • Claude Code: npm install -g @anthropic-ai/claude-code
  • Codex CLI: npm install -g @openai/codex
  • Claude Desktop / ChatGPT desktop: zaktualizuj przez wbudowany updater aplikacji

401 Unauthorized po zalogowaniu

Twój zapisany token może być nieaktualny. Usuń i dodaj ponownie serwer, aby wymusić nowe logowanie:

Okno terminala
# Claude Code
claude mcp remove wink-rates
claude mcp add wink-rates https://api.wink.travel/mcp/extranet/rates --transport http

Dla Claude Desktop i ChatGPT usuń wpis serwera z ustawień, uruchom aplikację ponownie i dodaj serwer jeszcze raz.

403 Forbidden przy wywołaniu konkretnego narzędzia

Narzędzie wymaga zakresu, którego nie zatwierdziłeś na ekranie zgody, lub uprawnienia, którego Twoje konto nie posiada. Połącz serwer ponownie — ekran zgody pojawi się jeszcze raz i możesz zatwierdzić brakujące uprawnienie. Jeśli nadal nie działa, narzędzie wymaga uprawnienia konta, którego nie masz; połączenie z innym zestawem narzędzi nie pomoże, bo zestawy nie nadają uprawnień.

Narzędzie, którego potrzebuję, nie jest na liście

Prawdopodobnie jesteś połączony z zestawem narzędzi, który nie obejmuje tego zadania. Sprawdź katalog endpointów i dodaj odpowiedni zestaw — połączenia są niezależne, więc dodanie jednego nic nie zmienia w innych. Jeśli nie wiesz, który ma to narzędzie, połącz się tymczasowo z https://api.wink.travel/mcp, znajdź narzędzie, a potem sprawdź, który zestaw je zawiera.

404 Not Found na endpointzie zestawu narzędzi

Sprawdź dokładnie ścieżkę — zagnieżdżone zestawy mają dwa segmenty (/mcp/extranet/rates, nie /mcp/extranet-rates), a płaskie mają jeden (/mcp/link-manager). Uwaga, że niezalogowane żądanie do dowolnej ścieżki pod /mcp zwraca 401, nie 404, więc sam 401 nie mówi, czy endpoint istnieje.

Połączyłem się z api.wink.travel/mcp/channel-manager i nic nie dostałem

Ten endpoint nie istnieje. Integracja channel managera jest obsługiwana tylko z https://integrations.wink.travel/mcp/channel-manager. Jeśli potrzebujesz też czytać lub pisać własne stawki nieruchomości ręcznie, to osobne zadanie na osobnym endpointcie — zobacz /mcp/extranet/rates.

Serwer jest widoczny, ale wywołania narzędzi zwracają “konto nie znalezione”

Jesteś zalogowany na konto Wink, które nie ma jednostki zarządzającej. Wejdź na Wink Portal i upewnij się, że Twoje konto jest poprawnie skonfigurowane przed użyciem serwera MCP.

Token wygasa w trakcie sesji

Tokeny są ważne przez 3 godziny. Claude Code i Claude Desktop odświeżają tokeny cicho bez przerywania sesji. Jeśli po długim bezczynności pojawią się błędy uwierzytelniania, wpisz nową wiadomość — klient automatycznie się ponownie uwierzytelni.

Codex CLI pokazuje “MCP server unreachable”

Sprawdź, czy Twój ~/.codex/config.json jest poprawnym JSON-em (bez przecinków na końcu) i czy "type": "http" jest ustawione. Codex wymaga transportu HTTP dla serwerów zdalnych; transport stdio jest tylko dla lokalnych binariów.

Menu “Connectors” w ChatGPT jest niedostępne

Wsparcie MCP wymaga wersji aplikacji desktopowej ChatGPT 1.2024.352 lub nowszej oraz aktywnej subskrypcji Plus, Pro, Team lub Enterprise. Zaktualizuj aplikację i sprawdź plan w Ustawieniach → Konto.

Serwer Cursor pokazuje czerwony / “Failed to connect”

Zweryfikuj, czy Twój ~/.cursor/mcp.json jest poprawnym JSON-em i zawiera "type": "http". Następnie przejdź do Settings → Cursor Settings → MCP i kliknij Refresh. Jeśli błąd się utrzymuje, całkowicie zrestartuj Cursor — zmiany konfiguracji nie zawsze są wykrywane bez restartu.

Serwery MCP Windsurf nie są widoczne w ustawieniach

Windsurf wymaga pełnego restartu (nie tylko przeładowania okna), aby wykryć zmiany w mcp_config.json. Użyj File → Quit i uruchom ponownie. Jeśli serwery nadal nie są widoczne, upewnij się, że masz Windsurf 1.4+ w Help → About Windsurf.

Opcja “Add Server” w Cline jest niewidoczna

Menedżer serwerów MCP wymaga Cline 2.0 lub nowszego. Otwórz panel rozszerzeń VS Code, znajdź Cline i kliknij Update, jeśli jest dostępna aktualizacja. Po aktualizacji przeładuj VS Code (Ctrl+Shift+P → “Developer: Reload Window”).


Otwórz Wink Portal Wink na GitHub