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.
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é — 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.
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 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, požiadavky na affiliate a vzťahy s 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 | Cesta nakupovania pre cestovateľa: 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 insightov príspevkov |
/mcp/travel-agent | ~8 | Rezervá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.
| Endpoint | Nástroje | Čo pokrýva |
|---|---|---|
/mcp/channel-manager | ~9 | Pripojenie 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.
Agentické platby
Section titled “Agentické platby”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é 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 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é.
Ako funguje autentifikácia
Section titled “Ako funguje autentifikácia”Wink MCP servery používajú OAuth2 Authorization Code + PKCE flow a podporujú Dynamic Client Registration (RFC 7591). Takto to prebieha 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 Wink účtom a schválite požadované oprávnenia na obrazovke súhlasu. - Wink vydá access 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 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.
Pripojte svoj AI klient
Section titled “Pripojte svoj AI klient”Pridajte každý toolset do Claude ako vlastný konektor. Nie je potrebné upravovať konfiguračný súbor ani vytvárať aplikáciu alebo tajomstvo.
-
V Claude otvorte Customize › Connectors, kliknite na Add, potom Add custom connector.
-
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-managerKliknite na Continue.
-
Claude detekuje Wink prihlásenie. Nechajte Authentication: Sign in now a OAuth client: Register automatically, potom kliknite na Add.
-
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. -
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.
-
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ávnenie na obrazovke súhlasu.
-
Claude Code potvrdí pripojenie. Napíšte
/mcpna overenie, že server sa zobrazuje a jeho nástroje sú načítané.
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žíva 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 ukazuje 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 na overenie aktivity Wink serverov.
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 Settings.
-
Prejdite na Connectors (alebo MCP Servers podľa verzie aplikácie) a kliknite na Add.
-
Zadajte URL toolsetu z adresára vyššie, napríklad:
https://api.wink.travel/mcp/extranet/ratesPotom kliknite na Connect.
-
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 každý ď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 Connectors. 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 Settings → Cursor Settings → MCP a potvrďte, že oba servery majú zelený stav. Ak sú červené, kliknite na Refresh.
-
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 Settings → MCP Servers 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 pre 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 Install
- 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 Servers (ikona zástrčky) v paneli nástrojov Cline, potom vyberte Edit MCP Settings.
-
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 Servers.
Scopes
Section titled “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 scope na stránke Autentifikácie.
Tri veci sú špecifické pre MCP:
- Scope
mcp.read,mcp.write,mcp.removesú navyše potrebné na otvorenie MCP transportu. Klient smcp.*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.
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 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:
# 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 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
