Skip to content

MCP strežniki

Winkova MCP orodja so objavljena kot sklopi orodij — osredotočene končne točke, vsaka pokriva eno nalogo. Povežete svoj AI odjemalec z eno ali dvema, ki ustrezata vašemu delu, ne z vsemi.

Vsaka končna točka uporablja interaktivno OAuth2 prijavo (PKCE avtentikacijski tok): vaš AI agent odpre zavihek brskalnika, se prijavite z vašim Wink računom in to je to. Ni treba upravljati skrivnosti odjemalca.

Integrator upravljalca kanalov se poveže z eno končno točko
claude mcp add wink-channel-manager https://integrations.wink.travel/mcp/channel-manager --transport http
Hotelir, ki upravlja lastne cene, se poveže z drugo
claude mcp add wink-rates https://api.wink.travel/mcp/extranet/rates --transport http

Zakaj so orodja razdeljena po končnih točkah

Section titled “Zakaj so orodja razdeljena po končnih točkah”

Wink ponuja okoli 500 orodij. Predati jih vsem agentu naenkrat je tehnično mogoče — a slaba ideja.

Definicije orodij porabijo kontekst. Vsako orodje, ki ga MCP strežnik oglašuje, se naloži v kontekstno okno modela pred začetkom dela, skupaj z opisom in celotno shemo parametrov. Petsto takih orodij porabi velik del proračuna, ki ga vaša dejanska naloga potrebuje, pri vsakem posameznem zahtevku.

Kakovost izbire pada z rastjo seznama. Agent, ki izbira med 500 podobno poimenovanimi orodji, sprejema slabše odločitve kot agent, ki izbira med 40. Če integrirate upravljalca kanalov, je približno dvajset orodij relevantnih za vas; ostalih 480 je šum, ki otežuje iskanje pravega orodja.

Delo je res ločljivo. Nekdo, ki sinhronizira razpoložljivost iz PMS, in nekdo, ki ureja partnerske pristajalne strani, skoraj ne delita nobenega orodja. Razdelitev po nalogah pomeni, da vsaka povezava nosi besedišče ene naloge.


Dva gostitelja strežeta sklope orodij. Število orodij je približno in se s časom povečuje.

Končna točkaOrodjaKaj pokriva
/mcp/extranet/facilities~64Rezervabilni in na lokaciji inventar: sobe in tipi sob, spa, restavracije, sejna soba, aktivnosti, znamenitosti, kraji, drugi prodajni artikli
/mcp/extranet/property~62Podatki o nepremičnini in njeni komercialni pogoji: profil in vsebina, dodatki, politike odpovedi, ugodnosti, obvestila
/mcp/settings~60Upravljanje računa: profil in blagovna znamka upravljalske entitete, upravitelji in njihove pravice, prilagoditve, spletni klici, nastavitve obvestil
/mcp/studio/embeds~48Objavljanje kuriranega inventarja: pripomočki, mreže in rangirane mreže, kartice, zemljevidi, globoke povezave do inventarja in strani dobaviteljev
/mcp/extranet/rates~44Cene in razpoložljivost: obdobja in kvote inventarnih cen, cenovni načrti, glavne cene, posebne in promocijske cene
/mcp/extranet/operations~39Upravljanje žive nepremičnine: rezervacije in njihov življenjski cikel, ocene gostov in odgovori, koledarski viri, načrtovane naloge
/mcp/extranet/distribution~37Kje se prodaja inventar: prodajni kanali in modifikatorji cen, zahteve za partnerske in dobaviteljske odnose, registracija, zajem potencialnih strank
/mcp/studio/curation~35Gradnja zbirk za prodajo: statični in dinamični seznami, rangirani seznami, shranjena iskanja, agregati nepremičnin
/mcp/link-manager~28Sindicirane zbirke povezav, njihova zasnova, kategorije in oznake, ter skrajšani URL-ji
/mcp/reference~24Podatki samo za branje: države, valute in menjalni tečaji, jeziki, časovne cone, geografski pregledi, IP geolokacija
/mcp/analytics~18Analitika rezervacij in prihodkov: pregledi, črtni grafikoni, lestvice, uspešnost partnerjev, metrične delitve
/mcp/payment~18Finančne operacije: knjiga, dvigi in ocene stroškov, agregati sredstev rezervacij
/mcp/booking-engine~17Nakupna pot za potnike: iskanje in pregled, nakupovalna košarica in blagajna, sezname želja, prilagoditev kampanj
/mcp/social~17Povezani družbeni računi, objavljanje in načrtovanje objav, branje vpogledov objav
/mcp/travel-agent~8Rezervacije, ki jih opravi agent v imenu potnikov, in agentova poročila

