Přeskočit na obsah

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

Integrator 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í sazby 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 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ý bodNástrojeCo pokrývá
/mcp/extranet/facilities~64Rezervovatelný 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~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í oznámení
/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, zachytávání leadů
/mcp/studio/curation~35Budování obchodovatelných kolekcí: 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 rezervovaných fondů
/mcp/booking-engine~17Cesta 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~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 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ý 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 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 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 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í.


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

  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 manuální nastavení aplikace.
  3. 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.
  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”

Přidejte každý toolset do Claude jako vlastní konektor. Není potřeba upravovat konfigurační soubor ani vytvářet aplikaci či tajemství.

  1. V Claude otevřete Customize › Connectors, klikněte na Add, pak Add custom connector.

  2. 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-manager

    Klikněte na Continue.

  3. Claude detekuje přihlášení Wink. Nechte Authentication: Sign in now a OAuth client: Register automatically, pak klikněte na Add.

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

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


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.remove jsou navíc vyžadována pro 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).
  • 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.


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

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

Pro 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