MCP serveri

Wink-ovi MCP alati objavljeni su kao skupovi alata — fokusirane krajnje tačke, od kojih svaka pokriva jedan posao. Povezujete vaš AI klijent sa jednom ili dve koje odgovaraju vašem poslu, a ne sa svim.

Svaka krajnja tačka koristi interaktivno OAuth2 prijavljivanje (PKCE autorizacioni kodni tok): vaš AI agent otvara tab u pregledaču, prijavljujete se sa vašim Wink nalogom i to je to. Nema potrebe za upravljanjem klijentskim tajnama.

Integrator channel manager-a se povezuje na jednu krajnju tačku

claude mcp add wink-channel-manager https://integrations.wink.travel/mcp/channel-manager --transport http

Hotelijer koji upravlja sopstvenim cenama se povezuje na drugu

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

---

Zašto su alati podeljeni na krajnje tačke

Wink izlaže oko 500 alata. Davanje svih njih agentu odjednom je tehnički moguće — ali loša ideja.

Definicije alata troše kontekst. Svaki alat koji MCP server oglašava učitava se u kontekstni prozor modela pre nego što obavi bilo kakav posao, zajedno sa njegovim opisom i kompletnom šemom parametara. Petsto takvih alata troši veliki deo budžeta koji vaš stvarni zadatak zahteva, pri svakom zahtevu.

Kvalitet izbora opada kako lista raste. Agent koji bira između 500 alata sa sličnim imenima donosi lošije odluke nego onaj koji bira između 40. Ako integrišete channel manager, otprilike dvadeset alata je relevantno za vas; ostalih 480 je buka koja otežava pronalaženje pravog alata.

Posao je zaista odvojiv. Neko ko sinhronizuje dostupnost iz PMS-a i neko ko uređuje affiliate landing stranice skoro da ne dele alate. Podela po poslu znači da svaka konekcija nosi vokabular jednog posla.

Skupovi alata nisu dozvole

Izbor uskog skupa alata ne ograničava šta vaš nalog može da radi, a izbor širokog ne daje ništa dodatno. Svaki alat primenjuje iste dozvole naloga kao i web portal, pod vašim prijavljenim identitetom. Ako vaš nalog ne može da otkaže rezervaciju u Wink Portalu, agent takođe ne može — bez obzira na to na koju je krajnju tačku povezan.

Birajte skupove alata za fokus, a ne za bezbednost.

---

Direktorijum krajnjih tačaka

Dva hosta služe skupove alata. Broj alata je približan i raste tokom vremena.

https://api.wink.travel — platforma

Krajnja tačka	Alati	Šta pokriva
/mcp/extranet/facilities	~64	Rezervabilni i lokalni inventar: sobe i tipovi soba, spa centri, restorani, sale za sastanke, aktivnosti, atrakcije, mesta, drugi prodajni artikli
/mcp/extranet/property	~62	Evidencija objekta i njegovi komercijalni uslovi: profil i sadržaj, dodaci, politike otkazivanja, beneficije, obaveštenja
/mcp/settings	~60	Administracija naloga: profil i brendiranje upravljačkog entiteta, menadžeri i njihova ovlašćenja, prilagođavanja, webhooks, podešavanja notifikacija
/mcp/studio/embeds	~48	Objavljivanje kuriranog inventara: vidžeti, mreže i rangirane mreže, kartice, mape, duboke veze ka inventaru i stranicama dobavljača
/mcp/extranet/rates	~44	Cene i dostupnost: periodi i kvote cena inventara, planovi cena, glavne cene, specijalne i promotivne cene
/mcp/extranet/operations	~39	Upravljanje aktivnim objektom: rezervacije i njihov životni ciklus, recenzije gostiju i odgovori, kalendarski feedovi, zakazani zadaci
/mcp/extranet/distribution	~37	Gde se inventar prodaje: prodajni kanali i modifikatori cena, zahtevi za affiliate i dobavljačke odnose, registracija, prikupljanje leadova
/mcp/studio/curation	~35	Izgradnja kolekcija za prodaju: statične i dinamičke liste, rangirane liste, sačuvane pretrage, agregati objekata
/mcp/link-manager	~28	Sindikovani skupovi linkova, njihov dizajn, kategorije i tagovi, plus skraćeni URL-ovi
/mcp/reference	~24	Podaci samo za čitanje: zemlje, valute i kursevi, jezici, vremenske zone, geo pretrage, IP geolokacija
/mcp/analytics	~18	Analitika rezervacija i prihoda: pregledi, linijski grafikoni, rang liste, performanse affiliate-a, metričke deljenja
/mcp/payment	~18	Finansijske operacije: knjiga računa, isplate i procene naknada, agregati sredstava za rezervacije
/mcp/booking-engine	~17	Putanja kupovine za putnike: pretraga i pronalaženje, korpa i naplata, liste želja, prilagođavanje kampanja
/mcp/social	~17	Povezani društveni nalozi, objavljivanje i zakazivanje postova, čitanje uvida u postove
/mcp/travel-agent	~8	Rezervacije koje agent obavlja u ime putnika i izveštaji agenata

