Serwery MCP

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

Każdy punkt końcowy 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 potrzeby zarządzania sekretami klienta.

Integrator channel managera łączy się z jednym punktem końcowym

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

---

Dlaczego narzędzia są podzielone na punkty końcowe

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

Definicje narzędzi zajmują kontekst. Każde narzędzie, które serwer MCP reklamuje, jest ładowane do okna kontekstowego modelu przed wykonaniem jakiejkolwiek pracy, wraz z jego opisem i pełnym schematem parametrów. Pięćset takich narzędzi zużywa dużą część budżetu, którego potrzebuje Twoje rzeczywiste zadanie, przy każdym pojedynczym żą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 naprawdę 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 zawiera słownictwo jednego zadania.

Zestawy narzędzi to nie uprawnienia

Wybór wąskiego zestawu narzędzi nie ogranicza tego, co może zrobić Twoje konto, a wybór szerokiego nie daje nic dodatkowego. Każde narzędzie egzekwuje te same uprawnienia konta co portal internetowy, pod Twoją zalogowaną tożsamością. Jeśli Twoje konto nie może anulować rezerwacji w Wink Portal, agent też nie może — bez względu na to, do którego punktu końcowego jest podłączony.

Wybieraj zestawy narzędzi dla skupienia, nie dla bezpieczeństwa.

---

Katalog punktów końcowych

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

https://api.wink.travel — platforma

Punkt końcowy	Narzędzia	Co obejmuje
/mcp/extranet/facilities	~64	Rezerwowane i na miejscu zasoby: pokoje gościnne i typy pokoi, spa, restauracje, sale konferencyjne, atrakcje, miejsca, inne sprzedawalne elementy
/mcp/extranet/property	~62	Rekord nieruchomości i jej warunki handlowe: profil i zawartość, dodatki, polityki anulacji, korzyści, ogłoszenia
/mcp/settings	~60	Administracja kontem: profil i branding jednostki zarządzającej, menedżerowie i ich uprawnienia, personalizacja, webhooki, preferencje powiadomień
/mcp/studio/embeds	~48	Publikowanie wyselekcjonowanego zasobu: widżety, siatki i siatki rankingowe, karty, mapy, głębokie linki do zasobów i stron dostawców
/mcp/extranet/rates	~44	Ceny i dostępność: okresy i limity stawek zasobów, plany taryfowe, stawki główne, stawki specjalne i promocyjne
/mcp/extranet/operations	~39	Zarządzanie działającą nieruchomością: rezerwacje i ich cykl życia, opinie gości i odpowiedzi, kalendarze, zaplanowane zadania
/mcp/extranet/distribution	~37	Gdzie sprzedawany jest zasób: kanały sprzedaży i modyfikatory stawek, prośby o relacje afiliacyjne i dostawców, rejestracja, pozyskiwanie leadów
/mcp/studio/curation	~35	Tworzenie kolekcji handlowych: statyczne i dynamiczne listy, listy rankingowe, zapisane wyszukiwania, agregaty nieruchomości
/mcp/link-manager	~28	Syndykowane kolekcje linków, ich projekt, kategorie i tagi, oraz skrócone URL-e
/mcp/reference	~24	Dane do odczytu: kraje, waluty i kursy wymiany, języki, strefy czasowe, wyszukiwania geograficzne, geolokalizacja IP
/mcp/analytics	~18	Analizy rezerwacji i przychodów: przeglądy, wykresy liniowe, rankingi, wyniki afiliacji, metryki udziału
/mcp/payment	~18	Operacje 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	~17	Połączone konta społecznościowe, publikowanie i planowanie postów, odczyt statystyk postów
/mcp/travel-agent	~8	Rezerwacje realizowane przez agentów w imieniu podróżnych oraz raporty agentów

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

Jeden punkt końcowy, ponieważ ten host istnieje dla jednego zadania.

Punkt końcowy	Narzędzia	Co obejmuje
/mcp/channel-manager	~9	Łączenie i weryfikacja integracji channel managera, PMS lub CRS

Integracja channel managera a zarządzanie własnymi stawkami

To różne zadania dla różnych osób i nie dzielą punktu końcowego.

Dostawca channel managera, PMS lub CRS integruje się raz przez integrations.wink.travel/mcp/channel-manager, a następnie wymienia dane o nieruchomościach, stawkach, dostępności i rezerwacjach przez tę integrację. Ten pojedynczy punkt końcowy to cała powierzchnia.

