MCP strežniki

Winkova orodja MCP 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 prijavo OAuth2 (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.

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

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 upada 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; preostalih 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 orodij. Razdelitev po nalogah pomeni, da vsaka povezava nosi besedišče ene naloge.

Sklopi orodij niso dovoljenja

Izbira ozkega sklopa orodij ne omejuje, kaj lahko vaš račun počne, in izbira širokega ne podeli ničesar dodatnega. Vsako orodje uveljavlja enaka dovoljenja računa kot spletni portal, pod vašo prijavljeno identiteto. Če vaš račun ne more preklicati rezervacije v Wink Portalu, agent tudi ne more — ne glede na to, s katero končno točko je povezan.

Izberite sklope orodij za osredotočenost, ne za varnost.

---

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

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 potnike: iskanje in poizvedbe, nakupovalni voziček in zaključek nakupa, sezname želja, prilagoditve 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 poročila agentov

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

Integracija upravljalca kanalov vs. upravljanje lastnih cen

To so različne naloge za različne ljudi in ne delijo končne točke.

Prodajalec upravljalca kanalov, PMS ali CRS se enkrat integrira prek integrations.wink.travel/mcp/channel-manager in nato izmenjuje nepremičnine, cene, razpoložljivost in rezervacije prek te integracije. Ta ena končna točka je celotna površina.

Hotelir, ki ročno spreminja lastne cene, uporablja orodja extranet na api.wink.travel — /mcp/extranet/rates in sorodne. Ta niso del integracije upravljalca kanalov in integrator nima razloga, da bi se nanje povezal.

Upravljanje računa je prav tako na api.wink.travel, na /mcp/settings. Na gostitelju integracij ni /mcp/settings.

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

---

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 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 povezave v biografiji	/mcp/link-manager + /mcp/social
Rezervirate v imenu potnikov	/mcp/travel-agent
Poravnate denar	/mcp/payment
Gradite rezervacijsko izkušnjo	/mcp/booking-engine + /mcp/reference

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

Še vedno želite vse?

https://api.wink.travel/mcp in https://integrations.wink.travel/mcp ostajata na voljo in strežeta vsa orodja na svojem gostitelju. Koristna sta za raziskovanje, kaj obstaja, vendar ju ne priporočamo za vsakodnevno delo: seznam orodij je dovolj velik, da zasenči vašo nalogo in poslabša izbiro orodij agenta. Raje uporabite zgornje sklope orodij.

---

Kako deluje avtentikacija

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

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š upravljavski subjekt.
6. Žetoni potečejo po 3 urah. Vaš AI odjemalec tiho osveži žeton v ozadju brez ponovnega poziva.

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

Claude Code

1. Prepričajte se, da je Claude Code posodobljen:

   npm install -g @anthropic-ai/claude-code

2. Izberite sklop orodij iz zgornjega direktorija in ga dodajte. Na primer, cene in razpoložljivost:

   claude mcp add wink-rates https://api.wink.travel/mcp/extranet/rates --transport http

3. Claude Code kontaktira strežnik, odkrije avtentikacijski strežnik in odpre vaš privzeti brskalnik.

4. Prijavite se v Wink in odobrite zahtevo za dovoljenja na zaslonu za soglasje.

5. Claude Code potrdi povezavo. Vnesite /mcp za preverjanje, da se strežnik prikaže in so orodja naložena.

Dodajte toliko sklopov orodij, kot 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 http
claude mcp add wink-analytics  https://api.wink.travel/mcp/analytics           --transport http

Prijavite se samo enkrat. Po prvi odobritvi v brskalniku Claude Code ponovno uporabi vašo Wink sejo za dodatne Wink končne točke.

Delite s svojo ekipo

Dodajte --scope project k claude mcp add in Claude Code zapiše URL strežnika v .mcp.json v korenu repozitorija. Potrdite to datoteko — vsak član ekipe dobi iste sklope orodij, vsak pa opravi svojo prijavo v brskalnik ob prvi povezavi.

Claude Desktop

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

2. 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"
       }
     }
   }

3. Popolnoma zaprite in ponovno zaženite Claude Desktop (uporabite Quit iz menijske vrstice — zapiranje okna ni dovolj).

4. Claude Desktop odpre zavihek brskalnika za vsak nov strežnik. Prijavite se v Wink in odobrite dovoljenja.

5. Ikona vtičnice v spodnji orodni vrstici pokaže oba strežnika kot povezana.

OpenAI Codex

1. Prepričajte se, da je Codex CLI nameščen:

   npm install -g @openai/codex

2. Odprite (ali ustvarite) konfiguracijsko datoteko Codex:

   • macOS / Linux: ~/.codex/config.json
   • Windows: %USERPROFILE%\.codex\config.json

3. Dodajte Wink MCP strežnike:

   ~/.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"
       }
     }
   }

4. Zaženite Codex. Ob prvi uporabi Codex odpre zavihek brskalnika na https://iam.wink.travel.

5. Prijavite se v Wink in odobrite zahtevana dovoljenja.

6. Codex potrdi povezavo. Zaženite codex in ga prosite, naj izpiše razpoložljiva orodja, da preverite, ali so Wink strežniki aktivni.

Note

Podpora MCP v Codex CLI zahteva različico 1.0 ali novejšo. Za preverjanje zaženite codex --version in za nadgradnjo npm install -g @openai/codex.

ChatGPT

