MCP-servere

Wink udstiller to godkendte MCP-servere. Begge bruger interaktiv OAuth2-login (PKCE autorisationskode-flow) — din AI-agent åbner en browsertab, så du kan logge ind med din Wink-konto. Ingen klienthemmeligheder at administrere.

Server	URL	Hvad den gør
Inventory API	https://api.wink.travel/mcp	Lager, bookinger, priser, salgskanaler, analyser og alle platformoperationer
Integrations	https://integrations.wink.travel/mcp	Channel manager-integrationer — synkroniser ejendomme, priser og tilgængelighed med OTA’er

---

Sådan fungerer autentificering

Wink MCP-servere bruger OAuth2 Authorization Code + PKCE flow og understøtter Dynamic Client Registration (RFC 7591). Sådan foregår det, når du forbinder første gang:

1. Din AI-klient finder autorisationsserveren via MCP-endpointets /.well-known/oauth-protected-resource metadata.
2. Klienten registrerer sig selv via Dynamic Client Registration — ingen manuel applikationsopsætning nødvendig.
3. Klienten åbner en browsertab til https://iam.wink.travel. Du logger ind med din Wink-konto og godkender de ønskede tilladelser på samtykkeskærmen.
4. Wink udsteder et access token knyttet til din konto og identitet.
5. AI-klienten vedhæfter token til alle MCP-forespørgsler. Alle værktøjsresultater er automatisk begrænset til din administrerende enhed.
6. Tokens udløber efter 3 timer. Din AI-klient opdaterer stille i baggrunden uden at bede om login igen.

Hver værktøjskald kører under din identitet — de samme ACL-regler, der beskytter webportalen, gælder for AI-agenten.

---

Forbind din AI-klient

Claude Code

1. Sørg for, at Claude Code er opdateret:

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

2. Tilføj Wink Inventory MCP-serveren:

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

3. Claude Code kontakter serveren, finder autorisationsserveren og åbner din standardbrowser.

4. Log ind på Wink og godkend tilladelsesforespørgslen på samtykkeskærmen.

5. Claude Code bekræfter forbindelsen. Skriv /mcp for at kontrollere, at serveren vises, og at dens værktøjer er indlæst.

For også at tilføje Integrations-serveren:

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

Del med dit team

Tilføj --scope project til claude mcp add, og Claude Code skriver server-URL’en til .mcp.json i rodmappen af dit repo. Commit den fil — hver teammedlem gennemfører deres egen browser-login første gang, de forbinder.

Claude Desktop

1. Rediger Claude Desktop konfigurationsfil:

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

2. Tilføj MCP-serveropslagene:

   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. Afslut helt og genstart Claude Desktop (brug Quit i menulinjen — det er ikke nok bare at lukke vinduet).

4. Claude Desktop åbner en browsertab for hver ny server. Log ind på Wink og godkend tilladelser.

5. Stik-ikonet i bundværktøjslinjen viser begge servere som forbundet.

OpenAI Codex

1. Sørg for, at Codex CLI er installeret:

   npm install -g @openai/codex

2. Åbn (eller opret) Codex konfigurationsfilen:

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

3. Tilføj Wink MCP-serveropslagene:

   ~/.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. Start Codex. Ved første brug åbner Codex en browsertab til https://iam.wink.travel.

5. Log ind på Wink og godkend de ønskede tilladelser.

6. Codex bekræfter forbindelsen. Kør codex og bed den liste tilgængelige værktøjer for at bekræfte, at Wink-serverne er aktive.

Note

Codex CLI MCP-support kræver version 1.0 eller nyere. Kør codex --version for at tjekke, og npm install -g @openai/codex for at opgradere.

ChatGPT

MCP-serverunderstøttelse findes i ChatGPT desktop-appen for Plus, Pro, Team og Enterprise-abonnenter.

1. Download og installer ChatGPT desktop-appen, hvis du ikke allerede har den.

2. Åbn appen og klik på dit profilikon øverst til højre, vælg derefter Indstillinger.

3. Gå til Connectors (eller MCP Servers afhængigt af din app-version) og klik på Tilføj.

4. Indtast Wink Inventory-serverens URL:

   https://api.wink.travel/mcp

   Klik derefter på Forbind.

5. ChatGPT åbner en browsertab til https://iam.wink.travel. Log ind på Wink og godkend tilladelser.

6. Gentag trin 4–5 for Integrations-serveren:

   https://integrations.wink.travel/mcp

7. Begge servere vises i din Connectors-liste. Start en ny chat — Wink-værktøjer er tilgængelige automatisk.

Begrænsning i webapp

MCP-servere kan kun konfigureres i desktop-appen. ChatGPT-webgrænsefladen på chatgpt.com understøtter ikke brugerdefinerede MCP-servere.

Cursor

1. Åbn (eller opret) Cursor MCP-konfigurationsfilen:

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

2. Tilføj Wink MCP-serveropslagene:

   ~/.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. Åbn Cursor. Gå til Indstillinger → Cursor-indstillinger → MCP og bekræft, at begge servere vises med grøn statusindikator. Hvis de er røde, klik på Opdater.

4. Cursor åbner en browsertab til https://iam.wink.travel. Log ind på Wink og godkend tilladelser.

5. Åbn en chat (Ctrl+L / Cmd+L) og bed Cursor liste tilgængelige Wink-værktøjer for at bekræfte forbindelsen.

Projekt-specifik konfiguration

Du kan også placere en mcp.json-fil i roden af dit projekt i stedet for i ~/.cursor/. Projektkonfiguration har forrang og gør serverne tilgængelige for alle teammedlemmer, der åbner projektet i Cursor.

Windsurf