Hotelarz zmieniający własne stawki ręcznie korzysta z zestawów narzędzi extranet na api.wink.travel — /mcp/extranet/rates i pokrewnych. Nie są one częścią integracji channel managera i integrator nie ma powodu, by się z nimi łączyć.

Administracja kontem jest również na api.wink.travel, pod /mcp/settings. Nie ma /mcp/settings na hoście integracji.

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

Płatności agentowe

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 potwierdzeń, gdy agentic booking i płatności są włączone dla danego środowiska. Zobacz Agentic Payments dla konfiguracji połączenia, uprawnień do wyboru i kroków od wyszukiwania do potwierdzenia.

---

Jakie zestawy narzędzi są mi potrzebne?

Jeśli jesteś…	Połącz się z
Integrujesz channel managera, PMS lub CRS	integrations.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 przepływ rezerwacji. Zapewnia odkrywanie konta i personalizacji, wyszukiwanie destynacji, dostępność hoteli i szczegóły stawek pokoi, koszyki, finalizację oraz zarządzanie rezerwacjami podróżnych. Narzędzia agentic booking i płatności są również dołączone, gdy są włączone dla danego środowiska.

Dla wyszukiwania hoteli w mieście użyj destination_lookup_search_suggestions do rozpoznania destynacji, a następnie 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 publiczna wiedza 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, a dodanie jednego nie wpływa na pozostałe.

Chcesz mieć wszystko?

https://api.wink.travel/mcp i https://integrations.wink.travel/mcp pozostają dostępne i obsługują wszystkie narzędzia na swoim hoście. Są przydatne do eksploracji dostępnych narzędzi, ale nie zalecamy ich do codziennej pracy: lista narzędzi jest na tyle duża, że przytłacza Twoje zadanie i pogarsza wybór narzędzi przez agenta. Preferuj powyższe zestawy narzędzi.

---

Jak działa uwierzytelnianie

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 /.well-known/oauth-protected-resource punktu końcowego MCP.
2. Klient sam się rejestruje przez Dynamic Client Registration — nie jest potrzebna ręczna konfiguracja aplikacji.
3. Klient otwiera kartę przeglądarki na 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.

---

Połącz swojego klienta AI

Claude Code

1. Upewnij się, że Claude Code jest aktualny:

   npm install -g @anthropic-ai/claude-code

2. Wybierz zestaw narzędzi z powyższego katalogu i dodaj go. Na przykład ceny i dostępność:

   claude mcp add wink-rates https://api.wink.travel/mcp/extranet/rates --transport http

3. Claude Code kontaktuje się z serwerem, odkrywa serwer autoryzacji i otwiera domyślną przeglądarkę.

4. Zaloguj się do Wink i zatwierdź żądanie uprawnień na ekranie zgody.

5. Claude Code potwierdza połączenie. Wpisz /mcp, aby zweryfikować, że serwer się pojawił i narzędzia zostały załadowane.

Dodaj tyle zestawów narzędzi, ile potrzebuje Twoja praca — każdy to osobny wpis serwera z własną nazwą:

claude mcp add wink-operations https://api.wink.travel/mcp/extranet/operations --transport http
claude mcp add wink-analytics  https://api.wink.travel/mcp/analytics           --transport http

Logujesz się tylko raz. Po pierwszej akceptacji w przeglądarce Claude Code ponownie używa Twojej sesji Wink dla kolejnych punktów końcowych Wink.

Udostępnij zespołowi

Dodaj --scope project do claude mcp add, a Claude Code zapisze URL serwera w .mcp.json w katalogu głównym repozytorium. Zacommituj ten plik — każdy członek zespołu otrzyma te same zestawy narzędzi, a każdy wykona własne logowanie w przeglądarce przy pierwszym połączeniu.

Claude Desktop

1. Edytuj plik konfiguracyjny Claude Desktop:

   • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
   • Windows: %APPDATA%\Claude\claude_desktop_config.json
   • Linux: ~/.config/Claude/claude_desktop_config.json

2. Dodaj wpisy serwerów MCP:

   claude_desktop_config.json

   {
     "mcpServers": {
       "wink-extranet-rates": {
         "type": "http",
         "url": "https://api.wink.travel/mcp/extranet/rates"
       },
       "wink-extranet-operations": {
         "type": "http",
         "url": "https://api.wink.travel/mcp/extranet/operations"
       }
     }
   }

3. Całkowicie zamknij i uruchom ponownie Claude Desktop (użyj Quit z paska menu — samo zamknięcie okna nie wystarczy).

