MCP serverid

Wink pakub kahte autentitud MCP serverit. Mõlemad kasutavad interaktiivset OAuth2 sisselogimist (PKCE autoriseerimiskoodi voog) — sinu AI agent avab brauseri vahelehe, et saaksid sisse logida oma Wink kontoga. Klientide salasõnu ei ole vaja hallata.

Server	URL	Mida see teeb
Inventory API	https://api.wink.travel/mcp	Inventar, broneeringud, hinnad, müügikanalid, analüütika ja kõik platvormi toimingud
Integrations	https://integrations.wink.travel/mcp	Kanalihalduri integratsioonid — sünkroniseeri majutusasutused, hinnad ja saadavus OTA-dega

---

Kuidas autentimine töötab

Wink MCP serverid kasutavad OAuth2 autoriseerimiskoodi + PKCE voogu ja toetavad dünaamilist kliendiregistreerimist (RFC 7591). Esmakordsel ühendamisel toimub järgnev:

1. Sinu AI klient leiab autoriseerimisserveri MCP lõpp-punkti /.well-known/oauth-protected-resource metaandmete kaudu.
2. Klient registreerib end ise läbi dünaamilise kliendiregistreerimise — käsitsi rakenduse seadistust pole vaja.
3. Klient avab brauseri vahelehe aadressil https://iam.wink.travel. Sa logid sisse oma Wink kontoga ja kinnitad nõutud õigused nõusoleku ekraanil.
4. Wink väljastab sinu kontole ja identiteediga seotud ligipääsutokeni.
5. AI klient lisab tokeni igale MCP päringule. Kõik tööriistade tulemused on automaatselt seotud sinu haldusüksusega.
6. Tokenid aeguvad 3 tunni pärast. Sinu AI klient uuendab neid vaikselt taustal ilma uuesti sisselogimist nõudmata.

Iga tööriista päring käib sinu identiteedi all — samad ACL reeglid, mis kaitsevad veebipaneeli, kehtivad ka AI agendi puhul.

---

Ühenda oma AI klient

Claude Code

1. Veendu, et Claude Code on ajakohane:

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

2. Lisa Wink Inventory MCP server:

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

3. Claude Code võtab serveriga ühendust, leiab autoriseerimisserveri ja avab sinu vaikimisi brauseri.

4. Logi sisse Wink kontoga ja kinnita nõusoleku ekraanil õigused.

5. Claude Code kinnitab ühenduse. Kontrollimiseks kirjuta /mcp, et näha, kas server on lisatud ja tööriistad laetud.

Integratsioonide serveri lisamiseks:

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

Jaga oma meeskonnaga

Lisa --scope project käsule claude mcp add ja Claude Code kirjutab serveri URL-i .mcp.json faili projekti juurkausta. Kommiteeri see fail — iga meeskonnaliige teeb esimesel ühendamisel oma brauseris sisselogimise.

Claude Desktop

1. Muuda Claude Desktopi konfiguratsioonifaili:

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

2. Lisa MCP serverite kirjed:

   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. Sulge täielikult ja käivita uuesti Claude Desktop (kasuta menüüst Quit — akna sulgemine ei piisa).

4. Claude Desktop avab iga uue serveri jaoks brauseri vahelehe. Logi sisse Wink kontoga ja kinnita õigused.

5. Alumises tööriistaribal näitab pistiku ikoon mõlema serveri ühendatust.

OpenAI Codex

1. Veendu, et Codex CLI on paigaldatud:

   npm install -g @openai/codex

2. Ava (või loo) Codex konfiguratsioonifail:

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

3. Lisa Wink MCP serverite kirjed:

   ~/.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. Käivita Codex. Esmakordsel kasutamisel avab Codex brauseri vahelehe aadressil https://iam.wink.travel.

5. Logi sisse Wink kontoga ja kinnita nõutud õigused.

6. Codex kinnitab ühenduse. Käivita codex ja palu näidata saadaolevaid tööriistu, et kontrollida Wink serverite aktiivsust.

Note

Codex CLI MCP tugi nõuab versiooni 1.0 või uuemat. Kontrolli codex --version käsuga ja uuenda npm install -g @openai/codex abil.

ChatGPT