https://integrations.wink.travel — integracije channel manager-a

Jedna krajnja tačka, jer ovaj host postoji za jedan posao.

Krajnja tačka	Alati	Šta pokriva
/mcp/channel-manager	~9	Povezivanje i verifikacija integracije channel manager-a, PMS-a ili CRS-a

Integracija channel manager-a vs. upravljanje sopstvenim cenama

Ovo su različiti poslovi za različite ljude i ne dele istu krajnju tačku.

Prodavac channel manager-a, PMS-a ili CRS-a integriše se jednom preko integrations.wink.travel/mcp/channel-manager, i od tada razmenjuje podatke o objektima, cenama, dostupnosti i rezervacijama preko te integracije. Ta jedna krajnja tačka je cela površina.

Hotelijer koji menja sopstvene cene ručno koristi ekstranet skupove alata na api.wink.travel — /mcp/extranet/rates i slične. Oni nisu deo integracije channel manager-a i integrator nema razloga da se povezuje na njih.

Administracija naloga je takođe na api.wink.travel, na /mcp/settings. Ne postoji /mcp/settings na hostu za integracije.

Svaka krajnja tačka takođe nosi ping alat, tako da možete potvrditi da je konekcija aktivna pre nego što tražite stvarni posao.

---

Koje skupove alata mi treba?

Ako ste…	Povežite se sa
Integracija channel manager-a, PMS-a ili CRS-a	integrations.wink.travel/mcp/channel-manager — samo ova
Upravljanje sadržajem objekta	/mcp/extranet/property + /mcp/extranet/facilities
Upravljanje sobama i tipovima soba	/mcp/extranet/facilities
Upravljanje cenama i dostupnošću	/mcp/extranet/rates
Vođenje dnevnih rezervacija	/mcp/extranet/operations
Razvijanje distribucije	/mcp/extranet/distribution + /mcp/analytics
Izgradnja affiliate stranica	/mcp/studio/curation + /mcp/studio/embeds
Vođenje link-in-bio stranica	/mcp/link-manager + /mcp/social
Rezervacije u ime putnika	/mcp/travel-agent
Usaglašavanje novca	/mcp/payment
Izgradnja iskustva rezervacije	/mcp/booking-engine + /mcp/reference

Počnite sa jednim. Dodajte drugi kada vam zatreba nešto što prvi ne može — svaka konekcija je nezavisna i dodavanje jednog ne utiče na ostale.

I dalje želite sve?

https://api.wink.travel/mcp i https://integrations.wink.travel/mcp ostaju dostupni i služe sve alate na svom hostu. Korisni su za istraživanje šta postoji, ali ih ne preporučujemo za svakodnevni rad: lista alata je dovoljno velika da zaseni vaš zadatak i pogorša izbor alata agenta. Preporučujemo gore navedene skupove alata.

---

Kako funkcioniše autentifikacija

Wink MCP serveri koriste OAuth2 Authorization Code + PKCE tok i podržavaju Dynamic Client Registration (RFC 7591). Evo šta se dešava kada se povežete prvi put:

1. Vaš AI klijent otkriva autorizacioni server iz MCP krajnje tačke /.well-known/oauth-protected-resource metapodataka.
2. Klijent se samoregistruje putem Dynamic Client Registration — nije potrebna ručna konfiguracija aplikacije.
3. Klijent otvara tab u pregledaču na https://iam.wink.travel. Prijavljujete se sa vašim Wink nalogom i odobravate tražene dozvole na ekranu za saglasnost.
4. Wink izdaje access token vezan za vaš nalog i identitet.
5. AI klijent prilaže token svakom MCP zahtevu. Svi rezultati alata su automatski ograničeni na vaš upravljački entitet.
6. Tokeni ističu nakon 3 sata. Vaš AI klijent osvežava ih tiho u pozadini bez ponovnog zahteva za prijavu.