4. Claude Desktop otwiera kartę przeglądarki dla każdego nowego serwera. Zaloguj się do Wink i zatwierdź uprawnienia.

5. Ikona wtyczki na dolnym pasku narzędzi pokazuje oba serwery jako połączone.

OpenAI Codex

1. Upewnij się, że masz zainstalowany Codex CLI:

   npm install -g @openai/codex

2. Otwórz (lub utwórz) plik konfiguracyjny Codex:

   • macOS / Linux: ~/.codex/config.json
   • Windows: %USERPROFILE%\.codex\config.json

3. Dodaj wpisy serwerów MCP Wink:

   ~/.codex/config.json

   {
     "mcpServers": {
       "wink-extranet-rates": {
         "type": "http",
         "url": "https://api.wink.travel/mcp/extranet/rates"
       },
       "wink-extranet-operations": {
         "type": "http",
         "url": "https://api.wink.travel/mcp/extranet/operations"
       }
     }
   }

4. Uruchom Codex. Przy pierwszym użyciu Codex otworzy kartę przeglądarki na https://iam.wink.travel.

5. Zaloguj się do Wink i zatwierdź wymagane uprawnienia.

6. Codex potwierdza połączenie. Uruchom codex i poproś o listę dostępnych narzędzi, aby zweryfikować, że serwery Wink są aktywne.

Notatka

Wsparcie MCP w Codex CLI wymaga wersji 1.0 lub nowszej. Sprawdź codex --version i zaktualizuj przez npm install -g @openai/codex.

ChatGPT

Wsparcie serwerów MCP jest dostępne w desktopowej aplikacji ChatGPT dla subskrybentów Plus, Pro, Team i Enterprise.

1. Pobierz i zainstaluj desktopową aplikację ChatGPT, jeśli jeszcze tego nie zrobiłeś.

2. Otwórz aplikację i kliknij ikonę profilu w prawym górnym rogu, następnie wybierz Ustawienia.

3. Przejdź do Connectors (lub MCP Servers w zależności od wersji aplikacji) i kliknij Dodaj.

4. Wprowadź URL zestawu narzędzi z powyższego katalogu, na przykład:

   https://api.wink.travel/mcp/extranet/rates

   Następnie kliknij Połącz.

5. ChatGPT otworzy kartę przeglądarki na https://iam.wink.travel. Zaloguj się do Wink i zatwierdź uprawnienia.

6. Powtórz kroki 4–5 dla innych zestawów narzędzi potrzebnych w Twojej pracy, na przykład:

   https://api.wink.travel/mcp/extranet/operations

7. Każdy zestaw narzędzi pojawi się na liście Connectors. Rozpocznij nową rozmowę — narzędzia Wink będą dostępne automatycznie.

Ograniczenie aplikacji webowej

Serwery MCP można konfigurować tylko w desktopowej aplikacji. Interfejs webowy ChatGPT na chatgpt.com nie obsługuje niestandardowych serwerów MCP.

Cursor

1. Otwórz (lub utwórz) plik konfiguracyjny MCP Cursor:

   • macOS / Linux: ~/.cursor/mcp.json
   • Windows: %USERPROFILE%\.cursor\mcp.json

2. Dodaj wpisy serwerów MCP Wink:

   ~/.cursor/mcp.json

   {
     "mcpServers": {
       "wink-extranet-rates": {
         "type": "http",
         "url": "https://api.wink.travel/mcp/extranet/rates"
       },
       "wink-extranet-operations": {
         "type": "http",
         "url": "https://api.wink.travel/mcp/extranet/operations"
       }
     }
   }

3. Otwórz Cursor. Przejdź do Settings → Cursor Settings → MCP i potwierdź, że oba serwery mają zielony wskaźnik statusu. Jeśli pokazują czerwony, kliknij Refresh.

4. Cursor otworzy kartę przeglądarki na https://iam.wink.travel. Zaloguj się do Wink i zatwierdź uprawnienia.

5. Otwórz czat (Ctrl+L / Cmd+L) i poproś Cursor o listę dostępnych narzędzi Wink, aby potwierdzić połączenie.

Konfiguracja na poziomie projektu

Możesz też umieścić plik mcp.json w katalogu głównym projektu zamiast w ~/.cursor/. Konfiguracja na poziomie projektu ma pierwszeństwo i udostępnia serwery każdemu członkowi zespołu, który otworzy projekt w Cursor.

Windsurf

1. Otwórz (lub utwórz) plik konfiguracyjny MCP Windsurf:

   • macOS / Linux: ~/.codeium/windsurf/mcp_config.json
   • Windows: %USERPROFILE%\.codeium\windsurf\mcp_config.json