MCP serveri tugi on saadaval ChatGPT töölauarakenduses Plus, Pro, Team ja Enterprise tellijatele.

1. Laadi alla ja paigalda ChatGPT töölauarakendus, kui seda veel pole.

2. Ava rakendus ja klõpsa oma profiili ikoonil paremas ülanurgas, seejärel vali Seaded.

3. Mine Ühendused (või MCP serverid sõltuvalt rakenduse versioonist) ja klõpsa Lisa.

4. Sisesta Wink Inventory serveri URL:

   https://api.wink.travel/mcp

   Seejärel klõpsa Ühenda.

5. ChatGPT avab brauseri vahelehe aadressil https://iam.wink.travel. Logi sisse Wink kontoga ja kinnita õigused.

6. Korda samme 4–5 Integratsioonide serveri jaoks:

   https://integrations.wink.travel/mcp

7. Mõlemad serverid kuvatakse sinu Ühenduste nimekirjas. Alusta uut vestlust — Wink tööriistad on automaatselt saadaval.

Veebirakenduse piirang

MCP servereid saab seadistada ainult töölauarakenduses. ChatGPT veebiliides chatgpt.com ei toeta kohandatud MCP servereid.

Cursor

1. Ava (või loo) Cursor MCP konfiguratsioonifail:

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

2. Lisa Wink MCP serverite kirjed:

   ~/.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. Ava Cursor. Mine Seaded → Cursori seaded → MCP ja veendu, et mõlemad serverid on rohelise olekuga. Kui näed punast, klõpsa Värskenda.

4. Cursor avab brauseri vahelehe aadressil https://iam.wink.travel. Logi sisse Wink kontoga ja kinnita õigused.

5. Ava vestlus (Ctrl+L / Cmd+L) ja palu Cursoril näidata saadaolevaid Wink tööriistu, et kinnitada ühendus.

Projektipõhine konfiguratsioon

Võid panna mcp.json faili ka oma projekti juurkausta, mitte ainult ~/.cursor/. Projektipõhine konfiguratsioon on eelisjärjekorras ja teeb serverid kättesaadavaks kõigile meeskonnaliikmetele, kes avavad projekti Cursoris.

Windsurf

1. Ava (või loo) Windsurf MCP konfiguratsioonifail:

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

2. Lisa Wink MCP serverite kirjed:

   ~/.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. Taaskäivita täielikult Windsurf (Fail → Quit, seejärel ava uuesti).

4. Mine Seaded → MCP serverid ja kontrolli, et mõlemad serverid on ühendatud. Windsurf avab esmakordsel kasutamisel brauseri vahelehe aadressil https://iam.wink.travel.

5. Logi sisse Wink kontoga ja kinnita õigused. Serverid muutuvad seadete paneelis roheliseks pärast autentimist.

Note

Windsurf MCP tugi nõuab versiooni 1.4 või uuemat. Kontrolli Abi → Teave Windsurfist ja vajadusel uuenda Windsurf veebisaidilt.

Cline (VS Code)

Cline on VS Code laiendus, millel on sisseehitatud MCP serveri haldur. JSON-i käsitsi muutmine ei ole vajalik.

1. Paigalda Cline VS Code Marketplace’ist:

   • Ava VS Code ja vajuta Ctrl+Shift+X / Cmd+Shift+X
   • Otsi Cline ja klõpsa Installi

2. Klõpsa Cline ikoonil tegevusribal (vasak külgriba), et avada Cline paneel.

3. Klõpsa Cline tööriistaribal MCP serverite ikoonil (pistiku ikoon), seejärel vali Muuda MCP seadeid.

4. VS Code avab faili cline_mcp_settings.json. Lisa Wink kirjed:

   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. Salvesta fail. Cline laadib end automaatselt uuesti ja avab brauseri vahelehe aadressil https://iam.wink.travel.

6. Logi sisse Wink kontoga ja kinnita õigused. Mõlemad serverid kuvatakse MCP serverite paneelis aktiivsetena.

Alternatiiv: lisa URL kaudu

MCP serverite paneelis klõpsa Lisa server ja kleebi otse https://api.wink.travel/mcp. Cline täidab konfiguratsiooni automaatselt ja haldab autentimist ilma JSON-i käsitsi muutmata.

---

Õigused