Svaki poziv alata se izvršava pod vašim identitetom — ista ACL pravila koja štite web portal važe i za AI agenta.

---

Povežite vaš AI klijent

Claude Code

1. Proverite da je Claude Code ažuriran:

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

2. Izaberite skup alata iz direktorijuma iznad i dodajte ga. Na primer, cene i dostupnost:

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

3. Claude Code kontaktira server, otkriva autorizacioni server i otvara vaš podrazumevani pregledač.

4. Prijavite se u Wink i odobrite zahtev za dozvolu na ekranu za saglasnost.

5. Claude Code potvrđuje konekciju. Ukucajte /mcp da proverite da li se server pojavljuje i da su njegovi alati učitani.

Dodajte onoliko skupova alata koliko vaš posao zahteva — svaki je poseban unos servera sa sopstvenim 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

Prijavljujete se samo jednom. Nakon prve odobrene sesije u pregledaču, Claude Code koristi vašu Wink sesiju za dodatne Wink krajnje tačke.

Delite sa timom

Dodajte --scope project uz claude mcp add i Claude Code upisuje URL servera u .mcp.json u korenu repozitorijuma. Komitujte taj fajl — svaki član tima dobija iste skupove alata, a svaki završava sopstvenu prijavu u pregledaču prvi put kada se poveže.

Claude Desktop

1. Izmenite konfiguracioni fajl Claude Desktop-a:

   • 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 unose MCP servera:

   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. Potpuno zatvorite i ponovo pokrenite Claude Desktop (koristite Quit iz menija — samo zatvaranje prozora nije dovoljno).

4. Claude Desktop otvara tab u pregledaču za svaki novi server. Prijavite se u Wink i odobrite dozvole.

5. Ikona utikača u donjoj alatnoj traci pokazuje oba servera kao povezana.

OpenAI Codex

1. Proverite da je Codex CLI instaliran:

   npm install -g @openai/codex

2. Otvorite (ili kreirajte) Codex konfiguracioni fajl:

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

3. Dodajte Wink MCP server unose:

   ~/.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. Pokrenite Codex. Prvi put Codex otvara tab u pregledaču na https://iam.wink.travel.

5. Prijavite se u Wink i odobrite tražene dozvole.

6. Codex potvrđuje konekciju. Pokrenite codex i zatražite listu dostupnih alata da proverite da su Wink serveri aktivni.

Note

Podrška za MCP u Codex CLI zahteva verziju 1.0 ili noviju. Pokrenite codex --version da proverite, i npm install -g @openai/codex za nadogradnju.

ChatGPT

Podrška za MCP servere dostupna je u ChatGPT desktop aplikaciji za Plus, Pro, Team i Enterprise pretplatnike.

1. Preuzmite i instalirajte ChatGPT desktop aplikaciju ako već niste.

2. Otvorite aplikaciju i kliknite na vašu profilnu ikonu u gornjem desnom uglu, zatim izaberite Settings.

3. Idite na Connectors (ili MCP Servers u zavisnosti od verzije aplikacije) i kliknite Add.

4. Unesite URL skupa alata iz direktorijuma iznad, na primer:

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

   Zatim kliknite Connect.

5. ChatGPT otvara tab u pregledaču na https://iam.wink.travel. Prijavite se u Wink i odobrite dozvole.

6. Ponovite korake 4–5 za bilo koji drugi skup alata koji vam treba, na primer:

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

7. Svaki skup alata se pojavljuje u vašoj listi Connectors. Počnite novi chat — Wink alati su automatski dostupni.

Ograničenje web aplikacije

MCP serveri se mogu konfigurisati samo u desktop aplikaciji. Web interfejs ChatGPT na chatgpt.com ne podržava prilagođene MCP servere.

Cursor

1. Otvorite (ili kreirajte) Cursor MCP konfiguracioni fajl:

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

2. Dodajte Wink MCP server unose:

   ~/.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. Otvorite Cursor. Idite na Settings → Cursor Settings → MCP i potvrdite da se oba servera pojavljuju sa zelenim indikatorom statusa. Ako su crveni, kliknite Refresh.

