MCP strežniki
Winkova MCP orodja so objavljena kot nabori 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 potek s kodo za avtorizacijo): 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, preden opravi kakršnokoli delo, 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 tisti, 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 resnično 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.
Katalog končnih točk
Section titled “Katalog končnih točk”Dva gostitelja strežeta naborom 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 za goste in vrste 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 upravljavca, upravitelji in njihove pravice, prilagoditve, spletni klici, nastavitve obvestil |
/mcp/studio/embeds | ~48 | Objavljanje kuriranega inventarja: vtičniki, 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 zbirateljskih kolekcij: statični in dinamični seznami, rangirani seznami, shranjeni iskalni pojmi, 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, geografske poizvedbe, 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 potnika: iskanje in poizvedba, nakupovalna košarica in zaključek nakupa, sezname želja, prilagoditev kampanj |
/mcp/social | ~17 | Povezani družbeni računi, objavljanje in načrtovanje objav, branje vpogledov v objave |
/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.
Agentne plačilne storitve
Section titled “Agentne plačilne storitve”Za popoln potek rezervacije potnika povežite Wink Booking Engine na https://api.wink.travel/mcp/booking-engine in združljiv plačilni denarnico. Dodajanje Wink MCP odpre prijavo v brskalniku in izbiro dovoljenj; vaš odjemalec nato upravlja avtentikacijo.
Booking Engine vključuje iskanje destinacije, iskanje hotelov in sob, agentic_booking_quote, agentic_booking_pay, agentic_booking_book, pridobivanje rezervacij in potrdil, ko so agentne rezervacije in plačila omogočene za to okolje. Oglejte si Agentic Payments za nastavitev povezave, dovoljenja za izbiro in korake od iskanja do potrditve.
Kateri nabor orodij potrebujem?
Section titled “Kateri nabor 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 vrste 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 link-in-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 poizvedbe |
Booking Engine vključuje osnovni rezervacijski potek. Omogoča odkrivanje računa in prilagoditev, iskanje destinacije, razpoložljivost hotelov in podrobnosti cen sob, nakupovalne košarice, zaključek nakupa 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 poizvedbe, kot so države, valute in menjalni tečaji, podprti jeziki, časovne cone, širše geografske poizvedbe, 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 potek 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 upravljavsko 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”-
Prepričajte se, da je Claude Code posodobljen:
Terminal window npm install -g @anthropic-ai/claude-code -
Izberite nabor orodij iz zgornjega kataloga 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 dovoljenja na zaslonu za soglasje.
-
Claude Code potrdi povezavo. Vnesite
/mcpza preverjanje, da se strežnik prikaže in so orodja naložena.
Dodajte toliko naborov 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 uporabi 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 Nastavitve.
-
Pojdite na Povezovalnike (ali MCP strežniki, odvisno od različice aplikacije) in kliknite Dodaj.
-
Vnesite URL nabora orodij iz zgornjega kataloga, na primer:
https://api.wink.travel/mcp/extranet/ratesNato kliknite Poveži.
-
ChatGPT odpre zavihek brskalnika na
https://iam.wink.travel. Prijavite se v Wink in odobrite dovoljenja. -
Ponovite koraka 4–5 za vsak drug nabor orodij, ki ga vaše delo potrebuje, na primer:
https://api.wink.travel/mcp/extranet/operations -
Vsak nabor orodij se prikaže na seznamu Povezovalnikov. Začnite nov pogovor — 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 Nastavitve → Nastavitve Cursor → MCP in potrdite, da se oba strežnika prikažeta z zelenim indikatorjem stanja. Če sta rdeča, kliknite Osveži.
-
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, da potrdite povezavo.
-
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 ponovno zaženite Windsurf (Datoteka → Izhod, nato ponovno odprite).
-
Pojdite na Nastavitve → MCP strežniki 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 nastavitvenem panelu, 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 tržnice VS Code:
- Odprite VS Code in pritisnite
Ctrl+Shift+X/Cmd+Shift+X - Poiščite Cline in kliknite Namesti
- Odprite VS Code in pritisnite
-
Kliknite ikono Cline v vrstici aktivnosti (levi stranski meni), da odprete panel Cline.
-
Kliknite ikono MCP strežniki (ikona vtičnice) v orodni vrstici Cline, nato izberite Uredi nastavitve MCP.
-
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 strežnikov.
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.
Dve stvari sta specifični za MCP:
- Obsegi
mcp.read,mcp.write,mcp.removeso dodatno zahtevani za odprtje MCP transporta. Odjemalec z obsegommcp.*je sprejet na katerikoli Wink MCP končni točki, a vsako orodje, ki ga kliče, še vedno uveljavlja obseg sekcije končne točke, ki jo ovija (npr.booking.read). - 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.
Nabori orodij tega ne spreminjajo. Končna točka, s 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. Avtorizacija se odloča za vsak klic orodja posebej, na podlagi vašega žetona in pravic vašega 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 poteka. 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 potekel. 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 nabor orodij ne pomaga, ker nabori orodij ne podeljujejo dovoljenj.
Orodje, ki ga potrebujem, ni na seznamu
Verjetno ste povezani z naborom orodij, ki ne pokriva te naloge. Preverite katalog končnih točk in dodajte nabor orodij, ki jo pokriva — povezave so neodvisne, zato dodajanje enega ne spremeni drugih. Če niste prepričani, kateri jo ima, začasno se povežite na https://api.wink.travel/mcp, poiščite orodje in nato preverite, kateri nabor orodij ga vsebuje.
404 Not Found na končni točki nabora orodij
Preverite pot natančno — gnezdeni nabori orodij imajo dva segmenta (/mcp/extranet/rates, ne /mcp/extranet-rates), ploski pa enega (/mcp/link-manager). Upoštevajte, da neavtenticiran zahtevek na katerikoli poti 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 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 upravljavske 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.
Meni “Connectors” v ChatGPT 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 Nastavitve → Nastavitve Cursor → MCP in kliknite Osveži. Č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), da zazna spremembe v mcp_config.json. Uporabite Datoteka → Izhod in ponovno zaženite. Če strežniki še vedno niso prikazani, preverite, da imate Windsurf 1.4+ prek Pomoč → O Windsurf.
Možnost “Add Server” v Cline ni vidna
Upravitelj MCP strežnikov zahteva Cline 2.0 ali novejši. Odprite panel razširitev VS Code, poiščite Cline in kliknite Posodobi, če je na voljo. Po posodobitvi znova naložite VS Code (Ctrl+Shift+P → “Developer: Reload Window”).
Odpri Wink Portal Wink na GitHubu
