MCP þjónar

Wink býður upp á tvo auðkennda MCP þjónar. Báðir nota gagnvirka OAuth2 innskráningu (PKCE heimildarkóðaflæði) — AI-umboðsmaður þinn opnar vafraglugga svo þú skráir þig inn með Wink reikningnum þínum. Engar viðskiptavinleyndarmál til að stjórna.

Þjónn	URL	Hvað hann gerir
Inventory API	https://api.wink.travel/mcp	Birgðir, bókanir, verð, sölurásir, greiningar og allar aðgerðir á vettvangi
Integrations	https://integrations.wink.travel/mcp	Samþættingar rásarstjóra — samstilltu eignir, verð og framboð með OTA-kerfum

---

Hvernig auðkenning virkar

Wink MCP þjónar nota OAuth2 Heimildarkóða + PKCE flæði og styðja Dynamic Client Registration (RFC 7591). Þetta gerist þegar þú tengir í fyrsta sinn:

1. AI viðskiptavinurinn finnur auðkenningarþjóninn úr /.well-known/oauth-protected-resource metadata MCP endapunktsins.
2. Viðskiptavinurinn skráir sig sjálfur með Dynamic Client Registration — engin handvirk umsóknaruppsetning nauðsynleg.
3. Viðskiptavinurinn opnar vafraglugga á https://iam.wink.travel. Þú skráir þig inn með Wink reikningnum þínum og samþykkir beiðnar heimildir á samþykkisskjánum.
4. Wink gefur út aðgangstákn sem er bundið við reikninginn þinn og auðkenni.
5. AI viðskiptavinurinn festir táknið við hverja MCP beiðni. Öll niðurstaða tækja er sjálfkrafa bundin við þitt stjórnunareiningu.
6. Táknum rennur út eftir 3 klukkustundir. AI viðskiptavinurinn endurnýjar táknin hljóðlega í bakgrunni án frekari fyrirspurna.

Allar tækjakall keyra undir þínu auðkenni — sömu ACL reglur sem vernda vefsvæðið gilda um AI umboðsmanninn.

---

Tengdu AI viðskiptavininn þinn

Claude Code

1. Gakktu úr skugga um að Claude Code sé uppfærður:

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

2. Bættu við Wink Inventory MCP þjóninum:

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

3. Claude Code tengist þjóninum, finnur auðkenningarþjóninn og opnar sjálfgefinn vafra.

4. Skráðu þig inn í Wink og samþykktu beiðnina um heimildir á samþykkisskjánum.

5. Claude Code staðfestir tenginguna. Sláðu inn /mcp til að staðfesta að þjónninn birtist og tól hafi hlaðist.

Til að bæta við Integrations þjóninum líka:

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

Deildu með teyminu þínu

Bættu við --scope project í claude mcp add og Claude Code skrifar þjóns-URL í .mcp.json í rót verkefnisins. Skráðu það inn — hver liðsfélagi klárar eigin vafra-innskráningu í fyrsta sinn sem hann tengist.

Claude Desktop

1. Breyttu stillingarskránni fyrir Claude Desktop:

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

2. Bættu við MCP þjónnaskrám:

   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. Lokaðu alveg og ræstu Claude Desktop aftur (notaðu Quit úr valmyndastikunni — að loka glugga er ekki nóg).

4. Claude Desktop opnar vafraglugga fyrir hvern nýjan þjón. Skráðu þig inn í Wink og samþykktu heimildir.

5. Tengi-tákn í neðri tækjastikunni sýnir báða þjónana sem tengda.

OpenAI Codex

1. Gakktu úr skugga um að Codex CLI sé uppsett:

   npm install -g @openai/codex

2. Opnaðu (eða búðu til) Codex stillingarskrána:

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

3. Bættu við Wink MCP þjónnaskrám:

   ~/.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. Ræstu Codex. Í fyrsta skipti opnar Codex vafraglugga á https://iam.wink.travel.

5. Skráðu þig inn í Wink og samþykktu beiðnar heimildir.

6. Codex staðfestir tenginguna. Keyrðu codex og biððu um lista yfir tiltæk tól til að staðfesta að Wink þjónarnir séu virkir.

Note

Codex CLI MCP stuðningur krefst útgáfu 1.0 eða nýrri. Keyrðu codex --version til að athuga og npm install -g @openai/codex til að uppfæra.

ChatGPT

