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

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 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. Henkilö, joka synkronoi saatavuutta PMS:stä, ja henkilö, joka kuratoi affiliate-laskentatauluja, jakavat lähes nolla työkalua. Tehtäväkohtainen jako tarkoittaa, että jokainen yhteys kantaa yhden tehtävän sanaston.

Työkalusarjat eivät ole käyttöoikeuksia

Kapean työkalusarjan valinta ei rajoita tilisi toimintoja, eikä laajan valinta anna mitään ylimääräistä. Jokainen työkalu noudattaa samoja tilin käyttöoikeuksia kuin verkkosivusto, kirjautuneen identiteettisi alla. Jos tilisi ei voi perua varausta Wink Portalissa, agenttikaan ei voi — riippumatta siitä, mihin päätepisteeseen se on yhdistetty.

Valitse työkalusarjat keskittymisen vuoksi, ei turvallisuuden.

---

Päätepistehakemisto

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

https://api.wink.travel — alusta

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

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

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

Päätepiste	Työkalut	Mitä se kattaa
/mcp/channel-manager	~9	Kanavahallinnan, PMS:n tai CRS:n yhdistäminen ja vahvistaminen

Kanavahallinnan integrointi vs. omien hintojen hallinta

Nämä ovat eri tehtäviä eri ihmisille, eikä niillä ole yhteistä päätepistettä.

Kanavahallinnan, PMS:n tai CRS:n toimittaja integroituu kerran osoitteessa integrations.wink.travel/mcp/channel-manager, ja sen jälkeen vaihtaa kiinteistötietoja, hintoja, saatavuutta ja varauksia tämän integraation kautta. Tämä yksittäinen päätepiste on koko rajapinta.

Hotelliyrittäjä, joka muuttaa omia hintojaan käsin, käyttää extranet-työkalusarjoja osoitteessa api.wink.travel — /mcp/extranet/rates ja muut. Nämä eivät kuulu kanavahallinnan integraatioon, eikä integroijalla ole syytä yhdistää niihin.

Tilinhallinta on myös api.wink.travel-isännällä, kohdassa /mcp/settings. Integraatioisännällä ei ole /mcp/settings-päätepistettä.

Jokainen päätepiste sisältää myös ping-työkalun, jolla voit varmistaa yhteyden toimivuuden ennen varsinaista työtä.

Agenttiset maksut

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 kirjautumista ja lupien valintaa varten; asiakas hoitaa sitten todennuksen.

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 yhteyden muodostamisesta, valittavista käyttöoikeuksista ja hakuvaiheesta vahvistukseen.

---

Mitä työkalusarjoja tarvitsen?

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
Pyörittämässä link-in-bio -sivuja	/mcp/link-manager + /mcp/social
Varaamassa matkustajien puolesta	/mcp/travel-agent
Sovittamassa 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 ydintoiminnallisuuden. 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, sitten inventory_search_city saatavilla olevien hotellien ja hintojen löytämiseen. Molemmat työkalut ovat /mcp/booking-engine-päätepisteessä, joten tämä virtaus 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.

Haluatko silti kaiken?

https://api.wink.travel/mcp ja https://integrations.wink.travel/mcp ovat edelleen käytettävissä ja tarjoavat kaikki työkalut isännällään. Ne ovat hyödyllisiä tutustumiseen, mutta emme suosittele niitä päivittäiseen työhön: työkalulista on niin suuri, että se peittää tehtäväsi ja heikentää agentin työkalujen valintaa. Suosi yllä olevia työkalusarjoja.

---

Miten todennus toimii

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älyasiakas 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. Asiakas päivittää ne hiljaisesti taustalla ilman uutta kehotetta.

Jokainen työkalukutsu suoritetaan identiteettisi alla — samat käyttöoikeussäännöt, jotka suojaavat verkkosivustoa, pätevät myös tekoälyagenttiin.

---

Yhdistä tekoälyasiakkaasi

Claude Code

1. Varmista, että Claude Code on ajan tasalla:

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

2. Valitse työkalusarja yllä olevasta hakemistosta ja lisää se. Esimerkiksi hinnat ja saatavuus:

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

3. Claude Code ottaa yhteyden palvelimeen, löytää valtuutuspalvelimen ja avaa oletusselaimesi.

4. Kirjaudu sisään Winkiin ja hyväksy lupapyyntö suostumusnäytöllä.

5. Claude Code vahvistaa yhteyden. Kirjoita /mcp varmistaaksesi, että palvelin näkyy ja sen työkalut ovat ladattu.

Lisää niin monta työkalusarjaa kuin työsi tarvitsee — jokainen on oma palvelinmerkintänsä omalla nimellään:

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

Kirjaudut sisään vain kerran. Ensimmäisen selaimen hyväksynnän jälkeen Claude Code käyttää samaa Wink-istuntoasi lisäosoitteisiin.

Jaa tiimisi kanssa

