MCP Servery
Nástroje MCP od Wink sú zverejnené ako toolsety — zamerané endpointy, z ktorých každý pokrýva jednu úlohu. Pripojíte svoj AI klient k jednému alebo dvom, ktoré zodpovedajú vašej práci, nie ku všetkým.
Každý endpoint používa interaktívne OAuth2 prihlásenie (PKCE authorization code flow): váš AI agent otvorí kartu prehliadača, prihlásite sa so svojím účtom Wink a to je všetko. Žiadne spravovanie klientskych tajomstiev.
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 httpPrečo sú nástroje rozdelené do viacerých endpointov
Section titled “Prečo sú nástroje rozdelené do viacerých endpointov”Wink sprístupňuje približne 500 nástrojov. Odovzdanie všetkých naraz agentovi je technicky možné — a zlý nápad.
Definície nástrojov stoja kontext. Každý nástroj, ktorý MCP server inzeruje, sa načíta do kontextového okna modelu predtým, než vykoná akúkoľvek prácu, spolu s jeho popisom a kompletnou schémou parametrov. Päťsto takýchto nástrojov spotrebuje veľkú časť rozpočtu, ktorý vaša skutočná úloha potrebuje, pri každom jednom požiadavku.
Kvalita výberu klesá so zväčšujúcim sa zoznamom. Agent vyberajúci z 500 podobne nazvaných nástrojov robí horšie rozhodnutia než ten, ktorý vyberá z 40. Ak integrujete channel manager, približne dvadsať nástrojov je pre vás relevantných; ostatných 480 je šum, ktorý sťažuje nájdenie správneho nástroja.
Práca je skutočne oddeliteľná. Niekto, kto synchronizuje dostupnosť z PMS, a niekto, kto spravuje affiliate landing pages, zdieľajú takmer žiadne nástroje. Rozdelenie podľa úlohy znamená, že každé pripojenie nesie slovník jednej úlohy.
Adresár endpointov
Section titled “Adresár endpointov”Dva hostitelia poskytujú toolsety. Počty nástrojov sú približné a časom rastú.
https://api.wink.travel — platforma
Section titled “https://api.wink.travel — platforma”| Endpoint | Nástroje | Čo pokrýva |
|---|---|---|
/mcp/extranet/facilities | ~64 | Rezervovateľný a na mieste dostupný inventár: hosťovské izby a typy izieb, kúpele, reštaurácie, zasadacie miestnosti, aktivity, atrakcie, miesta, iné predajné položky |
/mcp/extranet/property | ~62 | Záznam o nehnuteľnosti a jej obchodné podmienky: profil a obsah, doplnky, storno podmienky, výhody, oznámenia |
/mcp/settings | ~60 | Správa účtu: profil a branding spravujúcej entity, manažéri a ich oprávnenia, prispôsobenie, webhooks, preferencie notifikácií |
/mcp/studio/embeds | ~48 | Publikovanie kurátorského inventára: widgety, mriežky a zoradené mriežky, karty, mapy, hlboké odkazy na inventár a stránky dodávateľov |
/mcp/extranet/rates | ~44 | Ceny a dostupnosť: obdobia a alokácie cien inventára, cenové plány, hlavné ceny, špeciálne a promo ceny |
/mcp/extranet/operations | ~39 | Prevádzka živej nehnuteľnosti: rezervácie a ich životný cyklus, recenzie hostí a odpovede, kalendárové feedy, plánované úlohy |
/mcp/extranet/distribution | ~37 | Kde sa inventár predáva: predajné kanály a modifikátory cien, žiadosti o vzťahy s affiliate a dodávateľmi, registrácia, zachytávanie leadov |
/mcp/studio/curation | ~35 | Budovanie kolekcií na predaj: statické a dynamické zoznamy, zoradené zoznamy, uložené vyhľadávania, agregáty nehnuteľností |
/mcp/link-manager | ~28 | Syndikované kolekcie odkazov, ich dizajn, kategórie a tagy, plus skrátené URL |
/mcp/reference | ~24 | Iba na čítanie vyhľadávacie údaje: krajiny, meny a výmenné kurzy, jazyky, časové pásma, geo vyhľadávania, IP geolokácia |
/mcp/analytics | ~18 | Analytika rezervácií a príjmov: prehľady, čiarové grafy, rebríčky, výkonnosť affiliate, metriky zdieľania |
/mcp/payment | ~18 | Finančné operácie: účtovná kniha, výbery a odhady poplatkov, agregáty finančných prostriedkov rezervácií |
/mcp/booking-engine | ~17 | Cestovateľská nákupná cesta: vyhľadávanie a lookup, nákupný košík a pokladňa, bucket listy, prispôsobenie kampaní |
/mcp/social | ~17 | Prepojené sociálne účty, publikovanie a plánovanie príspevkov, čítanie štatistík príspevkov |
/mcp/travel-agent | ~8 | Rezervácie sprostredkované agentom v mene cestujúcich a agentové reporty |
https://integrations.wink.travel — integrácie channel managera
Section titled “https://integrations.wink.travel — integrácie channel managera”Jeden endpoint, pretože tento hostiteľ existuje pre jednu úlohu.
| Endpoint | Nástroje | Čo pokrýva |
|---|---|---|
/mcp/channel-manager | ~9 | Pripojenie a overenie integrácie channel managera, PMS alebo CRS |
Každý endpoint tiež nesie nástroj ping, takže môžete potvrdiť, že pripojenie je aktívne pred tým, než požiadate o skutočnú prácu.
Agentické platby
Section titled “Agentické platby”Pre kompletný rezervačný tok cestujúceho pripojte Wink Booking Engine na https://api.wink.travel/mcp/booking-engine a kompatibilnú platobnú peňaženku. Pridanie Wink MCP otvorí prehliadač na prihlásenie a výber oprávnení; váš klient potom spracuje autentifikáciu.
Booking Engine zahŕňa vyhľadávanie destinácie, vyhľadávanie hotelov a izieb, agentic_booking_quote, agentic_booking_pay, agentic_booking_book, získavanie rezervácií a potvrdení, keď sú agentické rezervácie a platby povolené pre dané prostredie. Pozrite si Agentic Payments pre nastavenie pripojenia, oprávnenia na výber a kroky od vyhľadávania po potvrdenie.
Aké toolsety potrebujem?
Section titled “Aké toolsety potrebujem?”| Ak ste… | Pripojte sa k |
|---|---|
| Integrujete channel managera, PMS alebo CRS | integrations.wink.travel/mcp/channel-manager — len tento jeden |
| Spravujete obsah nehnuteľnosti | /mcp/extranet/property + /mcp/extranet/facilities |
| Spravujete izby a typy izieb | /mcp/extranet/facilities |
| Spravujete ceny a dostupnosť | /mcp/extranet/rates |
| Prevádzkujete každodenné rezervácie | /mcp/extranet/operations |
| Rozširujete distribúciu | /mcp/extranet/distribution + /mcp/analytics |
| Budujete affiliate stránky | /mcp/studio/curation + /mcp/studio/embeds |
| Prevádzkujete link-in-bio stránky | /mcp/link-manager + /mcp/social |
| Rezervujete v mene cestujúcich | /mcp/travel-agent |
| Zúčtovávate peniaze | /mcp/payment |
| Rezervujete izbu s AI agentom | /mcp/booking-engine + kompatibilná platobná peňaženka — pozrite Agentic Payments |
| Budujete rezervačný zážitok | /mcp/booking-engine; voliteľne /mcp/reference pre ďalšie vyhľadávania |
Booking Engine obsahuje základný rezervačný tok. Poskytuje objavovanie účtu a prispôsobenia, vyhľadávanie destinácie, dostupnosť hotelov a detaily cien izieb, nákupné košíky, pokladňu a správu rezervácií cestujúcich. Agentické nástroje na rezervácie a platby sú tiež zahrnuté, keď sú povolené pre dané prostredie.
Pre vyhľadávanie hotelov v meste použite destination_lookup_search_suggestions na určenie destinácie, potom inventory_search_city na nájdenie dostupných hotelov a cien. Obe nástroje sú v /mcp/booking-engine, takže tento tok nevyžaduje pripojenie k Reference.
Pridajte /mcp/reference, keď potrebujete podporné vyhľadávania ako krajiny, meny a výmenné kurzy, podporované jazyky, časové pásma, širšie geografické vyhľadávania, OTA klasifikácie alebo verejné znalosti o nehnuteľnostiach. Sú to voliteľné doplnky k rezervačnému toku.
Začnite s jedným. Pridajte ďalší, keď zistíte, že niečo, čo potrebujete, nemôže urobiť — každé pripojenie je nezávislé a pridanie jedného nikdy neovplyvní ostatné.
Ako funguje autentifikácia
Section titled “Ako funguje autentifikácia”Wink MCP servery používajú OAuth2 Authorization Code + PKCE tok a podporujú Dynamic Client Registration (RFC 7591). Tu je, čo sa stane pri prvom pripojení:
- Váš AI klient zistí autorizačný server z metadát MCP endpointu
/.well-known/oauth-protected-resource. - Klient sa sám zaregistruje cez Dynamic Client Registration — nie je potrebné manuálne nastavovanie aplikácie.
- Klient otvorí kartu prehliadača na
https://iam.wink.travel. Prihlásite sa so svojím účtom Wink a schválite požadované oprávnenia na obrazovke súhlasu. - Wink vydá prístupový token viazaný na váš účet a identitu.
- AI klient pripojí token ku každému MCP požiadavku. Všetky výsledky nástrojov sú automaticky viazané na vašu spravujúcu entitu.
- Tokeny vypršia po 3 hodinách. Váš AI klient ich ticho obnovuje na pozadí bez ďalšieho výzvy.
Každé volanie nástroja beží pod vašou identitou — rovnaké pravidlá ACL, ktoré chránia webové rozhranie, platia aj pre AI agenta.
Pripojte svoj AI klient
Section titled “Pripojte svoj AI klient”-
Uistite sa, že Claude Code je aktuálny:
Terminal window npm install -g @anthropic-ai/claude-code -
Vyberte toolset z adresára vyššie a pridajte ho. Napríklad ceny a dostupnosť:
Terminal window claude mcp add wink-rates https://api.wink.travel/mcp/extranet/rates --transport http -
Claude Code kontaktuje server, zistí autorizačný server a otvorí váš predvolený prehliadač.
-
Prihláste sa do Wink a schváľte požiadavku na oprávnenia na obrazovke súhlasu.
-
Claude Code potvrdí pripojenie. Napíšte
/mcpna overenie, že server sa zobrazuje a jeho nástroje sa načítali.
Pridajte toľko toolsetov, koľko vaša práca potrebuje — každý je samostatný záznam servera s vlastným názvom:
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 httpPrihlasujete sa len raz. Po prvom schválení v prehliadači Claude Code znovu použije vašu Wink reláciu pre ďalšie Wink endpointy.
-
Upravte konfiguračný súbor 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:
-
Pridajte záznamy MCP serverov:
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"}}} -
Úplne ukončite a reštartujte Claude Desktop (použite Quit z menu — zatvorenie okna nestačí).
-
Claude Desktop otvorí kartu prehliadača pre každý nový server. Prihláste sa do Wink a schváľte oprávnenia.
-
Ikona zástrčky v spodnom paneli ukáže oba servery ako pripojené.
-
Uistite sa, že máte nainštalovaný Codex CLI:
Terminal window npm install -g @openai/codex -
Otvorte (alebo vytvorte) konfiguračný súbor Codex:
- macOS / Linux:
~/.codex/config.json - Windows:
%USERPROFILE%\.codex\config.json
- macOS / Linux:
-
Pridajte záznamy Wink MCP serverov:
~/.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"}}} -
Spustite Codex. Pri prvom použití Codex otvorí kartu prehliadača na
https://iam.wink.travel. -
Prihláste sa do Wink a schváľte požadované oprávnenia.
-
Codex potvrdí pripojenie. Spustite
codexa požiadajte o zoznam dostupných nástrojov, aby ste overili, že Wink servery sú aktívne.
Podpora MCP serverov je dostupná v ChatGPT desktop aplikácii pre predplatiteľov Plus, Pro, Team a Enterprise.
-
Stiahnite a nainštalujte ChatGPT desktop aplikáciu, ak ju ešte nemáte.
-
Otvorte aplikáciu a kliknite na ikonu svojho profilu v pravom hornom rohu, potom vyberte Nastavenia.
-
Prejdite na Konektory (alebo MCP Servery podľa verzie aplikácie) a kliknite na Pridať.
-
Zadajte URL toolsetu z adresára vyššie, napríklad:
https://api.wink.travel/mcp/extranet/ratesPotom kliknite na Pripojiť.
-
ChatGPT otvorí kartu prehliadača na
https://iam.wink.travel. Prihláste sa do Wink a schváľte oprávnenia. -
Opakujte kroky 4–5 pre akýkoľvek ďalší toolset, ktorý vaša práca potrebuje, napríklad:
https://api.wink.travel/mcp/extranet/operations -
Každý toolset sa zobrazí vo vašom zozname Konektorov. Začnite nový chat — Wink nástroje sú automaticky dostupné.
-
Otvorte (alebo vytvorte) konfiguračný súbor Cursor MCP:
- macOS / Linux:
~/.cursor/mcp.json - Windows:
%USERPROFILE%\.cursor\mcp.json
- macOS / Linux:
-
Pridajte záznamy Wink MCP serverov:
~/.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"}}} -
Otvorte Cursor. Prejdite na Nastavenia → Nastavenia Cursor → MCP a overte, že oba servery majú zelený stav. Ak sú červené, kliknite na Obnoviť.
-
Cursor otvorí kartu prehliadača na
https://iam.wink.travel. Prihláste sa do Wink a schváľte oprávnenia. -
Otvorte chat (
Ctrl+L/Cmd+L) a požiadajte Cursor o zoznam dostupných Wink nástrojov na potvrdenie pripojenia.
-
Otvorte (alebo vytvorte) konfiguračný súbor Windsurf MCP:
- macOS / Linux:
~/.codeium/windsurf/mcp_config.json - Windows:
%USERPROFILE%\.codeium\windsurf\mcp_config.json
- macOS / Linux:
-
Pridajte záznamy Wink MCP serverov:
~/.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"}}} -
Úplne reštartujte Windsurf (Súbor → Ukončiť, potom znovu otvorte).
-
Prejdite na Nastavenia → MCP Servery a overte, že oba servery sú pripojené. Windsurf pri prvom použití otvorí kartu prehliadača na
https://iam.wink.travel. -
Prihláste sa do Wink a schváľte oprávnenia. Servery sa v nastaveniach zafarbia na zeleno po autentifikácii.
Cline je rozšírenie VS Code s integrovaným správcom MCP serverov. Nie je potrebné manuálne upravovať JSON.
-
Nainštalujte Cline z VS Code Marketplace:
- Otvorte VS Code a stlačte
Ctrl+Shift+X/Cmd+Shift+X - Vyhľadajte Cline a kliknite na Inštalovať
- Otvorte VS Code a stlačte
-
Kliknite na ikonu Cline v Activity Bar (ľavý bočný panel) pre otvorenie panela Cline.
-
Kliknite na ikonu MCP Servery (ikona zástrčky) v paneli nástrojov Cline, potom vyberte Upraviť nastavenia MCP.
-
VS Code otvorí
cline_mcp_settings.json. Pridajte Wink záznamy: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"}}} -
Uložte súbor. Cline sa automaticky znovu načíta a otvorí kartu prehliadača na
https://iam.wink.travel. -
Prihláste sa do Wink a schváľte oprávnenia. Oba servery sa zobrazia ako aktívne v paneli MCP Serverov.
Oprávnenia (Scopes)
Section titled “Oprávnenia (Scopes)”Keď schválite obrazovku súhlasu, uvidíte rozpis toho, čo agent žiada. MCP klienti používajú rovnaký slovník oprávnení ako zvyšok platformy — pozrite si kompletný referenčný zoznam oprávnení na stránke Autentifikácia.
Dve veci sú špecifické pre MCP:
- Oprávnenia
mcp.read,mcp.write,mcp.removesú navyše potrebné na otvorenie MCP transportu. Klient s oprávnenímmcp.*má prístup ku ktorémukoľvek Wink MCP endpointu, ale každý nástroj, ktorý vyvolá, stále vynucuje sekčné oprávnenie endpointu, ktorý obaluje (napr.booking.read). - AI klient žiada len oprávnenia, ktoré potrebuje. Môžete na obrazovke súhlasu zamietnuť jednotlivé oprávnenia — nástroje, ktoré vyžadujú zamietnuté oprávnenie, vrátia chybu pri vyvolaní.
Toolsety toto nemenia. Endpoint, ku ktorému sa pripojíte, rozhoduje, ktoré nástroje sú zobrazované, nie čo môžu robiť. Pripojenie k /mcp/payment neudelí žiadne finančné oprávnenie, ktoré ste už nemali, a pripojenie k /mcp/reference nezastaví nástroj, aby vynucoval vlastné oprávnenie. Autorizácia sa rozhoduje pri každom volaní nástroja na základe vášho tokenu a oprávnení vášho účtu.
Riešenie problémov
Section titled “Riešenie problémov”Karta prehliadača sa neotvorí
Váš AI klient možno ešte nepodporuje interaktívny PKCE tok. Overte, že používate aktuálnu verziu:
- Claude Code:
npm install -g @anthropic-ai/claude-code - Codex CLI:
npm install -g @openai/codex - Claude Desktop / ChatGPT desktop: aktualizujte cez vstavaný updater aplikácie
401 Unauthorized po prihlásení
Váš uložený token môže byť neplatný. Odstráňte a znova pridajte server, aby ste spustili nové prihlásenie:
# Claude Codeclaude mcp remove wink-ratesclaude mcp add wink-rates https://api.wink.travel/mcp/extranet/rates --transport httpPre Claude Desktop a ChatGPT odstráňte server zo nastavení, reštartujte aplikáciu a pridajte ho znova.
403 Forbidden pri volaní konkrétneho nástroja
Nástroj vyžaduje oprávnenie, ktoré ste na obrazovke súhlasu neschválili, alebo oprávnenie, ktoré váš účet nemá. Znovu pripojte server — obrazovka súhlasu sa zobrazí znova a môžete schváliť chýbajúce oprávnenie. Ak to stále zlyháva, nástroj potrebuje oprávnenie účtu, ktoré nemáte; pripojenie k inému toolsetu nepomôže, pretože toolsety neudelujú oprávnenia.
Nástroj, ktorý potrebujem, nie je v zozname
Pravdepodobne ste pripojení k toolsetu, ktorý túto úlohu nepokrýva. Skontrolujte adresár endpointov a pridajte toolset, ktorý ju pokrýva — pripojenia sú nezávislé, takže pridanie jedného nič nezmení na ostatných. Ak si nie ste istí, ktorý ho má, dočasne sa pripojte k https://api.wink.travel/mcp, nájdite nástroj a potom zistite, ktorý toolset ho obsahuje.
404 Not Found na endpoint toolsetu
Dávajte pozor na cestu — vnorené toolsety majú dva segmenty (/mcp/extranet/rates, nie /mcp/extranet-rates), a ploché majú jeden (/mcp/link-manager). Neautentifikovaný požiadavok na akúkoľvek cestu pod /mcp vráti 401, nie 404, takže samotné 401 neznamená, či endpoint existuje.
Pripojil som sa k api.wink.travel/mcp/channel-manager a nič
Tento endpoint neexistuje. Integrácia channel managera je dostupná iba na https://integrations.wink.travel/mcp/channel-manager. Ak potrebujete tiež čítať alebo zapisovať vlastné ceny nehnuteľnosti ručne, je to samostatná úloha na samostatnom endpointu — pozrite /mcp/extranet/rates.
Server sa zobrazuje, ale volania nástrojov vracajú “account not found”
Ste prihlásení do Wink účtu, ktorý nemá spravujúcu entitu. Prejdite na Wink Portal a uistite sa, že váš účet je nastavený pred použitím MCP servera.
Token vyprší počas relácie
Tokeny sú platné 3 hodiny. Claude Code a Claude Desktop ticho obnovujú tokeny bez prerušenia relácie. Ak po dlhšom nečinnom období vidíte chyby autentifikácie, napíšte novú správu — klient sa automaticky znovu autentifikuje.
Codex CLI hlási “MCP server unreachable”
Skontrolujte, či váš ~/.codex/config.json je platný JSON (bez záverečných čiark) a či je nastavené "type": "http". Codex vyžaduje HTTP transport pre vzdialené servery; stdio transport je len pre lokálne binárky.
Menu “Connectors” v ChatGPT chýba
Podpora MCP vyžaduje verziu desktop aplikácie ChatGPT 1.2024.352 alebo novšiu a aktívne predplatné Plus, Pro, Team alebo Enterprise. Aktualizujte aplikáciu a overte svoj plán v Nastaveniach → Účet.
Cursor server zobrazuje červenú / “Failed to connect”
Overte, že váš ~/.cursor/mcp.json je platný JSON a obsahuje "type": "http". Potom prejdite na Nastavenia → Nastavenia Cursor → MCP a kliknite na Obnoviť. Ak chyba pretrváva, úplne reštartujte Cursor — zmeny konfigurácie sa nie vždy načítajú bez reštartu.
Windsurf MCP servery nie sú v nastaveniach
Windsurf vyžaduje úplný reštart (nie len obnovenie okna) na načítanie zmien v mcp_config.json. Použite Súbor → Ukončiť a znovu spustite. Ak servery stále nie sú viditeľné, overte, že máte Windsurf 1.4+ cez Pomocník → O Windsurf.
Možnosť “Add Server” v Cline nie je viditeľná
Správca MCP serverov vyžaduje Cline 2.0 alebo novší. Otvorte panel rozšírení VS Code, nájdite Cline a kliknite na Aktualizovať, ak je dostupná aktualizácia. Po aktualizácii reštartujte VS Code (Ctrl+Shift+P → “Developer: Reload Window”).
Otvoriť Wink Portál Wink na GitHub