1. Åbn (eller opret) Windsurf MCP-konfigurationsfilen:

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

2. Tilføj Wink MCP-serveropslagene:

   ~/.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. Genstart Windsurf helt (Fil → Afslut, og åbn igen).

4. Gå til Indstillinger → MCP Servers og bekræft, at begge servere vises som forbundet. Windsurf åbner en browsertab til https://iam.wink.travel ved første brug.

5. Log ind på Wink og godkend tilladelser. Serverne bliver grønne i indstillingspanelet, når de er godkendt.

Note

Windsurf MCP-support kræver version 1.4 eller nyere. Tjek via Hjælp → Om Windsurf og opdater fra Windsurf-websitet om nødvendigt.

Cline (VS Code)

Cline er en VS Code-udvidelse med indbygget MCP-servermanager. Ingen manuel JSON-redigering er nødvendig.

1. Installer Cline fra VS Code Marketplace:

   • Åbn VS Code og tryk Ctrl+Shift+X / Cmd+Shift+X
   • Søg efter Cline og klik på Installer

2. Klik på Cline-ikonet i aktivitetslinjen (venstre sidebjælke) for at åbne Cline-panelet.

3. Klik på MCP Servers-ikonet (stik-ikon) i Cline-værktøjslinjen, og vælg derefter Rediger MCP-indstillinger.

4. VS Code åbner cline_mcp_settings.json. Tilføj Wink-opslagene:

   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. Gem filen. Cline genindlæses automatisk og åbner en browsertab til https://iam.wink.travel.

6. Log ind på Wink og godkend tilladelser. Begge servere vises som aktive i MCP Servers-panelet.

Alternativ: tilføj via URL

I MCP Servers-panelet klik på Tilføj server og indsæt https://api.wink.travel/mcp direkte. Cline udfylder konfigurationen automatisk og håndterer autentificering uden manuel JSON-redigering.

---

Scopes

Når du godkender samtykkeskærmen, vil du se en oversigt over, hvad agenten anmoder om. MCP-klienter bruger det samme tilladelsesvokabular som resten af platformen — se den fulde scope-reference på Autentificeringssiden.

To ting er specifikke for MCP:

• Scopes mcp.read, mcp.write og mcp.remove er yderligere påkrævet for at åbne MCP-transporten. En klient med et mcp.* scope får adgang til /mcp, men hvert værktøj, den kalder, håndhæver stadig sektionens scope for det endpoint, det omslutter (f.eks. booking.read).
• AI-klienten anmoder kun om de scopes, den har brug for. Du kan afvise individuelle tilladelser på samtykkeskærmen — værktøjer, der kræver et afvist scope, returnerer en fejl ved kald.

---

Fejlfinding

Browsertab åbner ikke

Din AI-klient understøtter muligvis ikke det interaktive PKCE-flow endnu. Tjek, at du kører en nyere version:

• Claude Code: npm install -g @anthropic-ai/claude-code
• Codex CLI: npm install -g @openai/codex
• Claude Desktop / ChatGPT desktop: opdater via appens indbyggede opdatering

401 Unauthorized efter login

Dit cachede token kan være udløbet. Fjern og tilføj serveren igen for at udløse et nyt login:

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

For Claude Desktop og ChatGPT, fjern serveren i indstillinger, genstart appen og tilføj den igen.

403 Forbidden ved kald til et specifikt værktøj

Værktøjet kræver et scope, du ikke godkendte på samtykkeskærmen. Forbind serveren igen — samtykkeskærmen vises igen, og du kan godkende den manglende tilladelse.

Serveren vises, men værktøjskald returnerer “account not found”

Du er logget ind på en Wink-konto uden en administrerende enhed. Gå til Wink Portal og sørg for, at din konto er opsat, før du bruger MCP-serveren.

Token udløber midt i sessionen

Tokens er gyldige i 3 timer. Claude Code og Claude Desktop opdaterer tokens stille uden at afbryde din session. Hvis du ser autentificeringsfejl efter lang inaktivitet, skriv en ny besked — klienten genautentificerer automatisk.

Codex CLI viser “MCP server unreachable”

Tjek, at din ~/.codex/config.json er gyldig JSON (ingen afsluttende kommaer) og at "type": "http" er sat. Codex kræver HTTP-transport for fjernservere; stdio-transport er kun til lokale binærer.

ChatGPT “Connectors”-menu mangler

MCP-support kræver ChatGPT desktop-app version 1.2024.352 eller nyere og et aktivt Plus-, Pro-, Team- eller Enterprise-abonnement. Opdater appen og tjek din plan under Indstillinger → Konto.

Cursor-server viser rød / “Failed to connect”

Tjek, at din ~/.cursor/mcp.json er gyldig JSON og indeholder "type": "http". Gå derefter til Indstillinger → Cursor-indstillinger → MCP og klik på Opdater. Hvis fejlen fortsætter, genstart Cursor helt — konfigurationsændringer opfanges ikke altid uden genstart.

Windsurf MCP-servere vises ikke i indstillinger

Windsurf kræver en fuld genstart (ikke kun genindlæsning af vindue) for at opfange ændringer i mcp_config.json. Brug Fil → Afslut og genstart. Hvis serverne stadig ikke vises, bekræft at du kører Windsurf 1.4+ via Hjælp → Om Windsurf.

Cline “Add Server”-mulighed er ikke synlig

MCP-servermanageren kræver Cline 2.0 eller nyere. Åbn VS Code Extensions-panelet, find Cline, og klik på Opdater, hvis en opdatering er tilgængelig. Efter opdatering, genindlæs VS Code (Ctrl+Shift+P → “Developer: Reload Window”).

---

Åbn Wink Portal Wink på GitHub