MCP serveri

Wink izlaže dva autentifikovana MCP servera. Oba koriste interaktivno OAuth2 prijavljivanje (PKCE authorization code flow) — vaš AI agent otvara tab u pregledaču gde se prijavljujete sa svojim Wink nalogom. Nema potrebe za upravljanjem klijentskim tajnama.

Server	URL	Šta radi
Inventory API	https://api.wink.travel/mcp	Inventar, rezervacije, cene, prodajni kanali, analitika i sve operacije platforme
Integrations	https://integrations.wink.travel/mcp	Integracije sa channel managerima — sinhronizacija objekata, cena i dostupnosti sa OTA platformama

---

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 authorization server iz MCP endpoint-ovog /.well-known/oauth-protected-resource metapodatka.
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 svojim 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 uz svaki MCP zahtev. Svi rezultati alata automatski su ograničeni na vašu upravljačku entitet.
6. Tokeni ističu nakon 3 sata. Vaš AI klijent osvežava token 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 li je Claude Code ažuriran:

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

2. Dodajte Wink Inventory MCP server:

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

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

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

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

Da dodate i Integrations server:

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

Delite sa timom

Dodajte --scope project uz claude mcp add i Claude Code će upisati URL servera u .mcp.json u korenu repozitorijuma. Komitujte taj fajl — svaki član tima će prvi put kada se poveže završiti svoju prijavu u pregledaču.

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-inventory": {
         "type": "http",
         "url": "https://api.wink.travel/mcp"
       },
       "wink-integrations": {
         "type": "http",
         "url": "https://integrations.wink.travel/mcp"
       }
     }
   }

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 na Wink i odobrite dozvole.

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

OpenAI Codex

1. Proverite da li 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 unose Wink MCP servera:

   ~/.codex/config.json

   {
     "mcpServers": {
       "wink-inventory": {
         "type": "http",
         "url": "https://api.wink.travel/mcp"
       },
       "wink-integrations": {
         "type": "http",
         "url": "https://integrations.wink.travel/mcp"
       }
     }
   }

4. Pokrenite Codex. Prvi put Codex otvara tab u pregledaču na https://iam.wink.travel.

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

6. Codex potvrđuje vezu. Pokrenite codex i zatražite listu dostupnih alata da proverite da li 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 Wink Inventory servera:

   https://api.wink.travel/mcp

   Zatim kliknite Connect.

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

6. Ponovite korake 4–5 za Integrations server:

   https://integrations.wink.travel/mcp

7. Oba servera se pojavljuju u vašoj listi Connectors. Pokrenite 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 unose Wink MCP servera:

   ~/.cursor/mcp.json

   {
     "mcpServers": {
       "wink-inventory": {
         "type": "http",
         "url": "https://api.wink.travel/mcp"
       },
       "wink-integrations": {
         "type": "http",
         "url": "https://integrations.wink.travel/mcp"
       }
     }
   }

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 na 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 vezu.

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 omogućava pristup serverima 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 unose Wink MCP servera:

   ~/.codeium/windsurf/mcp_config.json

   {
     "mcpServers": {
       "wink-inventory": {
         "type": "http",
         "url": "https://api.wink.travel/mcp"
       },
       "wink-integrations": {
         "type": "http",
         "url": "https://integrations.wink.travel/mcp"
       }
     }
   }

3. Potpuno restartujte Windsurf (File → Quit, zatim ponovo otvorite).

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

5. Prijavite se na 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 server menadžerom. 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-inventory": {
         "type": "http",
         "url": "https://api.wink.travel/mcp"
       },
       "wink-integrations": {
         "type": "http",
         "url": "https://integrations.wink.travel/mcp"
       }
     }
   }

5. Sačuvajte fajl. Cline se automatski učitava i otvara tab u pregledaču na https://iam.wink.travel.

6. Prijavite se na 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 https://api.wink.travel/mcp direktno. Cline automatski popunjava konfiguraciju i upravlja autentifikacijom bez potrebe za ručnim uređivanjem JSON-a.

---

Scope-ovi

Kada odobrite ekran za saglasnost, videćete detaljan pregled zahteva agenta. MCP klijenti koriste isti vokabular dozvola kao i ostatak platforme — pogledajte kompletnu referencu scope-ova na stranici za autentifikaciju.

Dve stvari su specifične za MCP:

• Scope-ovi mcp.read, mcp.write i mcp.remove su dodatno potrebni za otvaranje MCP transporta. Klijent koji poseduje mcp.* scope ima pristup /mcp, ali svaki alat koji pozove i dalje primenjuje scope sekcije endpoint-a koji obuhvata (npr. booking.read).
• AI klijent traži samo scope-ove koji su mu potrebni. Možete odbiti pojedinačne dozvole na ekranu za saglasnost — alati koji zahtevaju odbijeni scope vratiće grešku prilikom poziva.

---

Rešavanje problema

Tab u pregledaču se ne otvara

Vaš AI klijent možda još ne podržava interaktivni PKCE tok. Proverite da li 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 istekao. Uklonite i ponovo dodajte server da biste pokrenuli novu prijavu:

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

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

403 Forbidden prilikom poziva određenog alata

Alat zahteva scope koji niste odobrili na ekranu za saglasnost. Ponovo povežite server — ekran za saglasnost će se ponovo pojaviti i moći ćete da odobrite nedostajuću dozvolu.

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

Prijavljeni ste na Wink nalog koji nema upravljački entitet. Posetite Wink Portal i proverite da li je vaš nalog pravilno 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 u pozadini bez prekida sesije. Ako dobijete 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 li je vaš ~/.codex/config.json validan JSON (bez zareza na kraju) i da je "type": "http" podešen. Codex zahteva HTTP transport za udaljene servere; stdio transport je samo za lokalne binarne fajlove.

Meni “Connectors” u ChatGPT 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 svoj plan u Settings → Account.

Cursor server prikazuje crveno / “Failed to connect”

Proverite da li je vaš ~/.cursor/mcp.json validan JSON i 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 primaju uvek bez restarta.

Windsurf MCP serveri se ne pojavljuju u podešavanjima

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

Opcija “Add Server” u Cline nije vidljiva

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

---

Otvori Wink Portal Wink na GitHub-u