https://integrations.wink.travel — integracije upravljalcev kanalov

Section titled “https://integrations.wink.travel — integracije upravljalcev kanalov”

Ena končna točka, ker ta gostitelj obstaja za eno nalogo.

Končna točkaOrodjaKaj pokriva
/mcp/channel-manager~9Povezovanje in preverjanje upravljalca kanalov, PMS ali CRS integracije

Vsaka končna točka ima tudi orodje ping, tako da lahko potrdite, da je povezava aktivna, preden zahtevate dejansko delo.

Za popoln potek rezervacije potnika povežite Wink Booking Engine na https://api.wink.travel/mcp/booking-engine in združljiv plačilni denarnici. Dodajanje Wink MCP odpre prijavo v brskalniku in izbiro dovoljenj; vaš odjemalec nato upravlja avtentikacijo.

Booking Engine vključuje iskanje destinacij, iskanje hotelov in sob, agentic_booking_quote, agentic_booking_pay, agentic_booking_book, pridobivanje rezervacij in račune, ko so agentne rezervacije in plačila omogočeni za to okolje. Oglejte si Agentic Payments za nastavitev povezave, dovoljenja za izbiro in korake od iskanja do potrditve.


Če ste…Povežite se z
Integrirate upravljalca kanalov, PMS ali CRSintegrations.wink.travel/mcp/channel-manager — samo ta
Upravljate vsebino nepremičnine/mcp/extranet/property + /mcp/extranet/facilities
Upravljate sobe in tipe sob/mcp/extranet/facilities
Upravljate cene in razpoložljivost/mcp/extranet/rates
Upravljate dnevne rezervacije/mcp/extranet/operations
Širite distribucijo/mcp/extranet/distribution + /mcp/analytics
Gradite partnerske strani/mcp/studio/curation + /mcp/studio/embeds
Upravljate strani z linki v bio/mcp/link-manager + /mcp/social
Rezervirate v imenu potnikov/mcp/travel-agent
Poravnate denar/mcp/payment
Rezervirate sobo z AI agentom/mcp/booking-engine + združljiva plačilna denarnica — glejte Agentic Payments
Gradite rezervacijsko izkušnjo/mcp/booking-engine; po želji /mcp/reference za dodatne preglede

Booking Engine vključuje osnovni rezervacijski potek. Omogoča odkrivanje računa in prilagoditev, iskanje destinacij, razpoložljivost hotelov in podrobnosti o cenah sob, nakupovalne košarice, blagajno in upravljanje rezervacij potnikov. Agentna orodja za rezervacije in plačila so vključena, ko so omogočena za to okolje.

Za iskanje hotelov v mestu uporabite destination_lookup_search_suggestions za določitev destinacije, nato inventory_search_city za iskanje razpoložljivih hotelov in cen. Obe orodji sta v /mcp/booking-engine, zato ta potek ne zahteva povezave Reference.

Dodajte /mcp/reference, ko potrebujete podporne preglede, kot so države, valute in menjalni tečaji, podprti jeziki, časovne cone, širša geografska iskanja, OTA klasifikacije ali javno znanje o nepremičninah. To so neobvezni dodatki k rezervacijskemu poteku.

Začnite z enim. Dodajte drugega, ko ugotovite, da nekaj ne zmore — vsaka povezava je neodvisna in dodajanje ene ne vpliva na druge.