2. Dodaj wpisy serwerów MCP Wink:

   ~/.codeium/windsurf/mcp_config.json

   {
     "mcpServers": {
       "wink-extranet-rates": {
         "type": "http",
         "url": "https://api.wink.travel/mcp/extranet/rates"
       },
       "wink-extranet-operations": {
         "type": "http",
         "url": "https://api.wink.travel/mcp/extranet/operations"
       }
     }
   }

3. Całkowicie zrestartuj Windsurf (Plik → Quit, potem ponownie uruchom).

4. Przejdź do Settings → MCP Servers i sprawdź, czy oba serwery są połączone. Windsurf otwiera kartę przeglądarki na https://iam.wink.travel przy pierwszym użyciu.

5. Zaloguj się do Wink i zatwierdź uprawnienia. Serwery zmienią kolor na zielony w panelu ustawień po uwierzytelnieniu.

Notatka

Wsparcie MCP w Windsurf wymaga wersji 1.4 lub nowszej. Sprawdź w Help → About Windsurf i zaktualizuj ze strony Windsurf, jeśli to konieczne.

Cline (VS Code)

Cline to rozszerzenie VS Code z wbudowanym menedżerem serwerów MCP. Nie jest potrzebna ręczna edycja JSON.

1. Zainstaluj Cline z Marketplace VS Code:

   • Otwórz VS Code i naciśnij Ctrl+Shift+X / Cmd+Shift+X
   • Wyszukaj Cline i kliknij Install

2. Kliknij ikonę Cline na pasku aktywności (lewy pasek boczny), aby otworzyć panel Cline.

3. Kliknij ikonę MCP Servers (ikona wtyczki) na pasku narzędzi Cline, następnie wybierz Edit MCP Settings.

4. VS Code otworzy cline_mcp_settings.json. Dodaj wpisy Wink:

   cline_mcp_settings.json

   {
     "mcpServers": {
       "wink-extranet-rates": {
         "type": "http",
         "url": "https://api.wink.travel/mcp/extranet/rates"
       },
       "wink-extranet-operations": {
         "type": "http",
         "url": "https://api.wink.travel/mcp/extranet/operations"
       }
     }
   }

5. Zapisz plik. Cline przeładuje się automatycznie i otworzy kartę przeglądarki na https://iam.wink.travel.

6. Zaloguj się do Wink i zatwierdź uprawnienia. Oba serwery pojawią się jako aktywne w panelu MCP Servers.

Alternatywa: dodaj przez URL

W panelu MCP Servers kliknij Add Server i wklej bezpośrednio URL zestawu narzędzi, np. https://api.wink.travel/mcp/extranet/rates. Cline automatycznie uzupełni konfigurację i obsłuży uwierzytelnianie bez ręcznej edycji JSON.

---

Zakresy uprawnień

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

Dwie 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 punktu końcowego Wink MCP, ale każde wywołanie narzędzia nadal egzekwuje zakres sekcji punktu końcowego, który opakowuje (np. booking.read).
• 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ą. To punkt końcowy, 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 wcześniej nie miałeś, a połączenie z /mcp/reference nie powstrzymuje narzędzia od egzekwowania własnego zakresu. Autoryzacja jest decydowana dla każdego wywołania narzędzia na podstawie Twojego tokena i uprawnień konta.

---

Rozwiązywanie problemów

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:

# 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ń, zrestartuj aplikację i dodaj go ponownie.

403 Forbidden przy wywołaniu konkretnego narzędzia

Narzędzie wymaga zakresu, którego nie zatwierdziłeś na ekranie zgody, lub uprawnienia, którego nie ma Twoje konto. Połącz serwer ponownie — ekran zgody pojawi się ponownie 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, ponieważ zestawy nie przyznają 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 punktów końcowych i dodaj odpowiedni zestaw — połączenia są niezależne, więc dodanie jednego nie zmienia 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 punkcie końcowym 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: nieautoryzowane żądanie do dowolnej ścieżki pod /mcp zwraca 401, nie 404, więc sam 401 nie oznacza, czy punkt końcowy istnieje.

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

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

Serwer się pojawia, 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 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”

Sprawdź, 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 pojawiają się 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 się nie pojawiają, upewnij się, że masz Windsurf w wersji 1.4+ (sprawdź w Help → About Windsurf).

Opcja “Add Server” w Cline jest niewidoczna

Menedżer serwerów MCP wymaga Cline w wersji 2.0 lub nowszej. 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