4. Cursor otvara tab u pregledaču na https://iam.wink.travel. Prijavite se u Wink i odobrite dozvole.

5. Otvorite chat (Ctrl+L / Cmd+L) i zatražite od Cursor-a da prikaže dostupne Wink alate da potvrdite konekciju.

Konfiguracija ograničena na projekat

Takođe možete postaviti mcp.json fajl u koren vašeg projekta umesto u ~/.cursor/. Konfiguracija na nivou projekta ima prioritet i čini servere dostupnim svakom članu tima koji otvori projekat u Cursor-u.

Windsurf

1. Otvorite (ili kreirajte) Windsurf MCP konfiguracioni fajl:

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

2. Dodajte Wink MCP server unose:

   ~/.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. Potpuno restartujte Windsurf (File → Quit, zatim ponovo pokrenite).

4. Idite na Settings → MCP Servers i proverite da oba servera pokazuju status povezanosti. Windsurf otvara tab u pregledaču na https://iam.wink.travel pri prvom korišćenju.

5. Prijavite se u Wink i odobrite dozvole. Serveri postaju zeleni u panelu podešavanja nakon autentifikacije.

Note

Podrška za Windsurf MCP zahteva verziju 1.4 ili noviju. Proverite preko Help → About Windsurf i ažurirajte sa Windsurf sajta ako je potrebno.

Cline (VS Code)

Cline je VS Code ekstenzija sa ugrađenim MCP menadžerom servera. Nije potrebna ručna izmena JSON fajlova.

1. Instalirajte Cline iz VS Code Marketplace:

   • Otvorite VS Code i pritisnite Ctrl+Shift+X / Cmd+Shift+X
   • Potražite Cline i kliknite Install

2. Kliknite na Cline ikonu u Activity Baru (levi sidebar) da otvorite Cline panel.

3. Kliknite na ikonu MCP Servers (ikona utikača) u Cline alatnoj traci, zatim izaberite Edit MCP Settings.

4. VS Code otvara cline_mcp_settings.json. Dodajte Wink unose:

   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. Sačuvajte fajl. Cline se automatski učitava i otvara tab u pregledaču na https://iam.wink.travel.

6. Prijavite se u Wink i odobrite dozvole. Oba servera se pojavljuju kao aktivna u MCP Servers panelu.

Alternativa: dodajte putem URL-a

U MCP Servers panelu kliknite Add Server i nalepite URL skupa alata kao što je https://api.wink.travel/mcp/extranet/rates direktno. Cline automatski popunjava konfiguraciju i upravlja autentifikacijom bez ručne izmene JSON-a.

---

Opsezi (Scopes)

Kada odobrite ekran za saglasnost, videćete razlaganje zahteva agenta. MCP klijenti koriste isti vokabular dozvola kao i ostatak platforme — pogledajte kompletnu referencu opsega na stranici Autentifikacije.

Dve stvari su specifične za MCP:

• Opsezi mcp.read, mcp.write, mcp.remove su dodatno potrebni za otvaranje MCP transporta. Klijent koji poseduje mcp.* opseg ima pristup bilo kojoj Wink MCP krajnjoj tački, ali svaki alat koji pozove i dalje primenjuje opseg sekcije krajnje tačke koju obuhvata (npr. booking.read).
• AI klijent traži samo opsege koje mu trebaju. Možete odbiti pojedinačne dozvole na ekranu za saglasnost — alati koji zahtevaju odbijeni opseg vratiće grešku pri pozivu.

Skupovi alata ne menjaju ništa od ovoga. Krajnja tačka na koju se povežete odlučuje koji su alati izlistani, a ne šta im je dozvoljeno da rade. Povezivanje na /mcp/payment ne daje finansijske dozvole koje već nemate, a povezivanje na /mcp/reference ne sprečava alat da primeni svoj opseg. Autorizacija se odlučuje po pozivu alata, na osnovu vašeg tokena i dozvola naloga.

---

Rešavanje problema

Tab u pregledaču se ne otvara

Vaš AI klijent možda još ne podržava interaktivni PKCE tok. Proverite da koristite najnoviju verziju:

• Claude Code: npm install -g @anthropic-ai/claude-code
• Codex CLI: npm install -g @openai/codex
• Claude Desktop / ChatGPT desktop: ažurirajte preko ugrađenog update-a aplikacije

