Preskočiť na obsah

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.

Integrator channel managera sa pripája k jednému endpointu
claude mcp add wink-channel-manager https://integrations.wink.travel/mcp/channel-manager --transport http
Hotelier spravujúci vlastné ceny sa pripája k inému endpointu
claude mcp add wink-rates https://api.wink.travel/mcp/extranet/rates --transport http

Preč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.


Dva hostitelia poskytujú toolsety. Počty nástrojov sú približné a časom rastú.

EndpointNástrojeČo pokrýva
/mcp/extranet/facilities~64Rezervovateľ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~62Záznam o nehnuteľnosti a jej obchodné podmienky: profil a obsah, doplnky, storno podmienky, výhody, oznámenia
/mcp/settings~60Správa účtu: profil a branding spravujúcej entity, manažéri a ich oprávnenia, prispôsobenie, webhooks, preferencie notifikácií
/mcp/studio/embeds~48Publikovanie 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~44Ceny a dostupnosť: obdobia a alokácie cien inventára, cenové plány, hlavné ceny, špeciálne a promo ceny
/mcp/extranet/operations~39Prevádzka živej nehnuteľnosti: rezervácie a ich životný cyklus, recenzie hostí a odpovede, kalendárové feedy, plánované úlohy
/mcp/extranet/distribution~37Kde 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~35Budovanie kolekcií na predaj: statické a dynamické zoznamy, zoradené zoznamy, uložené vyhľadávania, agregáty nehnuteľností
/mcp/link-manager~28Syndikované kolekcie odkazov, ich dizajn, kategórie a tagy, plus skrátené URL
/mcp/reference~24Iba 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~18Analytika rezervácií a príjmov: prehľady, čiarové grafy, rebríčky, výkonnosť affiliate, metriky zdieľania
/mcp/payment~18Finančné operácie: účtovná kniha, výbery a odhady poplatkov, agregáty finančných prostriedkov rezervácií
/mcp/booking-engine~17Cestovateľská nákupná cesta: vyhľadávanie a lookup, nákupný košík a pokladňa, bucket listy, prispôsobenie kampaní
/mcp/social~17Prepojené sociálne účty, publikovanie a plánovanie príspevkov, čítanie štatistík príspevkov
/mcp/travel-agent~8Rezervá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.

EndpointNástrojeČo pokrýva
/mcp/channel-manager~9Pripojenie 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.

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 ste…Pripojte sa k
Integrujete channel managera, PMS alebo CRSintegrations.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é.


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í:

  1. Váš AI klient zistí autorizačný server z metadát MCP endpointu /.well-known/oauth-protected-resource.
  2. Klient sa sám zaregistruje cez Dynamic Client Registration — nie je potrebné manuálne nastavovanie aplikácie.
  3. 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.
  4. Wink vydá prístupový token viazaný na váš účet a identitu.
  5. 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.
  6. 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.


  1. Uistite sa, že Claude Code je aktuálny:

    Terminal window
    npm install -g @anthropic-ai/claude-code
  2. 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
  3. Claude Code kontaktuje server, zistí autorizačný server a otvorí váš predvolený prehliadač.

  4. Prihláste sa do Wink a schváľte požiadavku na oprávnenia na obrazovke súhlasu.

  5. Claude Code potvrdí pripojenie. Napíšte /mcp na 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:

Terminal window
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

Prihlasujete 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.


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.remove sú navyše potrebné na otvorenie MCP transportu. Klient s oprávnením mcp.* 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.


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:

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

Pre 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