Stuðningur við MCP þjónustu er í boði í ChatGPT skjáborðsforritinu fyrir Plus, Pro, Team og Enterprise áskrifendur.

1. Sæktu og settu upp ChatGPT skjáborðsforritið ef þú hefur ekki gert það.

2. Opnaðu forritið og smelltu á prófílmyndina þína efst til hægri, veldu svo Stillingar.

3. Farðu í Tengla (eða MCP Servers eftir útgáfu) og smelltu á Bæta við.

4. Sláðu inn URL fyrir Wink Inventory þjóninn:

   https://api.wink.travel/mcp

   Smelltu svo á Tengja.

5. ChatGPT opnar vafraglugga á https://iam.wink.travel. Skráðu þig inn í Wink og samþykktu heimildir.

6. Endurtaktu skref 4–5 fyrir Integrations þjóninn:

   https://integrations.wink.travel/mcp

7. Báðir þjónar birtast í tenglalistanum þínum. Byrjaðu nýtt spjall — Wink tól eru sjálfkrafa tiltæk.

Takmörkun vefforrits

MCP þjónar eru aðeins stillanlegir í skjáborðsforriti. ChatGPT vefviðmótið á chatgpt.com styður ekki sérsniðna MCP þjónustu.

Cursor

1. Opnaðu (eða búðu til) Cursor MCP stillingarskrána:

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

2. Bættu við Wink MCP þjónnaskrám:

   ~/.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. Opnaðu Cursor. Farðu í Stillingar → Cursor Stillingar → MCP og staðfestu að báðir þjónar birtist með grænum stöðutákni. Ef þeir eru rauðir, smelltu á Endurnýja.

4. Cursor opnar vafraglugga á https://iam.wink.travel. Skráðu þig inn í Wink og samþykktu heimildir.

5. Opnaðu spjall (Ctrl+L / Cmd+L) og biððu Cursor um að sýna tiltæk Wink tól til að staðfesta tenginguna.

Verkefnastilling

Þú getur líka sett mcp.json skrá í rót verkefnisins í staðinn fyrir í ~/.cursor/. Verkefnastilling hefur forgang og gerir þjónana aðgengilega fyrir alla liðsmenn sem opna verkefnið í Cursor.

Windsurf

1. Opnaðu (eða búðu til) Windsurf MCP stillingarskrána:

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

2. Bættu við Wink MCP þjónnaskrám:

   ~/.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. Endurræstu Windsurf alveg (Skrá → Hætta, opnaðu svo aftur).

4. Farðu í Stillingar → MCP Servers og staðfestu að báðir þjónar sýni sem tengdir. Windsurf opnar vafraglugga á https://iam.wink.travel í fyrsta skipti.

5. Skráðu þig inn í Wink og samþykktu heimildir. Þjónarnir verða grænir í stillingum þegar auðkenning er staðfest.

Note

Windsurf MCP stuðningur krefst útgáfu 1.4 eða nýrri. Athugaðu í Hjálp → Um Windsurf og uppfærðu af Windsurf vefsíðunni ef þörf er á.

Cline (VS Code)

Cline er VS Code viðbót með innbyggðum MCP þjónastjóra. Engin handvirk JSON breyting er nauðsynleg.

1. Settu upp Cline úr VS Code Marketplace:

   • Opnaðu VS Code og ýttu á Ctrl+Shift+X / Cmd+Shift+X
   • Leitaðu að Cline og smelltu á Setja upp

2. Smelltu á Cline táknið í Activity Bar (vinstri hliðarstiku) til að opna Cline gluggann.

3. Smelltu á MCP Servers táknið (tengi-tákn) í Cline tækjastikunni, veldu svo Breyta MCP Stillingum.

4. VS Code opnar cline_mcp_settings.json. Bættu við Wink færslunum:

   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. Vistaðu skrána. Cline hleður aftur sjálfkrafa og opnar vafraglugga á https://iam.wink.travel.

6. Skráðu þig inn í Wink og samþykktu heimildir. Báðir þjónar birtast sem virkir í MCP Servers glugganum.

Annað: bættu við með URL

Í MCP Servers glugganum, smelltu á Bæta við þjón og límdu https://api.wink.travel/mcp beint inn. Cline fyllir sjálfkrafa út stillingarnar og sér um auðkenningu án handvirkrar JSON breytingar.

---

Heimildir