Nõusoleku ekraanil näed, milliseid õigusi agent küsib. MCP kliendid kasutavad samu õiguste termineid nagu ülejäänud platvorm — vaata täielikku õiguste viidet autentimise lehel.

Kaks MCP-le spetsiifilist asja:

• mcp.read, mcp.write ja mcp.remove õigused on lisaks vajalikud MCP transpordi avamiseks. Klient, kellel on mcp.* õigus, pääseb /mcp lõpp-punktile, kuid iga tööriist, mida ta kutsub, kontrollib ikkagi selle lõpp-punkti sektsiooni õigust (nt booking.read).
• AI klient küsib ainult vajalikke õigusi. Sa võid nõusoleku ekraanil üksikuid õigusi keelata — tööriistad, mis vajavad keelatud õigust, annavad vea.

---

Tõrkeotsing

Brauseri vaheleht ei avane

Sinu AI klient ei pruugi veel toetada interaktiivset PKCE voogu. Kontrolli, et kasutad värsket versiooni:

• Claude Code: npm install -g @anthropic-ai/claude-code
• Codex CLI: npm install -g @openai/codex
• Claude Desktop / ChatGPT töölauarakendus: uuenda rakenduse sisseehitatud uuendajaga

401 Unauthorized pärast sisselogimist

Sinu vahemällu salvestatud token võib olla aegunud. Eemalda ja lisa server uuesti, et käivitada värske sisselogimine:

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

Claude Desktopi ja ChatGPT puhul eemalda server seadete alt, taaskäivita rakendus ja lisa server uuesti.

403 Forbidden konkreetse tööriista kutsumisel

Tööriist vajab õigust, mida sa nõusoleku ekraanil ei kinnitanud. Ühenda server uuesti — nõusoleku ekraan ilmub uuesti ja saad vajaliku loa kinnitada.

Server on nähtav, kuid tööriistade päringud tagastavad “account not found”

Oled sisse logitud Wink kontoga, millel puudub haldusüksus. Mine Wink portaalile ja veendu, et sinu konto on õigesti seadistatud enne MCP serveri kasutamist.

Token aegub sessiooni keskel

Tokenid kehtivad 3 tundi. Claude Code ja Claude Desktop uuendavad tokenid vaikselt ilma sessiooni katkestamata. Kui pärast pikka pausi ilmnevad autentimisvead, kirjuta uus sõnum — klient autentib end automaatselt uuesti.

Codex CLI kuvab “MCP server unreachable”

Kontrolli, et sinu ~/.codex/config.json on korrektne JSON (ilma lõppkomadeta) ja et "type": "http" on määratud. Codex nõuab kaugserverite puhul HTTP transporti; stdio transport on mõeldud ainult kohalikeks binaarideks.

ChatGPT “Connectors” menüü puudub

MCP tugi nõuab ChatGPT töölauarakenduse versiooni 1.2024.352 või uuemat ning aktiivset Plus, Pro, Team või Enterprise tellimust. Uuenda rakendus ja kontrolli oma plaani Seaded → Konto alt.

Cursor server näitab punast / “Failed to connect”

Kontrolli, et sinu ~/.cursor/mcp.json on korrektne JSON ja sisaldab "type": "http". Seejärel mine Seaded → Cursori seaded → MCP ja klõpsa Värskenda. Kui viga püsib, taaskäivita Cursor täielikult — konfiguratsiooni muudatused ei pruugi ilma taaskäivitamiseta rakenduda.

Windsurf MCP serverid ei ilmu seadetes

Windsurf vajab täielikku taaskäivitust (mitte ainult akna uuesti laadimist), et mcp_config.json muudatused jõustuksid. Kasuta Fail → Quit ja ava uuesti. Kui serverid ikka ei ilmu, veendu, et kasutad Windsurf versiooni 1.4+ (kontrolli Abi → Teave Windsurfist).

Cline “Add Server” valik puudub

MCP serveri haldur nõuab Cline versiooni 2.0 või uuemat. Ava VS Code laienduste paneel, leia Cline ja klõpsa Uuenda, kui uuendus on saadaval. Pärast uuendust laadi VS Code uuesti (Ctrl+Shift+P → “Developer: Reload Window”).

---

Ava Wink portaal Wink GitHubis