Siirry sisältöön

MCP-palvelimet

Winkin MCP-työkalut julkaistaan työkalusarjoina — kohdennettuina päätepisteinä, joista kukin kattaa yhden tehtävän. Yhdistät tekoälyasiakkaasi yhteen tai kahteen, jotka vastaavat työsi tarpeita, et kaikkiin.

Jokainen päätepiste käyttää interaktiivista OAuth2-kirjautumista (PKCE-valtuutuskoodivirta): tekoälyagenttisi avaa selaimen välilehden, kirjaudut sisään Wink-tililläsi, ja se on siinä. Asiakassalaisuuksia ei tarvitse hallita.

Kanavahallinnan integroija yhdistää yhteen päätepisteeseen
claude mcp add wink-channel-manager https://integrations.wink.travel/mcp/channel-manager --transport http
Hotelliyrittäjä, joka hallinnoi omia hintojaan, yhdistää toiseen
claude mcp add wink-rates https://api.wink.travel/mcp/extranet/rates --transport http

Miksi työkalut on jaettu päätepisteisiin

Osio nimeltä “Miksi työkalut on jaettu päätepisteisiin”

Wink tarjoaa noin 500 työkalua. Kaikkien antaminen agentille kerralla on teknisesti mahdollista — mutta huono idea.

Työkalumääritelmät kuluttavat kontekstia. Jokainen MCP-palvelimen mainostama työkalu ladataan mallin konteksti-ikkunaan ennen työn aloittamista, mukaan lukien sen kuvaus ja täydellinen parametrikaavio. Viisisataa työkalua vie suuren osan siitä budjetista, jota varsinaiseen tehtävääsi tarvitaan, jokaisella pyynnöllä.

Valinnan laatu heikkenee listan kasvaessa. Agentti, joka valitsee 500 samankaltaisesti nimetyistä työkaluista, tekee huonompia valintoja kuin agentti, joka valitsee 40:stä. Jos integroit kanavahallinnan, noin kaksikymmentä työkalua on sinulle relevantteja; loput 480 ovat melua, joka vaikeuttaa oikean työkalun löytämistä.

Työ on aidosti erotettavissa. Joku, joka synkronoi saatavuustietoja PMS:stä, ja joku, joka kuratoi affiliate-laskeutumissivuja, jakavat lähes nolla työkalua. Jakaminen tehtävän mukaan tarkoittaa, että jokainen yhteys kantaa yhden tehtävän sanaston.


Kaksi isäntää palvelee työkalusarjoja. Työkalujen määrät ovat likimääräisiä ja kasvavat ajan myötä.

PäätepisteTyökalutMitä se kattaa
/mcp/extranet/facilities~64Varattava ja paikan päällä oleva inventaario: vierashuoneet ja huonetyypit, kylpylät, ravintolat, kokoustilat, aktiviteetit, nähtävyydet, paikat, muut myytävät kohteet
/mcp/extranet/property~62Kiinteistötiedot ja kaupalliset ehdot: profiili ja sisältö, lisäpalvelut, peruutusehdot, edut, ilmoitukset
/mcp/settings~60Tilin hallinta: hallinnoivan yksikön profiili ja brändäys, johtajat ja heidän valtuutuksensa, räätälöinti, webhookit, ilmoitusasetukset
/mcp/studio/embeds~48Kuratoidun inventaarion julkaisu: widgetit, ruudukot ja järjestetyt ruudukot, kortit, kartat, syvät linkit inventaarioon ja toimittajasivuille
/mcp/extranet/rates~44Hinnat ja saatavuus: inventaarion hintakaudet ja allokaatiot, hintasuunnitelmat, päähintatasot, erityis- ja kampanjahinnat
/mcp/extranet/operations~39Kiinteistön päivittäinen hallinta: varaukset ja niiden elinkaari, vieraspalautteet ja vastaukset, kalenterisyötteet, aikataulutetut tehtävät
/mcp/extranet/distribution~37Missä inventaario myydään: myyntikanavat ja hintamuokkaajat, affiliate- ja toimittajasuhdepyynnöt, rekisteröinti, liidien keruu
/mcp/studio/curation~35Kaupallistettavien kokoelmien rakentaminen: staattiset ja dynaamiset listat, järjestetyt listat, tallennetut haut, kiinteistökokonaisuudet
/mcp/link-manager~28Syndikoidut linkkikokoelmat, niiden suunnittelu, kategoriat ja tagit, sekä lyhennetyt URL-osoitteet
/mcp/reference~24Vain luku -hakutiedot: maat, valuutat ja valuuttakurssit, kielet, aikavyöhykkeet, maantieteelliset haut, IP-sijainti
/mcp/analytics~18Varaus- ja tulosanalyytiikka: yleiskatsaukset, viivakaaviot, tulostaulut, affiliate-suorituskyky, jakomittarit
/mcp/payment~18Taloudelliset toiminnot: kirjanpito, nostot ja kuluarviot, varausrahastojen yhteenvedot
/mcp/booking-engine~17Matkustajalle suunnattu ostopolku: haku ja haku, ostoskori ja kassalle siirtyminen, bucket-listat, kampanjan räätälöinti
/mcp/social~17Yhdistetyt sosiaalitilit, julkaisujen ja aikataulutuksen hallinta, julkaisujen analytiikan lukeminen
/mcp/travel-agent~8Agentin avustamat varaukset matkustajien puolesta ja agenttiraportit

