Skip to content

MCP poslužitelji

Winkovi MCP alati objavljeni su kao skupovi alata — fokusirane krajnje točke, svaka pokriva jedan zadatak. Povezujete svoj AI klijent s jednom ili dvije koje odgovaraju vašem poslu, a ne sa svim.

Svaka krajnja točka koristi interaktivnu OAuth2 prijavu (PKCE autorizacijski kodni tok): vaš AI agent otvara karticu preglednika, prijavljujete se sa svojim Wink računom i to je to. Nema potrebe za upravljanjem klijentskim tajnama.

Integrator channel managera povezuje se na jednu krajnju točku
claude mcp add wink-channel-manager https://integrations.wink.travel/mcp/channel-manager --transport http
Hotelijer koji upravlja vlastitim cijenama povezuje se na drugu
claude mcp add wink-rates https://api.wink.travel/mcp/extranet/rates --transport http

Zašto su alati podijeljeni po krajnjim točkama

Section titled “Zašto su alati podijeljeni po krajnjim točkama”

Wink izlaže oko 500 alata. Predati ih sve agentu odjednom tehnički je moguće — ali loša ideja.

Definicije alata troše kontekst. Svaki alat koji MCP poslužitelj oglašava učitava se u kontekstni prozor modela prije nego što obavi bilo kakav posao, zajedno s njegovim opisom i potpunom shemom parametara. Petsto takvih alata troši velik dio budžeta koji vaš stvarni zadatak treba, pri svakom zahtjevu.

Kvaliteta izbora opada kako lista raste. Agent koji bira između 500 sličnih alata donosi lošije odluke nego onaj koji bira između 40. Ako integrirate channel manager, otprilike dvadeset alata je relevantno za vas; ostalih 480 je buka koja otežava pronalazak pravog alata.

Posao je stvarno razdvojiv. Netko tko sinkronizira dostupnost iz PMS-a i netko tko uređuje affiliate landing stranice gotovo da ne dijele alate. Podjela po zadatku znači da svaka veza nosi vokabular jednog zadatka.


Dva domaćina služe skupove alata. Broj alata je približan i raste s vremenom.

Krajnja točkaAlatiŠto pokriva
/mcp/extranet/facilities~64Rezervabilni i na licu mjesta inventar: sobe za goste i tipovi soba, spa centri, restorani, sobe za sastanke, aktivnosti, atrakcije, mjesta, ostale prodajne stavke
/mcp/extranet/property~62Zapis o objektu i njegovi komercijalni uvjeti: profil i sadržaj, dodaci, politike otkazivanja, pogodnosti, obavijesti
/mcp/settings~60Administracija računa: profil upravljačkog subjekta i brendiranje, upravitelji i njihova ovlaštenja, prilagodbe, webhooks, postavke obavijesti
/mcp/studio/embeds~48Objavljivanje kuriranog inventara: widgeti, mreže i rangirane mreže, kartice, karte, duboke poveznice na inventar i stranice dobavljača
/mcp/extranet/rates~44Cijene i dostupnost: razdoblja i kvote inventara, planovi cijena, glavne cijene, posebne i promotivne cijene
/mcp/extranet/operations~39Upravljanje aktivnim objektom: rezervacije i njihov životni ciklus, recenzije gostiju i odgovori, kalendarski feedovi, zakazani zadaci
/mcp/extranet/distribution~37Gdje se inventar prodaje: prodajni kanali i modifikatori cijena, zahtjevi za affiliate i dobavljačke odnose, registracija, prikupljanje leadova
/mcp/studio/curation~35Izgradnja kolekcija za prodaju: statične i dinamičke liste, rangirane liste, spremljene pretrage, agregati objekata
/mcp/link-manager~28Kolekcije sindikiranih poveznica, njihov dizajn, kategorije i oznake, plus skraćene URL-ove
/mcp/reference~24Podaci samo za čitanje: zemlje, valute i tečajevi, jezici, vremenske zone, geografske pretrage, IP geolokacija
/mcp/analytics~18Analitika rezervacija i prihoda: pregledi, linijski grafikoni, ljestvice, performanse affiliatea, metričke dijeljenja
/mcp/payment~18Financijske operacije: knjiga, isplate i procjene naknada, agregati sredstava za rezervacije
/mcp/booking-engine~17Put kupovine za putnike: pretraživanje i pronalaženje, košarica i naplata, liste želja, prilagodba kampanja
/mcp/social~17Povezani društveni računi, objavljivanje i zakazivanje postova, čitanje uvida u postove
/mcp/travel-agent~8Rezervacije koje agenti obavljaju u ime putnika i izvještaji agenata

