MCP servery
Nástroje MCP od Wink jsou zveřejně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 prohlížeče, 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 všechny najednou agentovi je technicky možné — ale š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í schémou 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ž ten, kdo vybírá 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, kdo synchronizuje dostupnost z PMS, a někdo, kdo spravuje affiliate landing pages, 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ář: hostinské 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í oznámení |
/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, zachytávání leadů |
/mcp/studio/curation | ~35 | Budování obchodovatelných kolekcí: 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 rezervovaných fondů |
/mcp/booking-engine | ~17 | Cesta nákupu pro cestovatele: vyhledávání a dohledávání, nákupní košík a pokladna, bucket listy, 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 agentní 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.
Agentní platby
Sekce “Agentní 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 agentní rezervace a platby povoleny pro dané prostředí. Viz Agentní platby pro nastavení připojení, oprávnění k výběru 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 Agentní platby |
| 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 objevování účtu a přizpůsobení, dohledávání destinací, dostupnost hotelů a detaily sazeb pokojů, nákupní košíky, pokladnu a správu rezervací cestovatelů. Agentní nástroje pro rezervace a platby jsou také zahrnuty, pokud jsou povoleny pro dané prostředí.
Pro vyhledávání hotelů ve městě použijte destination_lookup_search_suggestions k určení destinace, pak 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 tok 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 manuální nastavení aplikace.
- Klient otevře záložku prohlížeče 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”Přidejte každý toolset do Claude jako vlastní konektor. Není potřeba upravovat konfigurační soubor ani vytvářet aplikaci či tajemství.
-
V Claude otevřete Customize › Connectors, klikněte na Add, pak Add custom connector.
-
Zadejte Název (například Wink Link manager) a jako URL MCP serveru toolset z adresáře výše, například:
https://api.wink.travel/mcp/link-managerKlikněte na Continue.
-
Claude detekuje přihlášení Wink. Nechte Authentication: Sign in now a OAuth client: Register automatically, pak klikněte na Add.
-
Klikněte na Connect. Otevře se přihlašovací stránka Wink na
https://iam.wink.travel. Přihlaste se do Wink a schvalte oprávnění na obrazovce souhlasu. -
Nástroje konektoru jsou nyní dostupné ve vašich chatech. Opakujte pro každý toolset, který vaše práce potřebuje; každý je samostatný konektor.
-
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 aktivní 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 pouze jednou. Po prvním schválení v prohlížeči Claude Code znovu používá 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 prohlížeče. Přihlaste se do Wink a schvalte oprávnění.
-
Ikona zástrčky v dolním panelu ukazuje 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 prohlížeče 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, pak vyberte Nastavení.
-
Přejděte na Connectors (nebo MCP Servers podle verze aplikace) a klikněte na Add.
-
Zadejte URL toolsetu z adresáře výše, například:
https://api.wink.travel/mcp/extranet/ratesPak klikněte na Connect.
-
ChatGPT otevře záložku prohlížeče 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 Settings → Cursor Settings → MCP a ověřte, že oba servery mají zelený stav. Pokud jsou červené, klikněte na Refresh.
-
Cursor otevře záložku prohlížeče 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 Settings → MCP Servers a ověřte, že oba servery jsou připojené. Windsurf při prvním použití otevře záložku prohlížeče na
https://iam.wink.travel. -
Přihlaste se do Wink a schvalte oprávnění. Servery se v nastavení rozsvítí zeleně po autentizaci.
Cline je rozšíření VS Code s vestavěným správcem MCP serverů. Není potřeba ručně upravovat JSON.
-
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 Install
- Otevřete VS Code a stiskněte
-
Klikněte na ikonu Cline v Activity Bar (levý panel) pro otevření panelu Cline.
-
Klikněte na ikonu MCP Servers (ikona zástrčky) v nástrojové liště Cline, pak vyberte Edit MCP Settings.
-
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 prohlížeče na
https://iam.wink.travel. -
Přihlaste se do Wink a schvalte oprávnění. Oba servery se zobrazí jako aktivní v panelu MCP Servers.
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í stejný slovník oprávnění jako zbytek platformy — viz kompletní referenční seznam oprávnění na stránce Autentizace.
Tři věci jsou specifické pro MCP:
- Oprávnění
mcp.read,mcp.write,mcp.removejsou navíc vyžadována pro 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). - MCP vždy jedná jako přihlášený uživatel. AI klient získává oprávnění
mcp.*prostřednictvím vašeho přihlášení, nikdy z Aplikace, kterou vytvoříte. Tokeny stroj-stroj (client-credentials) nemohou otevřít MCP transport; pro server-server práci použijte REST API. - AI klient žádá pouze o oprávnění, která potřebuje. Můžete na obrazovce souhlasu zamítnout jednotlivá oprávnění — 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 neuděluje žádné finanční oprávnění, které jste již neměli, a připojení k /mcp/reference nezabrání nástroji tam vynucovat vlastní oprávnění. Autorizace se rozhoduje pro každé volání nástroje podle 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 prohlížeče
Váš AI klient možná ještě nepodporuje interaktivní PKCE tok. 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ý. Odeberte 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 httpPro 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á. Znovu připojte server — 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 neudělují 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 uvádí.
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 závěrečný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 Settings → Cursor Settings → MCP a klikněte na Refresh. 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 verzi 1.4+ přes Nápověda → O Windsurf.
V Cline není viditelná volba “Add Server”
Správce MCP serverů vyžaduje Cline verzi 2.0 nebo novější. Otevřete panel rozšíření VS Code, najděte Cline a klikněte na Update, 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
