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 potrzeby zarządzania sekretami klienta.
claude mcp add wink-channel-manager https://integrations.wink.travel/mcp/channel-manager --transport httpclaude mcp add wink-rates https://api.wink.travel/mcp/extranet/rates --transport httpDlaczego narzędzia są podzielone na endpointy
Dział zatytułowany „Dlaczego narzędzia są podzielone na endpointy”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 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 faktyczne 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 zawiera słownictwo jednego zadania.
Katalog endpointów
Dział zatytułowany „Katalog endpointów”Dwa hosty obsługują zestawy narzędzi. Liczby narzędzi są przybliżone i rosną z czasem.
https://api.wink.travel — platforma
Dział zatytułowany „https://api.wink.travel — platforma”| Endpoint | 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: widgety, 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, 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: listy statyczne i dynamiczne, listy rankingowe, zapisane wyszukiwania, agregaty nieruchomości |
/mcp/link-manager | ~28 | Kolekcje linków syndykowanych, 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, geolokalizacje, 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
Dział zatytułowany „https://integrations.wink.travel — integracje channel managerów”Jeden endpoint, ponieważ ten host istnieje dla jednego zadania.
| Endpoint | Narzędzia | Co 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 prawdziwej pracy.
Jakie zestawy narzędzi są mi potrzebne?
Dział zatytułowany „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 |
| Budujesz doświadczenie rezerwacji | /mcp/booking-engine + /mcp/reference |
Zacznij od jednego. Dodaj kolejny, gdy zauważysz, że czegoś brakuje — każde połączenie jest niezależne i dodanie jednego nie wpływa na pozostałe.
Jak działa uwierzytelnianie
Dział zatytułowany „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:
- Twój klient AI odkrywa serwer autoryzacji z metadanych endpointu MCP
/.well-known/oauth-protected-resource. - Klient sam się rejestruje przez Dynamic Client Registration — nie jest potrzebna ręczna konfiguracja aplikacji.
- Klient otwiera kartę przeglądarki do
https://iam.wink.travel. Logujesz się na konto Wink i zatwierdzasz wymagane uprawnienia na ekranie zgody. - Wink wydaje token dostępu powiązany z Twoim kontem i tożsamością.
- Klient AI dołącza token do każdego żądania MCP. Wszystkie wyniki narzędzi są automatycznie ograniczone do Twojej jednostki zarządzającej.
- 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
Dział zatytułowany „Połącz swojego klienta AI”-
Upewnij się, że Claude Code jest aktualny:
Okno terminala npm install -g @anthropic-ai/claude-code -
Wybierz zestaw narzędzi z katalogu powyżej i dodaj go. Na przykład ceny i dostępność:
Okno terminala claude mcp add wink-rates https://api.wink.travel/mcp/extranet/rates --transport http -
Claude Code kontaktuje się z serwerem, odkrywa serwer autoryzacji i otwiera domyślną przeglądarkę.
-
Zaloguj się do Wink i zatwierdź żądanie uprawnień na ekranie zgody.
-
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 httpclaude mcp add wink-analytics https://api.wink.travel/mcp/analytics --transport httpLogujesz się tylko raz. Po pierwszym zatwierdzeniu w przeglądarce Claude Code ponownie używa Twojej sesji Wink dla kolejnych endpointów Wink.
-
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
- macOS:
-
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"}}} -
Całkowicie zamknij i uruchom ponownie Claude Desktop (użyj Quit z menu — samo zamknięcie okna nie wystarczy).
-
Claude Desktop otworzy kartę przeglądarki dla każdego nowego serwera. Zaloguj się do Wink i zatwierdź uprawnienia.
-
Ikona wtyczki na dolnym pasku narzędzi pokaże oba serwery jako połączone.
-
Upewnij się, że masz zainstalowany Codex CLI:
Okno terminala npm install -g @openai/codex -
Otwórz (lub utwórz) plik konfiguracyjny Codex:
- macOS / Linux:
~/.codex/config.json - Windows:
%USERPROFILE%\.codex\config.json
- macOS / Linux:
-
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"}}} -
Uruchom Codex. Przy pierwszym użyciu Codex otworzy kartę przeglądarki do
https://iam.wink.travel. -
Zaloguj się do Wink i zatwierdź wymagane uprawnienia.
-
Codex potwierdzi połączenie. Uruchom
codexi poproś o listę dostępnych narzędzi, aby zweryfikować aktywność serwerów Wink.
Wsparcie serwerów MCP jest dostępne w desktopowej aplikacji ChatGPT dla subskrybentów Plus, Pro, Team i Enterprise.
-
Pobierz i zainstaluj desktopową aplikację ChatGPT, jeśli jeszcze tego nie zrobiłeś.
-
Otwórz aplikację i kliknij ikonę profilu w prawym górnym rogu, następnie wybierz Ustawienia.
-
Przejdź do Connectors (lub MCP Servers w zależności od wersji aplikacji) i kliknij Dodaj.
-
Wprowadź URL zestawu narzędzi z katalogu powyżej, na przykład:
https://api.wink.travel/mcp/extranet/ratesNastępnie kliknij Połącz.
-
ChatGPT otworzy kartę przeglądarki do
https://iam.wink.travel. Zaloguj się do Wink i zatwierdź uprawnienia. -
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 -
Każdy zestaw narzędzi pojawi się na liście Connectors. Rozpocznij nową rozmowę — narzędzia Wink będą dostępne automatycznie.
-
Otwórz (lub utwórz) plik konfiguracyjny MCP Cursor:
- macOS / Linux:
~/.cursor/mcp.json - Windows:
%USERPROFILE%\.cursor\mcp.json
- macOS / Linux:
-
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"}}} -
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.
-
Cursor otworzy kartę przeglądarki do
https://iam.wink.travel. Zaloguj się do Wink i zatwierdź uprawnienia. -
Otwórz czat (
Ctrl+L/Cmd+L) i poproś Cursor o listę dostępnych narzędzi Wink, aby potwierdzić połączenie.
-
Otwórz (lub utwórz) plik konfiguracyjny MCP Windsurf:
- macOS / Linux:
~/.codeium/windsurf/mcp_config.json - Windows:
%USERPROFILE%\.codeium\windsurf\mcp_config.json
- macOS / Linux:
-
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"}}} -
Całkowicie zrestartuj Windsurf (Plik → Zakończ, potem uruchom ponownie).
-
Przejdź do Settings → MCP Servers i sprawdź, czy oba serwery są połączone. Windsurf otworzy kartę przeglądarki do
https://iam.wink.travelprzy pierwszym użyciu. -
Zaloguj się do Wink i zatwierdź uprawnienia. Serwery zmienią kolor na zielony w panelu ustawień po uwierzytelnieniu.
Cline to rozszerzenie VS Code z wbudowanym menedżerem serwerów MCP. Nie jest potrzebna ręczna edycja JSON.
-
Zainstaluj Cline z Marketplace VS Code:
- Otwórz VS Code i naciśnij
Ctrl+Shift+X/Cmd+Shift+X - Wyszukaj Cline i kliknij Zainstaluj
- Otwórz VS Code i naciśnij
-
Kliknij ikonę Cline na pasku aktywności (lewy pasek boczny), aby otworzyć panel Cline.
-
Kliknij ikonę MCP Servers (ikona wtyczki) na pasku narzędzi Cline, a następnie wybierz Edytuj ustawienia MCP.
-
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"}}} -
Zapisz plik. Cline przeładuje się automatycznie i otworzy kartę przeglądarki do
https://iam.wink.travel. -
Zaloguj się do Wink i zatwierdź uprawnienia. Oba serwery pojawią się jako aktywne w panelu MCP Servers.
Zakresy uprawnień
Dział zatytułowany „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.removesą dodatkowo wymagane do otwarcia transportu MCP. Klient posiadający zakresmcp.*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). - 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, do którego endpointu się łączysz, decyduje, które narzędzia są wymienione, a nie co im wolno robić. Połączenie z /mcp/payment nie daje żadnych dodatkowych uprawnień finansowych, a połączenie z /mcp/reference nie powstrzymuje narzędzia od wymuszania własnego zakresu. Autoryzacja jest decydowana przy wywołaniu narzędzia, na podstawie Twojego tokena i uprawnień konta.
Rozwiązywanie problemów
Dział zatytułowany „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 Codeclaude mcp remove wink-ratesclaude mcp add wink-rates https://api.wink.travel/mcp/extranet/rates --transport httpDla Claude Desktop i ChatGPT usuń wpis serwera w ustawieniach, 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 Twoje konto nie posiada. 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, 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 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 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
Taki endpoint 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 ceny nieruchomości, to osobne zadanie na osobnym endpointcie — patrz /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 nie jest widoczne
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 Ustawienia → 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 Plik → Zakończ i uruchom ponownie. Jeśli serwery nadal się nie pojawiają, upewnij się, że masz Windsurf w wersji 1.4+ (Pomoc → O Windsurf).
Opcja “Add Server” w Cline nie jest widoczna
Menedżer serwerów MCP wymaga Cline w wersji 2.0 lub nowszej. Otwórz panel rozszerzeń VS Code, znajdź Cline i kliknij Aktualizuj, 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
