MCP servery
Nástroje MCP od Wink jsou publikovány jako toolsety — zaměřené koncové body, z nichž každý pokrývá jeden úkol. Připojíte svého AI klienta k jednomu nebo dvěma, které odpovídají vaší práci, ne ke všem.
Každý koncový bod používá interaktivní přihlášení OAuth2 (PKCE authorization code flow): váš AI agent otevře záložku v prohlížeči, přihlásíte se pomocí svého účtu Wink a je to. Žádné spravování klientských tajemství.
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 httpProč jsou nástroje rozděleny do koncových bodů
Sekce “Proč jsou nástroje rozděleny do koncových bodů”Wink zpřístupňuje přibližně 500 nástrojů. Předat je všechny agentovi najednou je technicky možné — a špatný nápad.
Definice nástrojů stojí kontext. Každý nástroj, který MCP server inzeruje, je načten do kontextového okna modelu před tím, než začne pracovat, spolu s jeho popisem a kompletním schématem parametrů. Pět set takových nástrojů spotřebuje velkou část rozpočtu, který vaše skutečné úkoly potřebují, při každém požadavku.
Kvalita výběru klesá s rostoucím seznamem. Agent vybírající z 500 podobně pojmenovaných nástrojů dělá horší volby než agent vybírající z 40. Pokud integrujete channel manager, přibližně dvacet nástrojů je pro vás relevantních; ostatních 480 je šum, který ztěžuje nalezení správného nástroje.
Práce je skutečně oddělitelná. Někdo synchronizující dostupnost z PMS a někdo vytvářející affiliate vstupní stránky sdílí téměř žádné nástroje. Rozdělení podle úkolu znamená, že každé připojení nese slovník jednoho úkolu.
Adresář koncových bodů
Sekce “Adresář koncových bodů”Dva hostitelé poskytují toolsety. Počty nástrojů jsou přibližné a časem rostou.
https://api.wink.travel — platforma
Sekce “https://api.wink.travel — platforma”| Koncový bod | Nástroje | Co pokrývá |
|---|---|---|
/mcp/extranet/facilities | ~64 | Rezervovatelný a na místě dostupný inventář: hostovské pokoje a typy pokojů, spa, restaurace, zasedací místnosti, aktivity, atrakce, místa, další prodejné položky |
/mcp/extranet/property | ~62 | Záznam o nemovitosti a její obchodní podmínky: profil a obsah, doplňky, storno podmínky, výhody, oznámení |
/mcp/settings | ~60 | Správa účtu: profil a branding spravující entity, manažeři a jejich oprávnění, přizpůsobení, webhooky, nastavení notifikací |
/mcp/studio/embeds | ~48 | Publikování kurátorského inventáře: widgety, mřížky a řazené mřížky, karty, mapy, hluboké odkazy na inventář a stránky dodavatelů |
/mcp/extranet/rates | ~44 | Ceny a dostupnost: období sazeb a alokace inventáře, sazební plány, hlavní sazby, speciální a promo sazby |
/mcp/extranet/operations | ~39 | Provoz živé nemovitosti: rezervace a jejich životní cyklus, recenze hostů a odpovědi, kalendářové zdroje, plánované úkoly |
/mcp/extranet/distribution | ~37 | Kde se inventář prodává: prodejní kanály a modifikátory sazeb, žádosti o vztahy s affiliate a dodavateli, registrace, zachycení leadů |
/mcp/studio/curation | ~35 | Budování kolekcí k prodeji: statické a dynamické seznamy, řazené seznamy, uložené vyhledávání, agregáty nemovitostí |
/mcp/link-manager | ~28 | Syndikované kolekce odkazů, jejich design, kategorie a štítky, plus zkrácené URL |
/mcp/reference | ~24 | Data pouze pro čtení: země, měny a směnné kurzy, jazyky, časová pásma, geografické vyhledávání, geolokace IP |
/mcp/analytics | ~18 | Analytika rezervací a příjmů: přehledy, čárové grafy, žebříčky, výkon affiliate, metriky sdílení |
/mcp/payment | ~18 | Finanční operace: účetní kniha, výběry a odhady poplatků, agregáty finančních prostředků rezervací |
/mcp/booking-engine | ~17 | Cesta nákupu pro cestovatele: vyhledávání a dohledávání, nákupní košík a pokladna, seznamy přání, přizpůsobení kampaní |
/mcp/social | ~17 | Připojené sociální účty, publikování a plánování příspěvků, čtení statistik příspěvků |
/mcp/travel-agent | ~8 | Rezervace zprostředkované agentem jménem cestovatelů a agenturní reporty |
https://integrations.wink.travel — integrace channel managerů
Sekce “https://integrations.wink.travel — integrace channel managerů”Jeden koncový bod, protože tento host existuje pro jeden úkol.
| Koncový bod | Nástroje | Co pokrývá |
|---|---|---|
/mcp/channel-manager | ~9 | Připojení a ověření integrace channel manageru, PMS nebo CRS |
Každý koncový bod také obsahuje nástroj ping, takže můžete ověřit, že je připojení aktivní, než požádáte o skutečnou práci.
Agentické platby
Sekce “Agentické platby”Pro kompletní tok rezervace cestovatele připojte Wink Booking Engine na https://api.wink.travel/mcp/booking-engine a kompatibilní platební peněženku. Přidání Wink MCP otevře přihlášení v prohlížeči a výběr oprávnění; váš klient pak zpracovává autentizaci.
Booking Engine zahrnuje dohledávání destinací, vyhledávání hotelů a pokojů, agentic_booking_quote, agentic_booking_pay, agentic_booking_book, získávání rezervací a účtenek, pokud jsou agentické rezervace a platby pro dané prostředí povoleny. Viz Agentic Payments pro nastavení připojení, výběr oprávnění a kroky od vyhledávání po potvrzení.
Jaké toolsety potřebuji?
Sekce “Jaké toolsety potřebuji?”| Pokud jste… | Připojte se k |
|---|---|
| Integrujete channel manager, PMS nebo CRS | integrations.wink.travel/mcp/channel-manager — pouze tento |
| Spravujete obsah nemovitosti | /mcp/extranet/property + /mcp/extranet/facilities |
| Spravujete pokoje a typy pokojů | /mcp/extranet/facilities |
| Spravujete ceny a dostupnost | /mcp/extranet/rates |
| Řídíte každodenní rezervace | /mcp/extranet/operations |
| Rozšiřujete distribuci | /mcp/extranet/distribution + /mcp/analytics |
| Budujete affiliate stránky | /mcp/studio/curation + /mcp/studio/embeds |
| Provozujete link-in-bio stránky | /mcp/link-manager + /mcp/social |
| Rezervujete jménem cestovatelů | /mcp/travel-agent |
| Vyrovnáváte finance | /mcp/payment |
| Rezervujete pokoj s AI agentem | /mcp/booking-engine + kompatibilní platební peněženka — viz Agentic Payments |
| Budujete rezervační zážitek | /mcp/booking-engine; volitelně /mcp/reference pro doplňková dohledávání |
Booking Engine zahrnuje základní rezervační workflow. Poskytuje zjištění účtu a přizpůsobení, dohledávání destinací, dostupnost hotelů a podrobnosti o cenách pokojů, nákupní košíky, pokladnu a správu rezervací cestovatelů. Agentické nástroje pro rezervace a platby jsou také zahrnuty, pokud jsou pro dané prostředí povoleny.
Pro vyhledávání hotelů ve městě použijte destination_lookup_search_suggestions k určení destinace, poté inventory_search_city k nalezení dostupných hotelů a sazeb. Oba nástroje jsou v /mcp/booking-engine, takže tento tok nevyžaduje připojení k Reference.
Přidejte /mcp/reference, pokud potřebujete podpůrná dohledávání jako země, měny a směnné kurzy, podporované jazyky, časová pásma, širší geografická vyhledávání, OTA klasifikace nebo veřejné znalosti o nemovitostech. Jsou to volitelné doplňky k rezervačnímu toku.
Začněte s jedním. Přidejte další, když zjistíte, že něco neumí — každé připojení je nezávislé a přidání jednoho nemá vliv na ostatní.
Jak funguje autentizace
Sekce “Jak funguje autentizace”Wink MCP servery používají OAuth2 Authorization Code + PKCE flow a podporují Dynamic Client Registration (RFC 7591). Zde je, co se stane při prvním připojení:
- Váš AI klient zjistí autorizační server z metadat MCP koncového bodu
/.well-known/oauth-protected-resource. - Klient se sám zaregistruje přes Dynamic Client Registration — není potřeba ruční nastavení aplikace.
- Klient otevře záložku v prohlížeči na
https://iam.wink.travel. Přihlásíte se pomocí účtu Wink a schválíte požadovaná oprávnění na obrazovce souhlasu. - Wink vydá přístupový token vázaný na váš účet a propojený s vaší identitou.
- AI klient připojuje token ke každému MCP požadavku. Všechny výsledky nástrojů jsou automaticky omezeny na vaši spravující entitu.
- Tokeny expirují po 3 hodinách. Váš AI klient je tichounce obnovuje na pozadí bez dalšího vyžádání.
Každé volání nástroje běží pod vaší identitou — platí stejná pravidla ACL, která chrání webové rozhraní, i pro AI agenta.
Připojte svého AI klienta
Sekce “Připojte svého AI klienta”-
Ujistěte se, že Claude Code je aktuální:
Terminál npm install -g @anthropic-ai/claude-code -
Vyberte toolset z adresáře výše a přidejte ho. Například ceny a dostupnost:
Terminál claude mcp add wink-rates https://api.wink.travel/mcp/extranet/rates --transport http -
Claude Code kontaktuje server, zjistí autorizační server a otevře váš výchozí prohlížeč.
-
Přihlaste se do Wink a schvalte požadavek na oprávnění na obrazovce souhlasu.
-
Claude Code potvrdí připojení. Zadejte
/mcppro ověření, že server je vidět a jeho nástroje jsou načteny.
Přidejte tolik toolsetů, kolik vaše práce potřebuje — každý je samostatný záznam serveru s vlastním názvem:
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 httpPřihlašujete se jen jednou. Po prvním schválení v prohlížeči Claude Code znovu použije vaši Wink relaci pro další Wink koncové body.
-
Upravte konfigurační soubor 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:
-
Přidejte záznamy MCP serverů:
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"}}} -
Úplně ukončete a restartujte Claude Desktop (použijte Quit z menu — zavření okna nestačí).
-
Claude Desktop otevře pro každý nový server záložku v prohlížeči. Přihlaste se do Wink a schvalte oprávnění.
-
Ikona zástrčky v dolním panelu ukáže oba servery jako připojené.
-
Ujistěte se, že máte nainstalovaný Codex CLI:
Terminál npm install -g @openai/codex -
Otevřete (nebo vytvořte) konfigurační soubor Codex:
- macOS / Linux:
~/.codex/config.json - Windows:
%USERPROFILE%\.codex\config.json
- macOS / Linux:
-
Přidejte záznamy Wink MCP serverů:
~/.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"}}} -
Spusťte Codex. Při prvním použití Codex otevře záložku v prohlížeči na
https://iam.wink.travel. -
Přihlaste se do Wink a schvalte požadovaná oprávnění.
-
Codex potvrdí připojení. Spusťte
codexa požádejte o seznam dostupných nástrojů pro ověření, že Wink servery jsou aktivní.
Podpora MCP serverů je dostupná v ChatGPT desktopové aplikaci pro předplatitele Plus, Pro, Team a Enterprise.
-
Stáhněte a nainstalujte ChatGPT desktopovou aplikaci, pokud ji ještě nemáte.
-
Otevřete aplikaci a klikněte na ikonu svého profilu v pravém horním rohu, poté vyberte Nastavení.
-
Přejděte na Konektory (nebo MCP servery podle verze aplikace) a klikněte na Přidat.
-
Zadejte URL toolsetu z adresáře výše, například:
https://api.wink.travel/mcp/extranet/ratesPoté klikněte na Připojit.
-
ChatGPT otevře záložku v prohlížeči na
https://iam.wink.travel. Přihlaste se do Wink a schvalte oprávnění. -
Opakujte kroky 4–5 pro další toolsety, které vaše práce potřebuje, například:
https://api.wink.travel/mcp/extranet/operations -
Každý toolset se objeví ve vašem seznamu konektorů. Začněte nový chat — nástroje Wink jsou automaticky dostupné.
-
Otevřete (nebo vytvořte) konfigurační soubor Cursor MCP:
- macOS / Linux:
~/.cursor/mcp.json - Windows:
%USERPROFILE%\.cursor\mcp.json
- macOS / Linux:
-
Přidejte záznamy Wink MCP serverů:
~/.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"}}} -
Otevřete Cursor. Přejděte na Nastavení → Nastavení Cursor → MCP a ověřte, že oba servery mají zelený stav. Pokud jsou červené, klikněte na Obnovit.
-
Cursor otevře záložku v prohlížeči na
https://iam.wink.travel. Přihlaste se do Wink a schvalte oprávnění. -
Otevřete chat (
Ctrl+L/Cmd+L) a požádejte Cursor o seznam dostupných nástrojů Wink pro potvrzení připojení.
-
Otevřete (nebo vytvořte) konfigurační soubor Windsurf MCP:
- macOS / Linux:
~/.codeium/windsurf/mcp_config.json - Windows:
%USERPROFILE%\.codeium\windsurf\mcp_config.json
- macOS / Linux:
-
Přidejte záznamy Wink MCP serverů:
~/.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"}}} -
Úplně restartujte Windsurf (Soubor → Ukončit, pak znovu otevřete).
-
Přejděte na Nastavení → MCP servery a ověřte, že oba servery jsou připojené. Windsurf při prvním použití otevře záložku v prohlížeči na
https://iam.wink.travel. -
Přihlaste se do Wink a schvalte oprávnění. Servery v nastavení zčervenají na zeleno po autentizaci.
Cline je rozšíření VS Code s vestavěným správcem MCP serverů. Ruční úprava JSON není potřeba.
-
Nainstalujte Cline z VS Code Marketplace:
- Otevřete VS Code a stiskněte
Ctrl+Shift+X/Cmd+Shift+X - Vyhledejte Cline a klikněte na Instalovat
- Otevřete VS Code a stiskněte
-
Klikněte na ikonu Cline v panelu aktivit (levý boční panel) pro otevření panelu Cline.
-
Klikněte na ikonu MCP serverů (ikona zástrčky) v nástrojové liště Cline, poté vyberte Upravit nastavení MCP.
-
VS Code otevře
cline_mcp_settings.json. Přidejte záznamy 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"}}} -
Uložte soubor. Cline se automaticky znovu načte a otevře záložku v prohlížeči na
https://iam.wink.travel. -
Přihlaste se do Wink a schvalte oprávnění. Oba servery se zobrazí jako aktivní v panelu MCP serverů.
Oprávnění (Scopes)
Sekce “Oprávnění (Scopes)”Při schvalování na obrazovce souhlasu uvidíte rozpis toho, co agent požaduje. MCP klienti používají stejnou slovní zásobu oprávnění jako zbytek platformy — viz kompletní referenční seznam oprávnění na stránce Autentizace.
Dvě věci jsou specifické pro MCP:
- Oprávnění
mcp.read,mcp.write,mcp.removejsou navíc vyžadována k otevření MCP transportu. Klient s oprávněnímmcp.*má přístup ke všem Wink MCP koncovým bodům, ale každý nástroj, který vyvolá, stále vynucuje oprávnění sekce koncového bodu, který obaluje (např.booking.read). - AI klient žádá pouze o oprávnění, která potřebuje. Na obrazovce souhlasu můžete jednotlivá oprávnění zamítnout — nástroje vyžadující zamítnuté oprávnění vrátí chybu při vyvolání.
Toolsety nic z toho nemění. Koncový bod, ke kterému se připojíte, rozhoduje, které nástroje jsou zobrazeny, ne co smí dělat. Připojení k /mcp/payment nedává žádné finanční oprávnění, které jste již neměli, a připojení k /mcp/reference nezabrání nástroji tam vynucovat jeho vlastní oprávnění. Autorizace se rozhoduje pro každé volání nástroje na základě vašeho tokenu a oprávnění vašeho účtu.
Řešení problémů
Sekce “Řešení problémů”Neotevře se záložka v prohlížeči
Váš AI klient možná ještě nepodporuje interaktivní PKCE flow. Ověřte, že používáte aktuální verzi:
- Claude Code:
npm install -g @anthropic-ai/claude-code - Codex CLI:
npm install -g @openai/codex - Claude Desktop / ChatGPT desktop: aktualizujte přes vestavěný updater aplikace
401 Unauthorized po přihlášení
Váš uložený token může být neplatný. Odstraňte a znovu přidejte server, aby se spustilo nové přihlášení:
# Claude Codeclaude mcp remove wink-ratesclaude mcp add wink-rates https://api.wink.travel/mcp/extranet/rates --transport httpU Claude Desktop a ChatGPT odeberte server v nastavení, restartujte aplikaci a přidejte ho znovu.
403 Forbidden při volání konkrétního nástroje
Nástroj vyžaduje oprávnění, které jste na obrazovce souhlasu neschválili, nebo oprávnění, které váš účet nemá. Připojte server znovu — obrazovka souhlasu se znovu objeví a můžete chybějící oprávnění schválit. Pokud to stále selhává, nástroj potřebuje oprávnění účtu, které nemáte; připojení k jinému toolsetu nepomůže, protože toolsety nedávají oprávnění.
Nástroj, který potřebuji, není v seznamu
Pravděpodobně jste připojeni k toolsetu, který daný úkol nepokrývá. Zkontrolujte adresář koncových bodů a přidejte toolset, který ho obsahuje — připojení jsou nezávislá, takže přidání jednoho nemění ostatní. Pokud si nejste jisti, který toolset ho má, dočasně se připojte k https://api.wink.travel/mcp, najděte nástroj a pak zjistěte, který toolset ho obsahuje.
404 Not Found na koncovém bodu toolsetu
Pečlivě zkontrolujte cestu — vnořené toolsety mají dvě části (/mcp/extranet/rates, ne /mcp/extranet-rates), ploché mají jednu (/mcp/link-manager). Neautentizovaný požadavek na jakoukoli cestu pod /mcp vrací 401, ne 404, takže samotné 401 neznamená, zda koncový bod existuje.
Připojil jsem se k api.wink.travel/mcp/channel-manager a nic
Tento koncový bod neexistuje. Integrace channel manageru je dostupná pouze na https://integrations.wink.travel/mcp/channel-manager. Pokud také potřebujete ručně číst nebo zapisovat vlastní sazby nemovitosti, je to samostatný úkol na samostatném koncovém bodu — viz /mcp/extranet/rates.
Server se zobrazuje, ale volání nástrojů vrací “account not found”
Jste přihlášeni do Wink účtu, který nemá spravující entitu. Přejděte na Wink Portal a ujistěte se, že je váš účet nastavený před použitím MCP serveru.
Token vyprší během relace
Tokeny jsou platné 3 hodiny. Claude Code a Claude Desktop obnovují tokeny tiše na pozadí bez přerušení relace. Pokud po dlouhém nečinném období vidíte chyby autentizace, napište novou zprávu — klient se automaticky znovu autentizuje.
Codex CLI hlásí “MCP server unreachable”
Zkontrolujte, že váš ~/.codex/config.json je platný JSON (bez koncových čárek) a že "type": "http" je nastaveno. Codex vyžaduje HTTP transport pro vzdálené servery; stdio transport je pouze pro lokální binárky.
Menu “Connectors” v ChatGPT chybí
Podpora MCP vyžaduje desktopovou aplikaci ChatGPT verze 1.2024.352 nebo novější a aktivní předplatné Plus, Pro, Team nebo Enterprise. Aktualizujte aplikaci a ověřte svůj plán v Nastavení → Účet.
Cursor server ukazuje červeně / “Failed to connect”
Ověřte, že váš ~/.cursor/mcp.json je platný JSON a obsahuje "type": "http". Pak přejděte na Nastavení → Nastavení Cursor → MCP a klikněte na Obnovit. Pokud chyba přetrvává, úplně restartujte Cursor — změny konfigurace se nemusí vždy načíst bez restartu.
Windsurf MCP servery nejsou v nastavení
Windsurf vyžaduje úplný restart (nejen obnovení okna) pro načtení změn v mcp_config.json. Použijte Soubor → Ukončit a znovu spusťte. Pokud servery stále nejsou vidět, ověřte, že máte Windsurf 1.4+ přes Nápověda → O Windsurf.
V Cline není viditelná volba “Add Server”
Správce MCP serverů vyžaduje Cline 2.0 nebo novější. Otevřete panel rozšíření VS Code, najděte Cline a klikněte na Aktualizovat, pokud je dostupná aktualizace. Po aktualizaci znovu načtěte VS Code (Ctrl+Shift+P → “Developer: Reload Window”).
Otevřít Wink Portal Wink na GitHubu
