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.
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 httpZakaj 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.
Direktorij končnih točk
Section titled “Direktorij končnih točk”Dva gostitelja strežeta sklope orodij. Število orodij je približno in se s časom povečuje.
https://api.wink.travel — platforma
Section titled “https://api.wink.travel — platforma”| Končna točka | Orodja | Kaj pokriva |
|---|---|---|
/mcp/extranet/facilities | ~64 | Rezervabilni in na lokaciji inventar: sobe in tipi sob, spa, restavracije, sejna soba, aktivnosti, znamenitosti, kraji, drugi prodajni artikli |
/mcp/extranet/property | ~62 | Podatki o nepremičnini in njeni komercialni pogoji: profil in vsebina, dodatki, politike odpovedi, ugodnosti, obvestila |
/mcp/settings | ~60 | Upravljanje računa: profil in blagovna znamka upravljalske entitete, upravitelji in njihove pravice, prilagoditve, spletni klici, nastavitve obvestil |
/mcp/studio/embeds | ~48 | Objavljanje kuriranega inventarja: pripomočki, mreže in rangirane mreže, kartice, zemljevidi, globoke povezave do inventarja in strani dobaviteljev |
/mcp/extranet/rates | ~44 | Cene in razpoložljivost: obdobja in kvote inventarnih cen, cenovni načrti, glavne cene, posebne in promocijske cene |
/mcp/extranet/operations | ~39 | Upravljanje žive nepremičnine: rezervacije in njihov življenjski cikel, ocene gostov in odgovori, koledarski viri, načrtovane naloge |
/mcp/extranet/distribution | ~37 | Kje se prodaja inventar: prodajni kanali in modifikatorji cen, zahteve za partnerske in dobaviteljske odnose, registracija, zajem potencialnih strank |
/mcp/studio/curation | ~35 | Gradnja zbirk za prodajo: statični in dinamični seznami, rangirani seznami, shranjena iskanja, agregati nepremičnin |
/mcp/link-manager | ~28 | Sindicirane zbirke povezav, njihova zasnova, kategorije in oznake, ter skrajšani URL-ji |
/mcp/reference | ~24 | Podatki samo za branje: države, valute in menjalni tečaji, jeziki, časovne cone, geografski pregledi, IP geolokacija |
/mcp/analytics | ~18 | Analitika rezervacij in prihodkov: pregledi, črtni grafikoni, lestvice, uspešnost partnerjev, metrične delitve |
/mcp/payment | ~18 | Finančne operacije: knjiga, dvigi in ocene stroškov, agregati sredstev rezervacij |
/mcp/booking-engine | ~17 | Nakupna pot za potnike: iskanje in pregled, nakupovalna košarica in blagajna, sezname želja, prilagoditev kampanj |
/mcp/social | ~17 | Povezani družbeni računi, objavljanje in načrtovanje objav, branje vpogledov objav |
/mcp/travel-agent | ~8 | Rezervacije, 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čka | Orodja | Kaj pokriva |
|---|---|---|
/mcp/channel-manager | ~9 | Povezovanje 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.
Agentni plačilni sistemi
Section titled “Agentni plačilni sistemi”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.
Kateri sklopi orodij potrebujem?
Section titled “Kateri sklopi orodij potrebujem?”| Če ste… | Povežite se z |
|---|---|
| Integrirate upravljalca kanalov, PMS ali CRS | integrations.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.
Kako deluje avtentikacija
Section titled “Kako deluje avtentikacija”Wink MCP strežniki uporabljajo OAuth2 Authorization Code + PKCE tok in podpirajo Dynamic Client Registration (RFC 7591). Tako poteka ob prvi povezavi:
- Vaš AI odjemalec odkrije avtentikacijski strežnik iz metapodatkov MCP končne točke
/.well-known/oauth-protected-resource. - Odjemalec se sam registrira prek Dynamic Client Registration — ni potrebna ročna nastavitev aplikacije.
- Odjemalec odpre zavihek brskalnika na
https://iam.wink.travel. Prijavite se z Wink računom in odobrite zahtevana dovoljenja na zaslonu za soglasje. - Wink izda dostopni žeton, vezan na vaš račun in identiteto.
- AI odjemalec priloži žeton vsakemu MCP zahtevku. Vsi rezultati orodij so samodejno omejeni na vašo upravljalsko entiteto.
- Ž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.
Povežite svoj AI odjemalec
Section titled “Povežite svoj AI odjemalec”Dodajte vsak sklop orodij v Claude kot prilagojeni priključek. Ni konfiguracijske datoteke za urejanje in ni treba ustvarjati aplikacije ali skrivnosti.
-
V Claudu odprite Customize › Connectors, kliknite Add, nato Add custom connector.
-
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-managerKliknite Continue.
-
Claude zazna Wink prijavo. Pustite Authentication: Sign in now in OAuth client: Register automatically, nato kliknite Add.
-
Kliknite Connect. Odpre se stran za prijavo Wink na
https://iam.wink.travel. Prijavite se v Wink in odobrite dovoljenja na zaslonu za soglasje. -
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.
-
Prepričajte se, da je Claude Code posodobljen:
Terminal window npm install -g @anthropic-ai/claude-code -
Izberite sklop orodij iz zgornjega direktorija in ga dodajte. Na primer, cene in razpoložljivost:
Terminal window claude mcp add wink-rates https://api.wink.travel/mcp/extranet/rates --transport http -
Claude Code kontaktira strežnik, odkrije avtentikacijski strežnik in odpre vaš privzeti brskalnik.
-
Prijavite se v Wink in odobrite zahtevo za dovoljenje na zaslonu za soglasje.
-
Claude Code potrdi povezavo. Vnesite
/mcpza preverjanje, da se strežnik pojavi in so orodja naložena.
Dodajte toliko sklopov orodij, kot jih vaše delo potrebuje — vsak je ločen vnos strežnika z lastnim imenom:
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 httpPrijavite se samo enkrat. Po prvi odobritvi v brskalniku Claude Code ponovno uporablja vašo Wink sejo za dodatne Wink končne točke.
-
Uredite konfiguracijsko datoteko 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:
-
Dodajte vnose MCP strežnikov:
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"}}} -
Popolnoma zaprite in ponovno zaženite Claude Desktop (uporabite Quit iz menijske vrstice — samo zapiranje okna ni dovolj).
-
Claude Desktop odpre zavihek brskalnika za vsak nov strežnik. Prijavite se v Wink in odobrite dovoljenja.
-
Ikona vtičnice v spodnji orodni vrstici pokaže oba strežnika kot povezana.
-
Prepričajte se, da je Codex CLI nameščen:
Terminal window npm install -g @openai/codex -
Odprite (ali ustvarite) konfiguracijsko datoteko Codex:
- macOS / Linux:
~/.codex/config.json - Windows:
%USERPROFILE%\.codex\config.json
- macOS / Linux:
-
Dodajte vnose Wink MCP strežnikov:
~/.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"}}} -
Zaženite Codex. Ob prvi uporabi Codex odpre zavihek brskalnika na
https://iam.wink.travel. -
Prijavite se v Wink in odobrite zahtevana dovoljenja.
-
Codex potrdi povezavo. Zaženite
codexin ga prosite, naj izpiše razpoložljiva orodja, da preverite, ali so Wink strežniki aktivni.
Podpora MCP strežnikov je na voljo v ChatGPT namizni aplikaciji za naročnike Plus, Pro, Team in Enterprise.
-
Prenesite in namestite ChatGPT namizno aplikacijo, če je še nimate.
-
Odprite aplikacijo in kliknite ikono svojega profila v zgornjem desnem kotu, nato izberite Settings.
-
Pojdite na Connectors (ali MCP Servers glede na različico aplikacije) in kliknite Add.
-
Vnesite URL sklopa orodij iz zgornjega direktorija, na primer:
https://api.wink.travel/mcp/extranet/ratesNato kliknite Connect.
-
ChatGPT odpre zavihek brskalnika na
https://iam.wink.travel. Prijavite se v Wink in odobrite dovoljenja. -
Ponovite koraka 4–5 za vsak drug sklop orodij, ki ga vaše delo potrebuje, na primer:
https://api.wink.travel/mcp/extranet/operations -
Vsak sklop orodij se prikaže na seznamu vaših priključkov. Začnite nov klepet — Wink orodja so samodejno na voljo.
-
Odprite (ali ustvarite) konfiguracijsko datoteko Cursor MCP:
- macOS / Linux:
~/.cursor/mcp.json - Windows:
%USERPROFILE%\.cursor\mcp.json
- macOS / Linux:
-
Dodajte vnose Wink MCP strežnikov:
~/.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"}}} -
Odprite Cursor. Pojdite na Settings → Cursor Settings → MCP in potrdite, da se oba strežnika prikažeta z zelenim indikatorjem stanja. Če sta rdeča, kliknite Refresh.
-
Cursor odpre zavihek brskalnika na
https://iam.wink.travel. Prijavite se v Wink in odobrite dovoljenja. -
Odprite klepet (
Ctrl+L/Cmd+L) in prosite Cursor, naj izpiše razpoložljiva Wink orodja za potrditev povezave.
-
Odprite (ali ustvarite) konfiguracijsko datoteko Windsurf MCP:
- macOS / Linux:
~/.codeium/windsurf/mcp_config.json - Windows:
%USERPROFILE%\.codeium\windsurf\mcp_config.json
- macOS / Linux:
-
Dodajte vnose Wink MCP strežnikov:
~/.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"}}} -
Popolnoma znova zaženite Windsurf (Datoteka → Quit, nato ponovno odprite).
-
Pojdite na Settings → MCP Servers in preverite, da sta oba strežnika prikazana kot povezana. Windsurf ob prvi uporabi odpre zavihek brskalnika na
https://iam.wink.travel. -
Prijavite se v Wink in odobrite dovoljenja. Strežniki postanejo zeleni v nastavitvah, ko so avtenticirani.
Cline je razširitev za VS Code z vgrajenim upravljalcem MCP strežnikov. Ročno urejanje JSON ni potrebno.
-
Namestite Cline iz VS Code Marketplace:
- Odprite VS Code in pritisnite
Ctrl+Shift+X/Cmd+Shift+X - Poiščite Cline in kliknite Install
- Odprite VS Code in pritisnite
-
Kliknite ikono Cline v vrstici aktivnosti (levi stranski meni) za odprtje panela Cline.
-
Kliknite ikono MCP Servers (ikona vtičnice) v orodni vrstici Cline, nato izberite Edit MCP Settings.
-
VS Code odpre
cline_mcp_settings.json. Dodajte Wink vnose: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"}}} -
Shrani datoteko. Cline se samodejno ponovno naloži in odpre zavihek brskalnika na
https://iam.wink.travel. -
Prijavite se v Wink in odobrite dovoljenja. Oba strežnika se prikažeta kot aktivna v panelu MCP Servers.
Obsegi
Section titled “Obsegi”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.removeso dodatno zahtevani za odprtje MCP transporta. Odjemalec z obsegommcp.*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.
Reševanje težav
Section titled “Reševanje težav”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:
# Claude Codeclaude mcp remove wink-ratesclaude mcp add wink-rates https://api.wink.travel/mcp/extranet/rates --transport httpZa 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