https://integrations.wink.travel — kanavahallinnan integraatiot

Osio nimeltä “https://integrations.wink.travel — kanavahallinnan integraatiot”

Yksi päätepiste, koska tämä isäntä on olemassa yhtä tehtävää varten.

PäätepisteTyökalutMitä se kattaa
/mcp/channel-manager~9Kanavahallinnan, PMS:n tai CRS:n yhdistäminen ja vahvistaminen

Jokainen päätepiste sisältää myös ping-työkalun, jolla voit varmistaa yhteyden olevan elossa ennen varsinaisen työn aloittamista.

Täydelliseen matkustajan varausprosessiin yhdistä Wink Booking Engine osoitteessa https://api.wink.travel/mcp/booking-engine ja yhteensopiva maksulompakko. Winkin MCP:n lisääminen avaa selaimen kirjautumisen ja käyttöoikeuksien valinnan; asiakas hoitaa sitten autentikoinnin.

Booking Engine sisältää kohteen haun, hotellin ja huoneiden haun, agentic_booking_quote, agentic_booking_pay, agentic_booking_book, varausten hakemisen ja kuitit, kun agenttivaraus ja -maksu ovat käytössä kyseisessä ympäristössä. Katso Agentic Payments yhteysasetuksista, valittavista käyttöoikeuksista ja hakuvaiheesta vahvistukseen.


Jos olet…Yhdistä
Integroimassa kanavahallintaa, PMS:ää tai CRS:ääintegrations.wink.travel/mcp/channel-manager — vain tämä
Hallinnoimassa kiinteistön sisältöä/mcp/extranet/property + /mcp/extranet/facilities
Hallinnoimassa huoneita ja huonetyyppejä/mcp/extranet/facilities
Hallinnoimassa hintoja ja saatavuutta/mcp/extranet/rates
Hoitaessa päivittäisiä varauksia/mcp/extranet/operations
Kasvattamassa jakelua/mcp/extranet/distribution + /mcp/analytics
Rakentamassa affiliate-sivuja/mcp/studio/curation + /mcp/studio/embeds
Hoitaessa link-in-bio -sivuja/mcp/link-manager + /mcp/social
Varaamassa matkustajien puolesta/mcp/travel-agent
Tasaamassa rahavirtoja/mcp/payment
Varaamassa huonetta tekoälyagentilla/mcp/booking-engine + yhteensopiva maksulompakko — katso Agentic Payments
Rakentamassa varauskokemusta/mcp/booking-engine; tarvittaessa /mcp/reference lisähakuihin

Booking Engine sisältää varauksen ydintoiminnot. Se tarjoaa tilin ja räätälöinnin tunnistuksen, kohteen haun, hotellin saatavuuden ja huonehintatiedot, ostoskorit, kassalle siirtymisen ja matkustajan varauksen hallinnan. Agenttivaraus- ja maksutyökalut sisältyvät myös, kun ne ovat käytössä kyseisessä ympäristössä.

Kaupunkipohjaiseen hotellihakuun käytä destination_lookup_search_suggestions kohteen ratkaisemiseen ja sitten inventory_search_city saatavilla olevien hotellien ja hintojen löytämiseen. Molemmat työkalut ovat /mcp/booking-engine-päätepisteessä, joten tämä prosessi ei vaadi Reference-yhteyttä.

Lisää /mcp/reference, kun tarvitset tukihakuita kuten maat, valuutat ja valuuttakurssit, tuetut kielet, aikavyöhykkeet, laajemmat maantieteelliset haut, OTA-luokitukset tai julkiset kiinteistötiedot. Nämä ovat valinnaisia lisäyksiä varausprosessiin.

Aloita yhdellä. Lisää toinen, kun huomaat tarvitsevasi jotain, mitä se ei osaa — jokainen yhteys on itsenäinen, eikä yhden lisääminen vaikuta muihin.