401 Unauthorized nakon prijave

Vaš keširani token može biti zastareo. Uklonite i ponovo dodajte server da pokrenete novu prijavu:

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

Za Claude Desktop i ChatGPT, uklonite unos servera iz podešavanja, restartujte aplikaciju i dodajte ga ponovo.

403 Forbidden pri pozivu određenog alata

Alat zahteva opseg koji niste odobrili na ekranu za saglasnost, ili dozvolu koju vaš nalog nema. Ponovo povežite server — ekran za saglasnost će se ponovo pojaviti i možete odobriti nedostajuću dozvolu. Ako i dalje ne uspeva, alat zahteva dozvolu naloga koju nemate; povezivanje na drugi skup alata neće pomoći, jer skupovi alata ne dodeljuju dozvole.

Alat koji mi treba nije na listi

Verovatno ste povezani na skup alata koji ne pokriva taj posao. Proverite direktorijum krajnjih tačaka i dodajte odgovarajući skup — konekcije su nezavisne, pa dodavanje jednog ne menja ostale. Ako niste sigurni koji ga ima, privremeno se povežite na https://api.wink.travel/mcp, pronađite alat, pa pogledajte koji skup ga izlistava.

404 Not Found na krajnjoj tački skupa alata

Pažljivo proverite putanju — ugnježdeni skupovi alata imaju dva segmenta (/mcp/extranet/rates, ne /mcp/extranet-rates), a ravni jedan (/mcp/link-manager). Napomena: neautentifikovani zahtev na bilo koji put ispod /mcp vraća 401, ne 404, tako da sam 401 ne govori da li krajnja tačka postoji.

Povezao sam se na api.wink.travel/mcp/channel-manager i ništa nisam dobio

Ta krajnja tačka ne postoji. Integracija channel manager-a se služi samo sa https://integrations.wink.travel/mcp/channel-manager. Ako vam treba i ručno čitanje ili pisanje sopstvenih cena objekta, to je poseban posao na posebnoj krajnjoj tački — vidi /mcp/extranet/rates.

Server se pojavljuje, ali pozivi alata vraćaju “account not found”

Prijavljeni ste na Wink nalog koji nema upravljački entitet. Idite na Wink Portal i proverite da li je vaš nalog podešen pre korišćenja MCP servera.

Token ističe tokom sesije

Tokeni važe 3 sata. Claude Code i Claude Desktop osvežavaju tokene tiho bez prekida sesije. Ako vidite greške u autentifikaciji nakon dužeg perioda neaktivnosti, pošaljite novu poruku — klijent će se automatski ponovo autentifikovati.

Codex CLI prikazuje “MCP server unreachable”

Proverite da je vaš ~/.codex/config.json validan JSON (bez zareza na kraju) i da je "type": "http" podešeno. Codex zahteva HTTP transport za udaljene servere; stdio transport je samo za lokalne binarne fajlove.

ChatGPT meni “Connectors” nedostaje

Podrška za MCP zahteva verziju ChatGPT desktop aplikacije 1.2024.352 ili noviju i aktivnu Plus, Pro, Team ili Enterprise pretplatu. Ažurirajte aplikaciju i proverite plan u Settings → Account.

Cursor server pokazuje crveno / “Failed to connect”

Proverite da je vaš ~/.cursor/mcp.json validan JSON i da sadrži "type": "http". Zatim idite na Settings → Cursor Settings → MCP i kliknite Refresh. Ako greška ostane, potpuno restartujte Cursor — promene konfiguracije se ne prepoznaju uvek bez restarta.

Windsurf MCP serveri nisu prikazani u podešavanjima

Windsurf zahteva potpuni restart (ne samo reload prozora) da prepozna promene u mcp_config.json. Koristite File → Quit i ponovo pokrenite. Ako serveri i dalje nisu vidljivi, proverite da li koristite Windsurf 1.4+ preko Help → About Windsurf.

Opcija “Add Server” u Cline nije vidljiva

MCP menadžer servera zahteva Cline 2.0 ili noviji. Otvorite VS Code Extensions panel, pronađite Cline i kliknite Update ako je dostupno. Nakon ažuriranja, reload-ujte VS Code (Ctrl+Shift+P → “Developer: Reload Window”).

---

Otvori Wink Portal Wink na GitHub-u