Wink MCP strežniki uporabljajo OAuth2 Authorization Code + PKCE tok in podpirajo Dynamic Client Registration (RFC 7591). Tako poteka ob prvi povezavi:

  1. Vaš AI odjemalec odkrije avtentikacijski strežnik iz metapodatkov MCP končne točke /.well-known/oauth-protected-resource.
  2. Odjemalec se sam registrira prek Dynamic Client Registration — ni potrebna ročna nastavitev aplikacije.
  3. Odjemalec odpre zavihek brskalnika na https://iam.wink.travel. Prijavite se z Wink računom in odobrite zahtevana dovoljenja na zaslonu za soglasje.
  4. Wink izda dostopni žeton, vezan na vaš račun in identiteto.
  5. AI odjemalec priloži žeton vsakemu MCP zahtevku. Vsi rezultati orodij so samodejno omejeni na vašo upravljalsko entiteto.
  6. Žetoni potečejo po 3 urah. Vaš AI odjemalec tiho osveži žeton v ozadju brez ponovne zahteve po prijavi.

Vsak klic orodja teče pod vašo identiteto — enaka pravila ACL, ki varujejo spletni portal, veljajo tudi za AI agenta.


Dodajte vsak sklop orodij v Claude kot prilagojeni priključek. Ni konfiguracijske datoteke za urejanje in ni treba ustvarjati aplikacije ali skrivnosti.

  1. V Claudu odprite Customize › Connectors, kliknite Add, nato Add custom connector.

  2. Vnesite Ime (na primer Wink Link manager) in kot URL MCP strežnika sklop orodij iz zgornjega direktorija, na primer:

    https://api.wink.travel/mcp/link-manager

    Kliknite Continue.

  3. Claude zazna Wink prijavo. Pustite Authentication: Sign in now in OAuth client: Register automatically, nato kliknite Add.

  4. Kliknite Connect. Odpre se stran za prijavo Wink na https://iam.wink.travel. Prijavite se v Wink in odobrite dovoljenja na zaslonu za soglasje.

  5. Orodja priključka so zdaj na voljo v vaših klepetih. Postopek ponovite za vsak sklop orodij, ki ga vaše delo potrebuje; vsak je svoj priključek.


Ko odobrite zaslon za soglasje, boste videli razčlenitev, kaj agent zahteva. MCP odjemalci uporabljajo isto dovoljenjsko besedišče kot preostala platforma — glejte celoten referenčni seznam obsegov na strani Avtentikacija.

Tri stvari so specifične za MCP:

  • Obsegi mcp.read, mcp.write, mcp.remove so dodatno zahtevani za odprtje MCP transporta. Odjemalec z obsegom mcp.* je sprejet na katerokoli Wink MCP končno točko, a vsako orodje, ki ga kliče, še vedno uveljavlja obseg sekcije končne točke, ki jo ovija (npr. booking.read).
  • MCP vedno deluje kot prijavljen uporabnik. AI odjemalec prejme obsege mcp.* prek vaše prijave, nikoli iz Aplikacije, ki jo ustvarite. Žetoni stroj-stroj (client-credentials) ne morejo odpreti MCP transporta; za delo strežnik-strežnik uporabite REST API.
  • AI odjemalec zahteva samo obsege, ki jih potrebuje. Posamezna dovoljenja lahko zavrnete na zaslonu za soglasje — orodja, ki zahtevajo zavrnjeni obseg, bodo ob klicu vrnila napako.

Sklopi orodij tega ne spreminjajo. Končna točka, na katero se povežete, določa, katera orodja so na seznamu, ne pa, kaj so dovoljena. Povezava na /mcp/payment ne podeli nobenih finančnih dovoljenj, ki jih že nimate, in povezava na /mcp/reference ne prepreči orodju, da uveljavlja svoj obseg. Avtentikacija se odloča pri vsakem klicu orodja, na podlagi vašega žetona in pravic računa.


Zavihek brskalnika se ne odpre

Vaš AI odjemalec morda še ne podpira interaktivnega PKCE toka. Preverite, da uporabljate najnovejšo različico:

  • Claude Code: npm install -g @anthropic-ai/claude-code
  • Codex CLI: npm install -g @openai/codex
  • Claude Desktop / ChatGPT namizna aplikacija: posodobite prek vgrajenega posodabljalnika aplikacije

401 Unauthorized po prijavi

Vaš predpomnjeni žeton je morda zastarel. Odstranite in ponovno dodajte strežnik, da sprožite novo prijavo:

Terminal window
# Claude Code
claude mcp remove wink-rates
claude mcp add wink-rates https://api.wink.travel/mcp/extranet/rates --transport http

