MCP-servere

Wink tilbyr to autentiserte MCP-servere. Begge bruker interaktiv OAuth2-pålogging (PKCE autorisasjonskodeflyt) — AI-agenten din åpner en nettleserfane slik at du kan logge inn med Wink-kontoen din. Ingen klienthemmeligheter å håndtere.

Server	URL	Hva den gjør
Inventory API	https://api.wink.travel/mcp	Inventar, bestillinger, priser, salgskanaler, analyser og alle plattformoperasjoner
Integrations	https://integrations.wink.travel/mcp	Kanalintegrasjoner — synkroniser eiendommer, priser og tilgjengelighet med OTA-er

---

Hvordan autentisering fungerer

Wink MCP-servere bruker OAuth2 Authorization Code + PKCE-flyten og støtter Dynamic Client Registration (RFC 7591). Slik går det når du kobler til for første gang:

1. AI-klienten din oppdager autorisasjonsserveren fra MCP-endepunktets /.well-known/oauth-protected-resource metadata.
2. Klienten registrerer seg selv via Dynamic Client Registration — ingen manuell applikasjonsoppsett kreves.
3. Klienten åpner en nettleserfane til https://iam.wink.travel. Du logger inn med Wink-kontoen din og godkjenner de forespurte tillatelsene på samtykkeskjermen.
4. Wink utsteder en tilgangstoken som er knyttet til kontoen din og identiteten din.
5. AI-klienten legger tokenet ved hver MCP-forespørsel. Alle verktøyresultater er automatisk begrenset til din administrerende enhet.
6. Tokenene utløper etter 3 timer. AI-klienten din oppdaterer dem stille i bakgrunnen uten ny pålogging.

Hver verktøysforespørsel kjøres under din identitet — de samme ACL-reglene som beskytter nettportalen gjelder for AI-agenten.

---

Koble til AI-klienten din

Claude Code

1. Sørg for at Claude Code er oppdatert:

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

2. Legg til Wink Inventory MCP-serveren:

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

3. Claude Code kontakter serveren, oppdager autorisasjonsserveren og åpner standard nettleser.

4. Logg inn på Wink og godkjenn tillatelsesforespørselen på samtykkeskjermen.

5. Claude Code bekrefter tilkoblingen. Skriv /mcp for å verifisere at serveren vises og at verktøyene er lastet.

For å legge til Integrations-serveren også:

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

Del med teamet ditt

Legg til --scope project til claude mcp add og Claude Code skriver server-URL-en til .mcp.json i rotmappen for repoet. Committ denne filen — hver teammedlem fullfører sin egen nettleserpålogging første gang de kobler til.

Claude Desktop

1. Rediger Claude Desktop-konfigurasjonsfilen:

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

2. Legg til MCP-serveroppføringene:

   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. Avslutt Claude Desktop helt og start på nytt (bruk Avslutt fra menylinjen — det er ikke nok å bare lukke vinduet).

4. Claude Desktop åpner en nettleserfane for hver ny server. Logg inn på Wink og godkjenn tillatelser.

5. Pluggikonet i bunnverktøylinjen viser begge serverne som tilkoblet.

OpenAI Codex

1. Sørg for at Codex CLI er installert:

   npm install -g @openai/codex

2. Åpne (eller opprett) Codex-konfigurasjonsfilen:

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

3. Legg til Wink MCP-serveroppføringene:

   ~/.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 bruk åpner Codex en nettleserfane til https://iam.wink.travel.

5. Logg inn på Wink og godkjenn de forespurte tillatelsene.

6. Codex bekrefter tilkoblingen. Kjør codex og be den liste tilgjengelige verktøy for å verifisere at Wink-serverne er aktive.

Note

Codex CLI MCP-støtte krever versjon 1.0 eller nyere. Kjør codex --version for å sjekke, og npm install -g @openai/codex for å oppgradere.

ChatGPT