Lisää --scope project komentoon claude mcp add ja Claude Code tallentaa palvelimen URL-osoitteen .mcp.json-tiedostoon reposi juureen. Tee commit tästä tiedostosta — jokainen tiimin jäsen saa samat työkalusarjat ja suorittaa oman selaimen kirjautumisensa ensimmäisellä kerralla.

Claude Desktop

1. Muokkaa Claude Desktopin asetustiedostoa:

   • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
   • Windows: %APPDATA%\Claude\claude_desktop_config.json
   • Linux: ~/.config/Claude/claude_desktop_config.json

2. Lisää MCP-palvelinmerkinnät:

   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. Sulje Claude Desktop kokonaan ja käynnistä uudelleen (käytä valikkokohtaa Quit — pelkkä ikkunan sulkeminen ei riitä).

4. Claude Desktop avaa selaimen välilehden jokaiselle uudelle palvelimelle. Kirjaudu Winkiin ja hyväksy käyttöoikeudet.

5. Alapalkin pistokekuvake näyttää molemmat palvelimet yhdistettyinä.

OpenAI Codex

1. Varmista, että Codex CLI on asennettu:

   npm install -g @openai/codex

2. Avaa (tai luo) Codexin asetustiedosto:

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

3. Lisää Wink MCP -palvelinmerkinnät:

   ~/.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. Käynnistä Codex. Ensimmäisellä käyttökerralla Codex avaa selaimen välilehden osoitteeseen https://iam.wink.travel.

5. Kirjaudu sisään Winkiin ja hyväksy pyydetyt käyttöoikeudet.

6. Codex vahvistaa yhteyden. Suorita codex ja pyydä listaamaan käytettävissä olevat työkalut varmistaaksesi, että Wink-palvelimet ovat aktiivisia.

Huomio

Codex CLI:n MCP-tuki vaatii version 1.0 tai uudemman. Tarkista versio komennolla codex --version ja päivitä komennolla npm install -g @openai/codex.

ChatGPT

MCP-palvelintuki on saatavilla ChatGPT:n työpöytäsovelluksessa Plus-, Pro-, Team- ja Enterprise-tilaajille.

1. Lataa ja asenna ChatGPT:n työpöytäsovellus, jos et ole vielä tehnyt niin.

2. Avaa sovellus ja klikkaa profiilikuvakettasi oikeassa yläkulmassa, valitse sitten Asetukset.

3. Mene kohtaan Liittimet (tai MCP-palvelimet sovellusversion mukaan) ja klikkaa Lisää.

4. Syötä työkalusarjan URL-osoite yllä olevasta hakemistosta, esimerkiksi:

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

   Klikkaa sitten Yhdistä.

5. ChatGPT avaa selaimen välilehden osoitteeseen https://iam.wink.travel. Kirjaudu sisään Winkiin ja hyväksy käyttöoikeudet.

6. Toista vaiheet 4–5 kaikille muille työkalusarjoille, joita työsi tarvitsee, esimerkiksi:

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

7. Jokainen työkalusarja näkyy liittimissäsi. Aloita uusi keskustelu — Wink-työkalut ovat automaattisesti käytettävissä.

Verkkosovelluksen rajoitus

MCP-palvelimia voi määrittää vain työpöytäsovelluksessa. ChatGPT:n verkkokäyttöliittymä chatgpt.com:ssa ei tue mukautettuja MCP-palvelimia.

Cursor

1. Avaa (tai luo) Cursorin MCP-asetustiedosto:

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

2. Lisää Wink MCP -palvelinmerkinnät:

   ~/.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. Avaa Cursor. Mene kohtaan Asetukset → Cursor-asetukset → MCP ja varmista, että molemmat palvelimet näkyvät vihreällä tilamerkillä. Jos ne näkyvät punaisina, klikkaa Päivitä.

4. Cursor avaa selaimen välilehden osoitteeseen https://iam.wink.travel. Kirjaudu sisään Winkiin ja hyväksy käyttöoikeudet.

5. Avaa keskustelu (Ctrl+L / Cmd+L) ja pyydä Cursoria listaamaan käytettävissä olevat Wink-työkalut varmistaaksesi yhteyden.

Projektikohtainen asetustiedosto

Voit myös sijoittaa mcp.json-tiedoston projektisi juureen ~/.cursor/-kansion sijaan. Projektikohtainen asetustiedosto menee asetuksissa edelle ja tekee palvelimet saataville jokaiselle tiimin jäsenelle, joka avaa projektin Cursorissa.

Windsurf

1. Avaa (tai luo) Windsurfin MCP-asetustiedosto:

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

2. Lisää Wink MCP -palvelinmerkinnät:

   ~/.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. Käynnistä Windsurf kokonaan uudelleen (Tiedosto → Lopeta, sitten avaa uudelleen).

4. Mene kohtaan Asetukset → MCP-palvelimet ja varmista, että molemmat palvelimet näkyvät yhdistettyinä. Windsurf avaa selaimen välilehden osoitteeseen https://iam.wink.travel ensimmäisellä käyttökerralla.

