Přeskočit na obsah

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

Integrátor channel manageru se připojuje k jednomu koncovému bodu
claude mcp add wink-channel-manager https://integrations.wink.travel/mcp/channel-manager --transport http
Hotelier spravující vlastní ceny se připojuje k jinému
claude mcp add wink-rates https://api.wink.travel/mcp/extranet/rates --transport http

Proč 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ý bodNástrojeCo pokrývá
/mcp/extranet/facilities~64Rezervovatelný 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~62Záznam o nemovitosti a její obchodní podmínky: profil a obsah, doplňky, storno podmínky, výhody, oznámení
/mcp/settings~60Sprá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~48Publiková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~44Ceny a dostupnost: období sazeb a alokace inventáře, sazební plány, hlavní sazby, speciální a promo sazby
/mcp/extranet/operations~39Provoz živé nemovitosti: rezervace a jejich životní cyklus, recenze hostů a odpovědi, kalendářové zdroje, plánované úkoly
/mcp/extranet/distribution~37Kde se inventář prodává: prodejní kanály a modifikátory sazeb, žádosti o vztahy s affiliate a dodavateli, registrace, zachycení leadů
/mcp/studio/curation~35Budování kolekcí k prodeji: statické a dynamické seznamy, řazené seznamy, uložené vyhledávání, agregáty nemovitostí
/mcp/link-manager~28Syndikované kolekce odkazů, jejich design, kategorie a štítky, plus zkrácené URL
/mcp/reference~24Data pouze pro čtení: země, měny a směnné kurzy, jazyky, časová pásma, geografické vyhledávání, geolokace IP
/mcp/analytics~18Analytika rezervací a příjmů: přehledy, čárové grafy, žebříčky, výkon affiliate, metriky sdílení
/mcp/payment~18Finanční operace: účetní kniha, výběry a odhady poplatků, agregáty finančních prostředků rezervací
/mcp/booking-engine~17Cesta 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~17Připojené sociální účty, publikování a plánování příspěvků, čtení statistik příspěvků
/mcp/travel-agent~8Rezervace 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ý bodNástrojeCo pokrývá
/mcp/channel-manager~9Př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.

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 CRSintegrations.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í.


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

  1. Váš AI klient zjistí autorizační server z metadat MCP koncového bodu /.well-known/oauth-protected-resource.
  2. Klient se sám zaregistruje přes Dynamic Client Registration — není potřeba ruční nastavení aplikace.
  3. 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.
  4. Wink vydá přístupový token vázaný na váš účet a propojený s vaší identitou.
  5. 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.
  6. 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”
  1. Ujistěte se, že Claude Code je aktuální:

    Terminál
    npm install -g @anthropic-ai/claude-code
  2. 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
  3. Claude Code kontaktuje server, zjistí autorizační server a otevře váš výchozí prohlížeč.

  4. Přihlaste se do Wink a schvalte požadavek na oprávnění na obrazovce souhlasu.

  5. Claude Code potvrdí připojení. Zadejte /mcp pro 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:

Terminál
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

Př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.


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.remove jsou navíc vyžadována k otevření MCP transportu. Klient s oprávněním mcp.* 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.


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

Terminál
# Claude Code
claude mcp remove wink-rates
claude mcp add wink-rates https://api.wink.travel/mcp/extranet/rates --transport http

U 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