Wink MCP -palvelimet käyttävät OAuth2 Authorization Code + PKCE -virtaa ja tukevat Dynamic Client Registration (RFC 7591) -toimintoa. Näin tapahtuu, kun yhdistät ensimmäistä kertaa:

  1. Tekoälyasiakkaasi löytää valtuutuspalvelimen MCP-päätepisteen /.well-known/oauth-protected-resource -metadatasta.
  2. Asiakas rekisteröityy itse Dynamic Client Registration -menetelmällä — manuaalista sovelluksen asetusta ei tarvita.
  3. Asiakas avaa selaimen välilehden osoitteeseen https://iam.wink.travel. Kirjaudut sisään Wink-tililläsi ja hyväksyt pyydetyt käyttöoikeudet suostumusnäytöllä.
  4. Wink myöntää käyttöoikeustunnuksen, joka on sidottu tiliisi ja identiteettiisi.
  5. Tekoälyasiakas liittää tunnuksen jokaiseen MCP-pyyntöön. Kaikki työkalujen tulokset rajataan automaattisesti hallinnoivan yksikön mukaan.
  6. Tunnukset vanhenevat 3 tunnin kuluttua. Tekoälyasiakas päivittää ne hiljaisesti taustalla ilman uutta kehotetta.

Jokainen työkalukutsu suoritetaan kirjautuneena käyttäjänä — samat käyttöoikeussäännöt, jotka suojaavat verkkopalvelua, pätevät myös tekoälyagenttiin.


Lisää jokainen työkalusarja Claudeen mukautettuna liittimenä. Konfiguraatiotiedostoa ei tarvitse muokata eikä sovellusta tai salaisuutta luoda.

  1. Avaa Claudessa Customize › Connectors, napsauta Add ja sitten Add custom connector.

  2. Syötä Nimi (esim. Wink Link manager) ja MCP-palvelimen URL työkalusarja yllä olevasta hakemistosta, esimerkiksi:

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

    Klikkaa Continue.

  3. Claude tunnistaa Winkin kirjautumisen. Pidä valittuna Authentication: Sign in now ja OAuth client: Register automatically, sitten napsauta Add.

  4. Klikkaa Connect. Wink-kirjautumissivu avautuu osoitteessa https://iam.wink.travel. Kirjaudu Winkiin ja hyväksy käyttöoikeudet suostumusnäytöllä.

  5. Liittimen työkalut ovat nyt käytettävissä keskusteluissasi. Toista jokaiselle työkalusarjalle, jota työsi tarvitsee; jokainen on oma liittimensä.


Kun hyväksyt suostumusnäytön, näet erittelyn agentin pyytämistä oikeuksista. MCP-asiakkaat käyttävät samaa käyttöoikeussanastoa kuin muu alusta — katso täydellinen alueiden viite Authentication-sivulla.

Kolme asiaa on erityisiä MCP:lle:

  • mcp.read mcp.write mcp.remove -alueet vaaditaan lisäksi MCP-siirron avaamiseen. Asiakas, jolla on mcp.*-alue, pääsee mihin tahansa Wink MCP -päätepisteeseen, mutta jokainen kutsuttu työkalu noudattaa silti päätepisteen omaa osioaluetta (esim. booking.read).
  • MCP toimii aina kirjautuneena käyttäjänä. Tekoälyasiakas saa mcp.*-alueet kirjautumisesi kautta, ei koskaan luomastasi Sovelluksesta. Koneiden välinen (client-credentials) tunnus ei voi avata MCP-siirtoa; käytä REST API:a palvelinpalvelintyöhön.
  • Tekoälyasiakas pyytää vain tarvitsemansa alueet. Voit kieltää yksittäiset oikeudet suostumusnäytöllä — työkalut, jotka vaativat kiellettyä aluetta, palauttavat virheen kutsuttaessa.

Työkalusarjat eivät muuta tätä. Päätepiste, johon yhdistät, päättää, mitkä työkalut listataan, ei mitä ne saavat tehdä. Yhdistäminen /mcp/payment-päätepisteeseen ei anna taloudellisia oikeuksia, joita sinulla ei jo olisi, eikä yhdistäminen /mcp/reference estä työkalua noudattamasta omaa aluettaan. Valtuutus päätetään työkalukutsun perusteella tokenistasi ja tilisi valtuuksista.


Selaimen välilehti ei avaudu

Tekoälyasiakkaasi ei ehkä tue vielä interaktiivista PKCE-virtaa. Varmista, että käytät uusinta versiota:

  • Claude Code: npm install -g @anthropic-ai/claude-code
  • Codex CLI: npm install -g @openai/codex
  • Claude Desktop / ChatGPT desktop: päivitä sovelluksen sisäisellä päivitystyökalulla

401 Unauthorized kirjautumisen jälkeen

Välimuistissa oleva tunnus voi olla vanhentunut. Poista ja lisää palvelin uudelleen, jolloin kirjautuminen käynnistyy uudestaan:

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