Podpora MCP strežnikov je na voljo v ChatGPT namizni aplikaciji za naročnike Plus, Pro, Team in Enterprise.

1. Prenesite in namestite ChatGPT namizno aplikacijo, če je še nimate.

2. Odprite aplikacijo in kliknite ikono svojega profila v zgornjem desnem kotu, nato izberite Nastavitve.

3. Pojdite na Povezovalnike (ali MCP strežniki glede na različico aplikacije) in kliknite Dodaj.

4. Vnesite URL sklopa orodij iz zgornjega direktorija, na primer:

   https://api.wink.travel/mcp/extranet/rates

   Nato kliknite Poveži.

5. ChatGPT odpre zavihek brskalnika na https://iam.wink.travel. Prijavite se v Wink in odobrite dovoljenja.

6. Ponovite koraka 4–5 za vsak drug sklop orodij, ki ga vaše delo potrebuje, na primer:

   https://api.wink.travel/mcp/extranet/operations

7. Vsak sklop orodij se prikaže na seznamu Povezovalnikov. Začnite nov pogovor — Wink orodja so samodejno na voljo.

Omejitev spletne aplikacije

MCP strežniki so konfigurabilni samo v namizni aplikaciji. Spletni vmesnik ChatGPT na chatgpt.com ne podpira prilagojenih MCP strežnikov.

Cursor

1. Odprite (ali ustvarite) konfiguracijsko datoteko Cursor MCP:

   • macOS / Linux: ~/.cursor/mcp.json
   • Windows: %USERPROFILE%\.cursor\mcp.json

2. Dodajte Wink MCP strežnike:

   ~/.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"
       }
     }
   }

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

4. Cursor odpre zavihek brskalnika na https://iam.wink.travel. Prijavite se v Wink in odobrite dovoljenja.

5. Odprite klepet (Ctrl+L / Cmd+L) in prosite Cursor, naj izpiše razpoložljiva Wink orodja, da potrdite povezavo.

Konfiguracija z obsegom projekta

Lahko tudi postavite datoteko mcp.json v koren vašega projekta namesto v ~/.cursor/. Konfiguracija na ravni projekta ima prednost in omogoča strežnike vsem članom ekipe, ki odprejo projekt v Cursor.

Windsurf

1. Odprite (ali ustvarite) konfiguracijsko datoteko Windsurf MCP:

   • macOS / Linux: ~/.codeium/windsurf/mcp_config.json
   • Windows: %USERPROFILE%\.codeium\windsurf\mcp_config.json

2. Dodajte Wink MCP strežnike:

   ~/.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"
       }
     }
   }

3. Popolnoma znova zaženite Windsurf (Datoteka → Izhod, nato ponovno odprite).

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

5. Prijavite se v Wink in odobrite dovoljenja. Strežniki postanejo zeleni v nastavitvenem panelu, ko so avtenticirani.

Note

Podpora MCP v Windsurf zahteva različico 1.4 ali novejšo. Preverite prek Pomoč → O Windsurf in po potrebi posodobite s spletne strani Windsurf.

Cline (VS Code)

Cline je razširitev za VS Code z vgrajenim upravljalcem MCP strežnikov. Ročno urejanje JSON ni potrebno.

1. Namestite Cline iz tržnice VS Code:

   • Odprite VS Code in pritisnite Ctrl+Shift+X / Cmd+Shift+X
   • Poiščite Cline in kliknite Namesti

2. Kliknite ikono Cline v vrstici aktivnosti (levi stranski meni), da odprete panel Cline.

3. Kliknite ikono MCP strežnikov (ikona vtičnice) v orodni vrstici Cline, nato izberite Uredi nastavitve MCP.

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

5. Shrani datoteko. Cline se samodejno ponovno naloži in odpre zavihek brskalnika na https://iam.wink.travel.

6. Prijavite se v Wink in odobrite dovoljenja. Oba strežnika se prikažeta kot aktivna v panelu MCP strežnikov.

Alternativa: dodaj prek URL

V panelu MCP strežnikov kliknite Dodaj strežnik in prilepite URL sklopa orodij, na primer https://api.wink.travel/mcp/extranet/rates neposredno. Cline samodejno izpolni konfiguracijo in upravlja avtentikacijo brez ročnega urejanja JSON.

---

Obsegi

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

Dve stvari sta specifični za MCP:

• Obsegi mcp.read, mcp.write, mcp.remove so dodatno zahtevani za odprtje MCP transporta. Odjemalec z obsegom mcp.* ima dostop do katere koli Wink MCP končne točke, 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. Na zaslonu za soglasje lahko zavrnete posamezna dovoljenja — orodja, ki zahtevajo zavrnjeni obseg, bodo ob klicu vrnila napako.

Sklopi 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, povezava na /mcp/reference pa ne prepreči orodju, da uveljavlja svoj obseg. Avtorizacija se odloča pri vsakem klicu orodja, na podlagi vašega žetona in pravic vašega računa.

---

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 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 znova prikazal 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 orodij 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 orodij, ki jo pokriva — povezave so neodvisne, zato dodajanje enega ne spremeni drugih. Če niste prepričani, kateri ga ima, se začasno 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 orodij 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 upravljavskega subjekta. 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 prikaže “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 posodobitev. Po posodobitvi znova naložite VS Code (Ctrl+Shift+P → “Developer: Reload Window”).

---

Odpri Wink Portal Wink na GitHubu