https://integrations.wink.travel — integracije channel managera

Section titled “https://integrations.wink.travel — integracije channel managera”

Jedna krajnja točka, jer ovaj domaćin postoji za jedan zadatak.

Krajnja točkaAlatiŠto pokriva
/mcp/channel-manager~9Povezivanje i verifikacija integracije channel managera, PMS-a ili CRS-a

Svaka krajnja točka također nosi alat ping, tako da možete potvrditi da je veza aktivna prije nego što zatražite stvarni posao.

Za kompletan tijek rezervacije putnika, povežite Wink Booking Engine na https://api.wink.travel/mcp/booking-engine i kompatibilni novčanik za plaćanje. Dodavanje Wink MCP otvara prijavu u pregledniku i odabir dozvola; vaš klijent zatim upravlja autentifikacijom.

Booking Engine uključuje pronalaženje destinacije, pretraživanje hotela i soba, agentic_booking_quote, agentic_booking_pay, agentic_booking_book, dohvat rezervacija i račune, kada su agentne rezervacije i plaćanja omogućene za to okruženje. Pogledajte Agentic Payments za postavljanje veze, dozvole koje treba odabrati i korake od pretraživanja do potvrde.


Ako ste…Povežite se na
Integrirate channel manager, PMS ili CRSintegrations.wink.travel/mcp/channel-manager — samo ovu
Upravljate sadržajem objekta/mcp/extranet/property + /mcp/extranet/facilities
Upravljate sobama i tipovima soba/mcp/extranet/facilities
Upravljate cijenama i dostupnošću/mcp/extranet/rates
Vodite dnevne rezervacije/mcp/extranet/operations
Razvijate distribuciju/mcp/extranet/distribution + /mcp/analytics
Gradite affiliate stranice/mcp/studio/curation + /mcp/studio/embeds
Vodite link-in-bio stranice/mcp/link-manager + /mcp/social
Rezervirate u ime putnika/mcp/travel-agent
Usuglašavate novac/mcp/payment
Rezervirate sobu s AI agentom/mcp/booking-engine + kompatibilni novčanik za plaćanje — pogledajte Agentic Payments
Gradite iskustvo rezervacije/mcp/booking-engine; opcionalno /mcp/reference za dodatne pretrage

Booking Engine uključuje osnovni tijek rezervacije. Omogućuje otkrivanje računa i prilagodbi, pronalaženje destinacije, dostupnost hotela i detalje o cijenama soba, košarice, naplatu i upravljanje rezervacijama putnika. Agentni alati za rezervaciju i plaćanje također su uključeni kad su omogućeni za to okruženje.

Za pretraživanje hotela u gradu, koristite destination_lookup_search_suggestions za određivanje destinacije, zatim inventory_search_city za pronalazak dostupnih hotela i cijena. Oba alata su u /mcp/booking-engine, pa ovaj tijek ne zahtijeva vezu s Reference.

Dodajte /mcp/reference kad trebate pomoćne pretrage poput zemalja, valuta i tečajeva, podržanih jezika, vremenskih zona, šireg geografskog pretraživanja, OTA klasifikacija ili javnog znanja o objektima. To su opcionalni dodaci tijeku rezervacije.

Počnite s jednim. Dodajte drugi kad vam zatreba nešto što prvi ne može — svaka veza je neovisna i dodavanje jedne ne utječe na druge.