5. Kirjaudu sisään Winkiin ja hyväksy käyttöoikeudet. Palvelimet muuttuvat vihreiksi asetuspaneelissa, kun todennus on suoritettu.

Huomio

Windsurf MCP -tuki vaatii version 1.4 tai uudemman. Tarkista versio kohdasta Ohje → Tietoja Windsurfista ja päivitä Windsurfin verkkosivustolta tarvittaessa.

Cline (VS Code)

Cline on VS Code -laajennus, jossa on sisäänrakennettu MCP-palvelinhallinta. Manuaalista JSON-muokkausta ei tarvita.

1. Asenna Cline VS Code Marketplace -kaupasta:

   • Avaa VS Code ja paina Ctrl+Shift+X / Cmd+Shift+X
   • Etsi Cline ja klikkaa Asenna

2. Klikkaa Cline-kuvaketta Aktiviteettipalkissa (vasen sivupalkki) avataksesi Cline-paneelin.

3. Klikkaa MCP-palvelimet -kuvaketta (pistokkeen kuva) Cline-työkalurivillä, valitse sitten Muokkaa MCP-asetuksia.

4. VS Code avaa tiedoston cline_mcp_settings.json. Lisää Wink-merkinnät:

   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. Tallenna tiedosto. Cline lataa asetukset uudelleen automaattisesti ja avaa selaimen välilehden osoitteeseen https://iam.wink.travel.

6. Kirjaudu sisään Winkiin ja hyväksy käyttöoikeudet. Molemmat palvelimet näkyvät aktiivisina MCP-palvelimet-paneelissa.

Vaihtoehto: lisää URL:n kautta

MCP-palvelimet-paneelissa klikkaa Lisää palvelin ja liitä työkalusarjan URL, kuten https://api.wink.travel/mcp/extranet/rates suoraan. Cline täyttää asetukset automaattisesti ja hoitaa todennuksen ilman manuaalista JSON-muokkausta.

---

Käyttöoikeudet

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 käyttöoikeusviite todennussivulla.

Kaksi asiaa on erityisiä MCP:lle:

• mcp.read, mcp.write ja mcp.remove -oikeudet vaaditaan lisäksi MCP-yhteyden avaamiseen. Asiakas, jolla on mcp.*-oikeus, pääsee mihin tahansa Wink MCP -päätepisteeseen, mutta jokainen kutsuttu työkalu noudattaa edelleen päätepisteen omaa osakäyttöoikeutta (esim. booking.read).
• Tekoälyasiakas pyytää vain tarvitsemansa oikeudet. Voit kieltää yksittäisiä oikeuksia suostumusnäytöllä — työkalut, jotka vaativat kiellettyä oikeutta, 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 ei anna taloudellisia oikeuksia, joita sinulla ei jo ole, eikä yhdistäminen /mcp/reference estä työkalua noudattamasta omaa käyttöoikeuttaan. Valtuutus päätetään jokaisen työkalukutsun yhteydessä tokenin ja tilisi valtuutusten perusteella.

---

Vianmääritys

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 työpöytä: päivitä sovelluksen sisäisellä päivitystyökalulla

401 Unauthorized kirjautumisen jälkeen

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

# 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 uudestaan.

403 Forbidden tiettyä työkalua kutsuttaessa

Työkalu vaatii käyttöoikeuden, jota et hyväksynyt suostumusnäytöllä, tai tililläsi ei ole 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ää oikea työkalusarja — yhteydet ovat itsenäisiä, joten yhden lisääminen ei vaikuta muihin. Jos et ole varma, mikä sisältää työkalun, yhdistä tilapäisesti 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äisillä työkalusarjoilla on kaksi segmenttiä (/mcp/extranet/rates, ei /mcp/extranet-rates), ja tasaisilla yksi (/mcp/link-manager). Huomaa, että tunnistamaton 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 tarvitset myös kiinteistön omien hintojen lukemista tai kirjoittamista 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öä.

Token vanhenee istunnon aikana

Tokenit ovat voimassa 3 tuntia. Claude Code ja Claude Desktop päivittävät tokenit hiljaisesti ilman keskeytystä. Jos näet todennusvirheitä pitkän tauon jälkeen, kirjoita uusi viesti — asiakas todennus 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 tilisi asetuksista.

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-asetukset → MCP ja klikkaa Päivitä. Jos virhe jatkuu, käynnistä Cursor kokonaan uudelleen — asetusten muutokset 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) mcp_config.json -muutosten havaitsemiseksi. Käytä Tiedosto → Lopeta ja käynnistä uudelleen. Varmista, että käytössä on Windsurf 1.4+ kohdasta Ohje → Tietoja Windsurfista.

Cline “Lisää palvelin” -vaihtoehto ei näy

MCP-palvelinhallinta vaatii Cline-version 2.0 tai uudemman. Avaa VS Code -laajennukset, etsi Cline ja klikkaa 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