MCP-serverstøtte er tilgjengelig i ChatGPT desktop-appen for Plus, Pro, Team og Enterprise-abonnenter.

1. Last ned og installer ChatGPT desktop-appen hvis du ikke allerede har den.

2. Åpne appen og klikk på profilikonet ditt øverst til høyre, velg deretter Innstillinger.

3. Gå til Connectors (eller MCP Servers avhengig av appversjon) og klikk Legg til.

4. Skriv inn Wink Inventory-serverens URL:

   https://api.wink.travel/mcp

   Klikk deretter Koble til.

5. ChatGPT åpner en nettleserfane til https://iam.wink.travel. Logg inn på Wink og godkjenn tillatelser.

6. Gjenta trinn 4–5 for Integrations-serveren:

   https://integrations.wink.travel/mcp

7. Begge serverne vises i listen over Connectors. Start en ny chat — Wink-verktøyene er tilgjengelige automatisk.

Begrensning i nettapp

MCP-servere kan kun konfigureres i desktop-appen. ChatGPT-nettgrensesnittet på chatgpt.com støtter ikke tilpassede MCP-servere.

Cursor

1. Åpne (eller opprett) Cursor MCP-konfigurasjonsfilen:

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

2. Legg til Wink MCP-serveroppføringene:

   ~/.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. Åpne Cursor. Gå til Innstillinger → Cursor Settings → MCP og bekreft at begge serverne vises med grønn statusindikator. Hvis de vises røde, klikk Oppdater.

4. Cursor åpner en nettleserfane til https://iam.wink.travel. Logg inn på Wink og godkjenn tillatelser.

5. Åpne en chat (Ctrl+L / Cmd+L) og be Cursor liste tilgjengelige Wink-verktøy for å bekrefte tilkoblingen.

Prosjektspesifikk konfigurasjon

Du kan også plassere en mcp.json-fil i rotmappen til prosjektet ditt i stedet for i ~/.cursor/. Prosjektnivå-konfigurasjon har prioritet og gjør serverne tilgjengelige for alle teammedlemmer som åpner prosjektet i Cursor.

Windsurf

1. Åpne (eller opprett) Windsurf MCP-konfigurasjonsfilen:

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

2. Legg til Wink MCP-serveroppføringene:

   ~/.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. Start Windsurf helt på nytt (Fil → Avslutt, og åpne på nytt).

4. Gå til Innstillinger → MCP Servers og bekreft at begge serverne vises som tilkoblet. Windsurf åpner en nettleserfane til https://iam.wink.travel ved første bruk.

5. Logg inn på Wink og godkjenn tillatelser. Serverne blir grønne i innstillingspanelet når de er autentisert.

Note

Windsurf MCP-støtte krever versjon 1.4 eller nyere. Sjekk via Hjelp → Om Windsurf og oppdater fra Windsurf-nettstedet om nødvendig.

Cline (VS Code)

Cline er en VS Code-utvidelse med innebygd MCP-serverbehandler. Ingen manuell JSON-redigering kreves.

1. Installer Cline fra VS Code Marketplace:

   • Åpne VS Code og trykk Ctrl+Shift+X / Cmd+Shift+X
   • Søk etter Cline og klikk Installer

2. Klikk på Cline-ikonet i aktivitetslinjen (venstre sidepanel) for å åpne Cline-panelet.

3. Klikk på MCP Servers-ikonet (pluggikonet) i Cline-verktøylinjen, velg deretter Edit MCP Settings.

4. VS Code åpner cline_mcp_settings.json. Legg til Wink-oppføringene:

   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. Lagre filen. Cline laster inn på nytt og åpner en nettleserfane til https://iam.wink.travel.

6. Logg inn på Wink og godkjenn tillatelser. Begge serverne vises som aktive i MCP Servers-panelet.

Alternativ: legg til via URL