Za Claude Desktop in ChatGPT odstranite vnos strežnika iz nastavitev, znova zaženite aplikacijo in ga dodajte znova.

403 Forbidden pri klicu določenega orodja

Orodje zahteva obseg, ki ga niste odobrili na zaslonu za soglasje, ali dovoljenje, ki ga vaš račun nima. Ponovno povežite strežnik — zaslon za soglasje se bo prikazal znova in lahko odobrite manjkajoče dovoljenje. Če še vedno ne deluje, orodje potrebuje dovoljenje računa, ki ga nimate; povezava na drug sklop orodij ne bo pomagala, ker sklopi ne podeljujejo dovoljenj.

Orodje, ki ga potrebujem, ni na seznamu

Verjetno ste povezani s sklopom orodij, ki ne pokriva te naloge. Preverite direktorij končnih točk in dodajte sklop, ki jo pokriva — povezave so neodvisne, zato dodajanje enega ne spremeni drugih. Če niste prepričani, kateri ga ima, začasno se povežite na https://api.wink.travel/mcp, poiščite orodje in nato preverite, kateri sklop ga navaja.

404 Not Found na končni točki sklopa orodij

Preverite pot natančno — gnezdeni sklopi imajo dva segmenta (/mcp/extranet/rates, ne /mcp/extranet-rates), ploski pa enega (/mcp/link-manager). Upoštevajte, da neavtenticiran zahtevek na katerokoli pot pod /mcp vrne 401, ne 404, zato sam 401 ne pove, ali končna točka obstaja.

Povezal sem se na api.wink.travel/mcp/channel-manager in nisem dobil ničesar

Ta končna točka ne obstaja. Integracija upravljalca kanalov je na voljo samo na https://integrations.wink.travel/mcp/channel-manager. Če morate tudi ročno brati ali pisati lastne cene nepremičnine, je to ločena naloga na ločeni končni točki — glejte /mcp/extranet/rates.

Strežnik se prikaže, a klici orodij vrnejo “račun ni najden”

Prijavljeni ste v Wink račun, ki nima upravljalske entitete. Obiščite Wink Portal in poskrbite, da je vaš račun nastavljen, preden uporabljate MCP strežnik.

Žeton poteče med sejo

Žetoni veljajo 3 ure. Claude Code in Claude Desktop tiho osvežujeta žetone brez prekinitve seje. Če po dolgem obdobju neaktivnosti vidite napake avtentikacije, vnesite novo sporočilo — odjemalec se bo samodejno ponovno avtenticiral.

Codex CLI prikazuje “MCP server unreachable”

Preverite, da je vaša datoteka ~/.codex/config.json veljaven JSON (brez odvečnih vejic) in da je "type": "http" nastavljeno. Codex zahteva HTTP transport za oddaljene strežnike; stdio transport je samo za lokalne binarne datoteke.

V meniju ChatGPT “Connectors” manjka

Podpora MCP zahteva različico namizne aplikacije ChatGPT 1.2024.352 ali novejšo in aktivno naročnino Plus, Pro, Team ali Enterprise. Posodobite aplikacijo in preverite svoj načrt v Nastavitve → Račun.

Cursor strežnik kaže rdeče / “Failed to connect”

Preverite, da je vaša datoteka ~/.cursor/mcp.json veljaven JSON in vsebuje "type": "http". Nato pojdite na Settings → Cursor Settings → MCP in kliknite Refresh. Če napaka ostaja, popolnoma znova zaženite Cursor — spremembe konfiguracije niso vedno zaznane brez ponovnega zagona.

Windsurf MCP strežniki niso na seznamu v nastavitvah

Windsurf zahteva popoln ponovni zagon (ne samo osvežitev okna) za zaznavo sprememb v mcp_config.json. Uporabite File → Quit in ponovno zaženite. Če strežniki še vedno niso prikazani, preverite, da imate Windsurf 1.4+ prek Help → About Windsurf.

V Cline ni vidna možnost “Add Server”

Upravitelj MCP strežnikov zahteva Cline 2.0 ali novejšo različico. Odprite panel razširitev VS Code, poiščite Cline in kliknite Update, če je na voljo posodobitev. Po posodobitvi znova naložite VS Code (Ctrl+Shift+P → “Developer: Reload Window”).


Odpri Wink Portal Wink na GitHubu