Þegar þú samþykkir samþykkisskjáinn sérðu sundurliðun á því sem umboðsmaðurinn biður um. MCP viðskiptavinir nota sama heimildamál og restin af vettvangnum — sjá fulla heimildaskráningu á Auðkenningarsíðu.

Tveir hlutir eru sértækir fyrir MCP:

• mcp.read mcp.write mcp.remove heimildir eru aukalega nauðsynlegar til að opna MCP flutninginn. Viðskiptavinur með mcp.* heimild fær aðgang að /mcp, en hvert tól sem hann kallar krefst samt viðeigandi hlutaheimildar endapunktsins sem það umlykur (t.d. booking.read).
• AI viðskiptavinurinn biður aðeins um þær heimildir sem hann þarf. Þú getur neitað einstökum heimildum á samþykkisskjánum — tól sem krefjast neitaðrar heimildar skila villu þegar þau eru kölluð.

---

Villuleit

Vafragluggi opnast ekki

AI viðskiptavinurinn þinn styður kannski ekki enn gagnvirka PKCE flæðið. Staðfestu að þú sért með nýjustu útgáfu:

• Claude Code: npm install -g @anthropic-ai/claude-code
• Codex CLI: npm install -g @openai/codex
• Claude Desktop / ChatGPT skjáborð: uppfærðu með innbyggðum uppfærslutæki appsins

401 Unauthorized eftir innskráningu

Gæti verið að vistað tákn sé úrelt. Fjarlægðu og bættu þjóninum aftur til að kveikja á nýrri innskráningu:

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

Fyrir Claude Desktop og ChatGPT, fjarlægðu þjónninn úr stillingum, ræstu forritið aftur og bættu honum svo við.

403 Forbidden þegar kallað er á ákveðið tól

Tólið krefst heimildar sem þú hafðir ekki samþykkt á samþykkisskjánum. Tengdu þjóninn aftur — samþykkisskjárinn birtist á ný og þú getur samþykkt vantar heimild.

Þjónninn birtist en tól skila “account not found”

Þú ert skráður inn með Wink reikningi sem hefur enga stjórnunareiningu. Farðu á Wink Portal og tryggðu að reikningurinn þinn sé rétt stilltur áður en þú notar MCP þjóninn.

Táknið rennur út miðja lotu

Táknum gilda í 3 klukkustundir. Claude Code og Claude Desktop endurnýja tákn hljóðlega án truflunar. Ef þú færð auðkennisvillur eftir langa bið, sláðu inn nýja skilaboð — viðskiptavinurinn auðkennir sig sjálfkrafa aftur.

Codex CLI sýnir “MCP server unreachable”

Athugaðu að ~/.codex/config.json sé gilt JSON (engin aukakomma) og að "type": "http" sé stillt. Codex krefst HTTP flutnings fyrir fjarþjóna; stdio flutningur er aðeins fyrir staðbundna keyrslu.

ChatGPT “Connectors” valmynd vantar

MCP stuðningur krefst ChatGPT skjáborðsforrits útgáfu 1.2024.352 eða nýrri og virks Plus, Pro, Team eða Enterprise áskriftar. Uppfærðu forritið og staðfestu áætlun í Stillingar → Reikningur.

Cursor þjónn sýnir rauðan / “Failed to connect”

Staðfestu að ~/.cursor/mcp.json sé gilt JSON og innihaldi "type": "http". Farðu svo í Stillingar → Cursor Stillingar → MCP og smelltu á Endurnýja. Ef villan heldur áfram, endurræstu Cursor alveg — breytingar á stillingum ná ekki alltaf fram án endurræsingar.

Windsurf MCP þjónar birtast ekki í stillingum

Windsurf krefst fullrar endurræsingar (ekki bara gluggahleðslu) til að taka breytingar á mcp_config.json gildar. Notaðu Skrá → Hætta og ræstu aftur. Ef þjónar birtast ekki, staðfestu að þú sért með Windsurf 1.4+ í Hjálp → Um Windsurf.

Cline “Add Server” valkostur er ekki sýnilegur

MCP þjónastjóri krefst Cline 2.0 eða nýrri. Opnaðu VS Code Extensions gluggann, finndu Cline og smelltu á Uppfæra ef uppfærsla er í boði. Eftir uppfærslu, endurhlaða VS Code (Ctrl+Shift+P → “Developer: Reload Window”).

---

Opna Wink Portal Wink á GitHub