I MCP Servers-panelet klikker du Add Server og limer inn https://api.wink.travel/mcp direkte. Cline fyller automatisk ut konfigurasjonen og håndterer autentisering uten manuell JSON-redigering.

---

Scopes

Når du godkjenner samtykkeskjermen vil du se en oversikt over hva agenten ber om. MCP-klienter bruker samme tillatelsesvokabular som resten av plattformen — se full scope-referanse på Autentiseringssiden.

To ting er spesifikke for MCP:

• mcp.read mcp.write mcp.remove scopes kreves i tillegg for å åpne MCP-transporten. En klient med mcp.* scope får tilgang til /mcp, men hvert verktøy den kaller håndhever fortsatt seksjonsscope for endepunktet det omslutter (f.eks. booking.read).
• AI-klienten ber kun om de scopes den trenger. Du kan nekte individuelle tillatelser på samtykkeskjermen — verktøy som krever en nektet scope vil returnere en feil ved kall.

---

Feilsøking

Nettleserfane åpnes ikke

AI-klienten din støtter kanskje ikke den interaktive PKCE-flyten ennå. Sjekk at du kjører en oppdatert versjon:

• Claude Code: npm install -g @anthropic-ai/claude-code
• Codex CLI: npm install -g @openai/codex
• Claude Desktop / ChatGPT desktop: oppdater via appens innebygde oppdaterer

401 Unauthorized etter pålogging

Den bufrede tokenen din kan være utdatert. Fjern og legg til serveren på nytt for å utløse ny pålogging:

# 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 serveroppføringen i innstillinger, start appen på nytt og legg den til igjen.

403 Forbidden ved kall til spesifikt verktøy

Verktøyet krever en scope du ikke godkjente på samtykkeskjermen. Koble til serveren på nytt — samtykkeskjermen vises igjen og du kan godkjenne manglende tillatelse.

Serveren vises, men verktøykall returnerer “account not found”

Du er logget inn på en Wink-konto uten administrerende enhet. Gå til Wink Portal og sørg for at kontoen din er satt opp før du bruker MCP-serveren.

Token utløper midt i økten

Token er gyldige i 3 timer. Claude Code og Claude Desktop oppdaterer token stille uten å avbryte økten. Hvis du får autentiseringsfeil etter lang inaktivitet, skriv en ny melding — klienten autentiserer automatisk på nytt.

Codex CLI viser “MCP server unreachable”

Sjekk at ~/.codex/config.json er gyldig JSON (ingen avsluttende komma) og at "type": "http" er satt. Codex krever HTTP-transport for eksterne servere; stdio-transport er kun for lokale binærfiler.

ChatGPT “Connectors”-meny mangler

MCP-støtte krever ChatGPT desktop-app versjon 1.2024.352 eller nyere og et aktivt Plus, Pro, Team eller Enterprise-abonnement. Oppdater appen og sjekk planen din under Innstillinger → Konto.

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

Sjekk at ~/.cursor/mcp.json er gyldig JSON og inneholder "type": "http". Gå deretter til Innstillinger → Cursor Settings → MCP og klikk Oppdater. Hvis feilen vedvarer, start Cursor helt på nytt — konfigurasjonsendringer fanges ikke alltid opp uten omstart.

Windsurf MCP-servere vises ikke i innstillinger

Windsurf krever full omstart (ikke bare vindusoppdatering) for å hente endringer i mcp_config.json. Bruk Fil → Avslutt og start på nytt. Hvis serverne fortsatt ikke vises, bekreft at du har Windsurf 1.4+ via Hjelp → Om Windsurf.

Cline “Add Server”-alternativet er ikke synlig

MCP-serverbehandleren krever Cline 2.0 eller nyere. Åpne VS Code Extensions-panelet, finn Cline og klikk Oppdater hvis tilgjengelig. Etter oppdatering, last inn VS Code på nytt (Ctrl+Shift+P → “Developer: Reload Window”).

---

Åpne Wink Portal Wink på GitHub