Claude Desktopissa ja ChatGPT:ssä poista palvelin asetuksista, käynnistä sovellus uudelleen ja lisää palvelin uudelleen.

403 Forbidden tiettyä työkalua kutsuttaessa

Työkalu vaatii käyttöoikeusalueen, jota et hyväksynyt suostumusnäytöllä, tai tilisi ei omista tarvittavaa oikeutta. Yhdistä palvelin uudelleen — suostumusnäyttö tulee uudestaan ja voit hyväksyä puuttuvan oikeuden. Jos virhe jatkuu, työkalu tarvitsee tilioikeuden, jota sinulla ei ole; eri työkalusarjaan yhdistäminen ei auta, koska työkalusarjat eivät myönnä oikeuksia.

Tarvittava työkalu ei ole listassa

Olet todennäköisesti yhdistänyt työkalusarjaan, joka ei kata kyseistä tehtävää. Tarkista päätepistehakemisto ja lisää työkalusarja, joka kattaa sen — yhteydet ovat itsenäisiä, joten yhden lisääminen ei vaikuta muihin. Jos et ole varma, mikä sarja sisältää työkalun, yhdistä väliaikaisesti https://api.wink.travel/mcp, etsi työkalu ja katso, mihin työkalusarjaan se kuuluu.

404 Not Found työkalusarjan päätepisteessä

Tarkista polku huolellisesti — sisäkkäisissä työkalusarjoissa on kaksi segmenttiä (/mcp/extranet/rates, ei /mcp/extranet-rates), ja tasaisissa yksi (/mcp/link-manager). Huomaa, että autentikoimaton pyyntö mihin tahansa /mcp-polun alle palauttaa 401, ei 404, joten pelkkä 401 ei kerro, onko päätepistettä olemassa.

Yhdistin api.wink.travel/mcp/channel-manager eikä mitään tapahtunut

Tätä päätepistettä ei ole olemassa. Kanavahallinnan integraatio palvelee vain osoitteessa https://integrations.wink.travel/mcp/channel-manager. Jos sinun täytyy myös lukea tai kirjoittaa kiinteistön omia hintoja käsin, se on eri tehtävä eri päätepisteessä — katso /mcp/extranet/rates.

Palvelin näkyy, mutta työkalukutsut palauttavat “account not found”

Olet kirjautunut Wink-tilille, jolla ei ole hallinnoivaa yksikköä. Mene Wink Portaliin ja varmista, että tilisi on asetettu oikein ennen MCP-palvelimen käyttöä.

Tunnus vanhenee istunnon aikana

Tunnukset ovat voimassa 3 tuntia. Claude Code ja Claude Desktop päivittävät tunnukset hiljaisesti ilman keskeytystä. Jos näet autentikointivirheitä pitkän käyttämättömyyden jälkeen, kirjoita uusi viesti — asiakas autentikoi uudelleen automaattisesti.

Codex CLI näyttää “MCP server unreachable”

Tarkista, että ~/.codex/config.json on kelvollinen JSON (ei loppupisteitä) ja että "type": "http" on asetettu. Codex vaatii HTTP-siirron etäpalvelimille; stdio-siirto on vain paikallisille binääreille.

ChatGPT:n “Connectors” -valikko puuttuu

MCP-tuki vaatii ChatGPT:n työpöytäsovelluksen version 1.2024.352 tai uudemman ja aktiivisen Plus-, Pro-, Team- tai Enterprise-tilauksen. Päivitä sovellus ja tarkista tilausasetuksista.

Cursor-palvelin näyttää punaisena / “Failed to connect”

Varmista, että ~/.cursor/mcp.json on kelvollinen JSON ja sisältää "type": "http". Mene sitten Asetukset → Cursor Settings → MCP ja napsauta Päivitä. Jos virhe jatkuu, käynnistä Cursor kokonaan uudelleen — konfiguraatiomuutokset eivät aina päivity ilman uudelleenkäynnistystä.

Windsurf MCP -palvelimia ei näy asetuksissa

Windsurf vaatii täydellisen uudelleenkäynnistyksen (ei pelkkää ikkunan uudelleenlatausta) noutaakseen muutokset mcp_config.json-tiedostoon. Käytä Tiedosto → Lopeta ja käynnistä uudelleen. Jos palvelimia ei vieläkään näy, varmista, että käytössä on Windsurf 1.4+ kohdasta Ohje → Tietoja Windsurfista.

Cline “Add Server” -vaihtoehto ei näy

MCP-palvelimen hallinta vaatii Cline-version 2.0 tai uudemman. Avaa VS Code Extensions -paneeli, etsi Cline ja napsauta Päivitä, jos päivitys on saatavilla. Päivityksen jälkeen lataa VS Code uudelleen (Ctrl+Shift+P → “Developer: Reload Window”).


Avaa Wink Portal Wink GitHubissa