Wink MCP poslužitelji koriste OAuth2 Authorization Code + PKCE tok i podržavaju Dynamic Client Registration (RFC 7591). Evo što se događa kad se prvi put povežete:

  1. Vaš AI klijent otkriva autorizacijski poslužitelj iz MCP krajnje točke /.well-known/oauth-protected-resource metapodataka.
  2. Klijent se samoregistrira putem Dynamic Client Registration — nije potrebna ručna konfiguracija aplikacije.
  3. Klijent otvara karticu preglednika na https://iam.wink.travel. Prijavljujete se sa svojim Wink računom i odobravate tražene dozvole na zaslonu za suglasnost.
  4. Wink izdaje access token ograničen na vaš račun i povezan s vašim identitetom.
  5. AI klijent prilaže token svakom MCP zahtjevu. Svi rezultati alata automatski su ograničeni na vaš upravljački subjekt.
  6. Tokeni istječu nakon 3 sata. Vaš AI klijent tiho osvježava token u pozadini bez ponovnog traženja prijave.

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


Dodajte svaki skup alata u Claude kao prilagođeni konektor. Nema konfiguracijske datoteke za uređivanje i nema potrebe za stvaranjem aplikacije ili tajne.

  1. U Claudeu otvorite Customize › Connectors, kliknite Add, zatim Add custom connector.

  2. Unesite Name (na primjer Wink Link manager) i kao MCP server URL odaberite skup alata iz direktorija gore, na primjer:

    https://api.wink.travel/mcp/link-manager

    Kliknite Continue.

  3. Claude detektira Winkovu prijavu. Ostavite Authentication: Sign in now i OAuth client: Register automatically, zatim kliknite Add.

  4. Kliknite Connect. Otvara se Wink stranica za prijavu na https://iam.wink.travel. Prijavite se u Wink i odobrite dozvole na zaslonu za suglasnost.

  5. Alati konektora sada su dostupni u vašim chatovima. Ponovite za svaki skup alata koji vaš posao zahtijeva; svaki je zaseban konektor.


Kad odobrite zaslon za suglasnost, vidjet ćete detaljan prikaz što agent traži. MCP klijenti koriste isti vokabular dozvola kao i ostatak platforme — pogledajte puni referentni popis dozvola na stranici Autentifikacije.

Tri stvari su specifične za MCP:

  • mcp.read, mcp.write, mcp.remove dozvole su dodatno potrebne za otvaranje MCP transporta. Klijent koji ima mcp.* dozvolu može pristupiti bilo kojoj Wink MCP krajnjoj točki, ali svaki alat koji pozove i dalje provodi dozvole sekcije krajnje točke koju obuhvaća (npr. booking.read).
  • MCP uvijek djeluje kao prijavljeni korisnik. AI klijent dobiva mcp.* dozvole kroz vašu prijavu, nikada od Aplikacije koju kreirate. Tokeni za stroj-stroj (client-credentials) ne mogu otvoriti MCP transport; za rad server-server koristite REST API.
  • AI klijent traži samo dozvole koje mu trebaju. Možete odbiti pojedinačne dozvole na zaslonu za suglasnost — alati koji zahtijevaju odbijenu dozvolu vratit će grešku pri pozivu.

Skupovi alata ne mijenjaju ništa od ovoga. Krajnja točka na koju se povežete odlučuje koji su alati navedeni, a ne što im je dozvoljeno. Povezivanje na /mcp/payment ne daje nikakvu financijsku dozvolu koju već nemate, a povezivanje na /mcp/reference ne sprječava alat da provodi svoje vlastite dozvole. Autorizacija se odlučuje po pozivu alata, na temelju vašeg tokena i ovlasti vašeg računa.


Kartica preglednika se ne otvara

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

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

401 Unauthorized nakon prijave

Vaš spremljeni token može biti zastario. Uklonite i ponovno dodajte poslužitelj da pokrenete novu prijavu:

Terminal window
# 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 poslužitelja iz postavki, ponovno pokrenite aplikaciju i dodajte ga ponovno.

403 Forbidden pri pozivu određenog alata

Alat zahtijeva dozvolu koju niste odobrili na zaslonu za suglasnost ili dozvolu koju vaš račun nema. Ponovno povežite poslužitelj — zaslon za suglasnost će se ponovno pojaviti i možete odobriti nedostajuću dozvolu. Ako i dalje ne uspijeva, alat treba dozvolu računa koju nemate; povezivanje na drugi skup alata neće pomoći jer skupovi alata ne dodjeljuju dozvole.

Alat koji trebam nije na popisu

Vjerojatno ste povezani na skup alata koji ne pokriva taj zadatak. Provjerite direktorij krajnjih točaka i dodajte skup alata koji ga pokriva — veze su neovisne, pa dodavanje jednog ne mijenja druge. Ako niste sigurni koji ga ima, privremeno se povežite na https://api.wink.travel/mcp, pronađite alat, zatim provjerite kojem skupu alata pripada.

404 Not Found na krajnjoj točki skupa alata

Pažljivo provjerite putanju — ugniježđeni skupovi alata imaju dva segmenta (/mcp/extranet/rates, ne /mcp/extranet-rates), a ravni jedan (/mcp/link-manager). Napomena da neautentificirani zahtjev na bilo koji put ispod /mcp vraća 401, ne 404, pa sam 401 ne govori postoji li krajnja točka.

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

Ta krajnja točka ne postoji. Integracija channel managera se služi samo s https://integrations.wink.travel/mcp/channel-manager. Ako također trebate ručno čitati ili pisati vlastite cijene objekta, to je zaseban zadatak na zasebnoj krajnjoj točki — vidi /mcp/extranet/rates.

Poslužitelj se pojavljuje, ali pozivi alata vraćaju “račun nije pronađen”

Prijavljeni ste u Wink račun koji nema upravljački subjekt. Idite na Wink Portal i provjerite je li vaš račun postavljen prije korištenja MCP poslužitelja.

Token istječe tijekom sesije

Tokeni vrijede 3 sata. Claude Code i Claude Desktop tiho osvježavaju tokene bez prekida sesije. Ako vidite greške autentifikacije nakon dužeg mirovanja, pošaljite novu poruku — klijent će se automatski ponovno autentificirati.

Codex CLI prikazuje “MCP server unreachable”

Provjerite je li vaš ~/.codex/config.json valjani JSON (bez zarez na kraju) i da je "type": "http" postavljeno. Codex zahtijeva HTTP transport za udaljene poslužitelje; stdio transport je samo za lokalne binarne datoteke.

ChatGPT meni “Connectors” nedostaje

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

Cursor poslužitelj pokazuje crveno / “Failed to connect”

Provjerite je li vaš ~/.cursor/mcp.json valjani JSON i sadrži "type": "http". Zatim idite na Settings → Cursor Settings → MCP i kliknite Refresh. Ako greška ostaje, potpuno ponovno pokrenite Cursor — promjene konfiguracije se ne preuzimaju uvijek bez ponovnog pokretanja.

Windsurf MCP poslužitelji nisu na popisu u postavkama

Windsurf zahtijeva potpuno ponovno pokretanje (ne samo ponovno učitavanje prozora) da prepozna promjene u mcp_config.json. Koristite File → Quit i ponovno pokrenite. Ako poslužitelji i dalje nisu vidljivi, provjerite jeste li na Windsurf verziji 1.4+ putem Help → About Windsurf.

Opcija “Add Server” u Clineu nije vidljiva

Upravitelj MCP poslužitelja zahtijeva Cline verziju 2.0 ili noviju. Otvorite VS Code Extensions panel, pronađite Cline i kliknite Update ako je dostupna nadogradnja. Nakon nadogradnje, ponovno učitajte VS Code (Ctrl+Shift+P → “Developer: Reload Window”).


Otvori Wink Portal Wink na GitHubu