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 Wink účtom a je to. Ž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é — ale 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 pred tý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 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, požiadavky na affiliate a vzťahy s 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~17Cesta nakupovania pre cestovateľa: 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 insightov príspevkov
/mcp/travel-agent~8Rezervácie sprostredkované agentom v mene cestovateľov 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 channel managera, PMS alebo CRS integrácie

Každý endpoint tiež nesie nástroj ping, takže môžete potvrdiť, že spojenie je aktívne pred tým, než požiadate o skutočnú prácu.

Pre kompletný rezervačný proces cestovateľa 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 spravuje autentifikáciu.

Booking Engine obsahuje 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 cestovateľov/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 lookupy

Booking Engine obsahuje základný rezervačný workflow. 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í cestovateľa. Agentické nástroje na rezerváciu a platbu sú tiež zahrnuté, keď sú povolené pre dané prostredie.

Pre vyhľadávanie hotelov v meste použite destination_lookup_search_suggestions na vyrieš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é lookupy 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 potrebujete niečo, čo ten prvý nedokáže — každé pripojenie je nezávislé a pridanie jedného nikdy neovplyvní ostatné.


Wink MCP servery používajú OAuth2 Authorization Code + PKCE flow a podporujú Dynamic Client Registration (RFC 7591). Takto to prebieha 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 Wink účtom a schválite požadované oprávnenia na obrazovke súhlasu.
  4. Wink vydá access 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 expirovali 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.


Pridajte každý toolset do Claude ako vlastný konektor. Nie je potrebné upravovať konfiguračný súbor ani vytvárať aplikáciu alebo tajomstvo.

  1. V Claude otvorte Customize › Connectors, kliknite na Add, potom Add custom connector.

  2. Zadajte Názov (napríklad Wink Link manager) a ako MCP server URL toolset z adresára vyššie, napríklad:

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

    Kliknite na Continue.

  3. Claude detekuje Wink prihlásenie. Nechajte Authentication: Sign in now a OAuth client: Register automatically, potom kliknite na Add.

  4. Kliknite na Connect. Otvorí sa stránka prihlásenia Wink na https://iam.wink.travel. Prihláste sa do Wink a schváľte oprávnenia na obrazovke súhlasu.

  5. Nástroje konektora sú teraz dostupné vo vašich chatovacích oknách. Opakujte pre každý toolset, ktorý vaša práca potrebuje; každý je samostatný konektor.


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 scope na stránke Autentifikácie.

Tri veci sú špecifické pre MCP:

  • Scope mcp.read, mcp.write, mcp.remove sú navyše potrebné na otvorenie MCP transportu. Klient s mcp.* scope má prístup ku ktorémukoľvek Wink MCP endpointu, ale každý nástroj, ktorý vyvolá, stále vynucuje scope sekcie endpointu, ktorý obalí (napr. booking.read).
  • MCP vždy koná ako prihlásený používateľ. AI klient dostáva mcp.* scope cez vaše prihlásenie, nikdy z Aplikácie, ktorú vytvoríte. Tokeny stroj-stroj (client-credentials) nemôžu otvoriť MCP transport; na server-server prácu používajte REST API.
  • AI klient žiada len scope, ktoré potrebuje. Môžete zamietnuť jednotlivé oprávnenia na obrazovke súhlasu — nástroje, ktoré vyžadujú zamietnutý scope, vrátia chybu pri vyvolaní.

Toolsety toto nemenia. Endpoint, ku ktorému sa pripojíte, rozhoduje, ktoré nástroje sú zobrazené, 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ý scope. Autorizácia sa rozhoduje pri každom volaní nástroja podľa vášho tokenu a oprávnení účtu.


Karta prehliadača sa neotvorí

Váš AI klient možno ešte nepodporuje interaktívny PKCE flow. 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 settings, reštartujte aplikáciu a pridajte ho znova.

403 Forbidden pri volaní konkrétneho nástroja

Nástroj vyžaduje scope, 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č nemení na ostatných. Ak si nie ste istí, ktorý to 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ôkladne skontrolujte 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 vracia 401, nie 404, takže samotné 401 neznamená, či endpoint existuje.

Pripojil som sa k api.wink.travel/mcp/channel-manager a nič

Taký endpoint neexistuje. Integrácia channel managera je dostupná iba na https://integrations.wink.travel/mcp/channel-manager. Ak potrebujete ručne čítať alebo zapisovať vlastné ceny nehnuteľnosti, 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 zobrazuje “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 Settings → Cursor Settings → MCP a kliknite na Refresh. 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 reload okna) na načítanie zmien v mcp_config.json. Použite File → Quit a znovu spustite. Ak servery stále nie sú viditeľné, overte, že máte Windsurf 1.4+ cez Help → About 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 Update, ak je dostupná aktualizácia. Po aktualizácii reštartujte VS Code (Ctrl+Shift+P → “Developer: Reload Window”).


Otvoriť Wink Portal Wink na GitHub