MCP-servers

Wink biedt twee geauthenticeerde MCP-servers aan. Beide gebruiken interactieve OAuth2-login (PKCE autorisatiecode-flow) — je AI-agent opent een browsertab zodat je kunt inloggen met je Wink-account. Geen client secrets om te beheren.

Server	URL	Wat het doet
Inventory API	https://api.wink.travel/mcp	Inventaris, boekingen, tarieven, verkoopkanalen, analytics en alle platformoperaties
Integrations	https://integrations.wink.travel/mcp	Channel manager-integraties — synchroniseer accommodaties, tarieven en beschikbaarheid met OTA’s

---

Hoe authenticatie werkt

Wink MCP-servers gebruiken de OAuth2 Authorization Code + PKCE flow en ondersteunen Dynamic Client Registration (RFC 7591). Dit gebeurt wanneer je voor het eerst verbinding maakt:

1. Je AI-client ontdekt de autorisatieserver via de /.well-known/oauth-protected-resource metadata van het MCP-endpoint.
2. De client registreert zichzelf via Dynamic Client Registration — geen handmatige applicatieconfiguratie nodig.
3. De client opent een browsertab naar https://iam.wink.travel. Je logt in met je Wink-account en keurt de gevraagde machtigingen goed op het toestemmingsscherm.
4. Wink geeft een access token uit dat is gekoppeld aan je account en identiteit.
5. De AI-client voegt het token toe aan elk MCP-verzoek. Alle toolresultaten zijn automatisch gescopeerd op jouw beheersentiteit.
6. Tokens verlopen na 3 uur. Je AI-client vernieuwt deze stil op de achtergrond zonder opnieuw te vragen.

Elke tool-aanroep verloopt onder jouw identiteit — dezelfde ACL-regels die het webportaal beschermen gelden ook voor de AI-agent.

---

Verbind je AI-client

Claude Code

1. Zorg dat Claude Code up-to-date is:

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

2. Voeg de Wink Inventory MCP-server toe:

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

3. Claude Code neemt contact op met de server, ontdekt de autorisatieserver en opent je standaardbrowser.

4. Log in bij Wink en keur de machtigingsaanvraag goed op het toestemmingsscherm.

5. Claude Code bevestigt de verbinding. Typ /mcp om te controleren of de server verschijnt en de tools geladen zijn.

Om ook de Integrations-server toe te voegen:

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

Deel met je team

Voeg --scope project toe aan claude mcp add en Claude Code schrijft de server-URL naar .mcp.json in de root van de repo. Commit dat bestand — elk teamlid voltooit de eigen browser-login bij de eerste verbinding.

Claude Desktop

1. Bewerk het configuratiebestand van 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. Voeg de MCP-serververmeldingen toe:

   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. Sluit Claude Desktop volledig af en start opnieuw op (gebruik Quit in de menubalk — alleen het venster sluiten is niet genoeg).

4. Claude Desktop opent een browsertab voor elke nieuwe server. Log in bij Wink en keur de machtigingen goed.

5. Het stekker-icoon in de onderste werkbalk toont beide servers als verbonden.

OpenAI Codex

1. Zorg dat Codex CLI is geïnstalleerd:

   npm install -g @openai/codex

2. Open (of maak aan) het Codex-configuratiebestand:

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

3. Voeg de Wink MCP-serververmeldingen toe:

   ~/.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. Bij het eerste gebruik opent Codex een browsertab naar https://iam.wink.travel.

5. Log in bij Wink en keur de gevraagde machtigingen goed.

6. Codex bevestigt de verbinding. Voer codex uit en vraag om een lijst met beschikbare tools om te controleren of de Wink-servers actief zijn.

Opmerking

Codex CLI MCP-ondersteuning vereist versie 1.0 of hoger. Controleer met codex --version en update met npm install -g @openai/codex.

ChatGPT

MCP-serverondersteuning is beschikbaar in de ChatGPT desktop-app voor Plus-, Pro-, Team- en Enterprise-abonnees.

1. Download en installeer de ChatGPT desktop-app als je dat nog niet hebt gedaan.

2. Open de app en klik op je profielicoon rechtsboven, kies vervolgens Instellingen.

3. Ga naar Connectors (of MCP Servers, afhankelijk van je app-versie) en klik op Toevoegen.

4. Voer de Wink Inventory-server-URL in:

   https://api.wink.travel/mcp

   Klik daarna op Verbinden.

5. ChatGPT opent een browsertab naar https://iam.wink.travel. Log in bij Wink en keur de machtigingen goed.

6. Herhaal stap 4–5 voor de Integrations-server:

   https://integrations.wink.travel/mcp

7. Beide servers verschijnen in je Connectors-lijst. Begin een nieuw gesprek — Wink-tools zijn automatisch beschikbaar.

Beperking webapp

MCP-servers zijn alleen configureerbaar in de desktop-app. De ChatGPT-webinterface op chatgpt.com ondersteunt geen aangepaste MCP-servers.

Cursor

1. Open (of maak aan) het Cursor MCP-configuratiebestand:

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

2. Voeg de Wink MCP-serververmeldingen toe:

   ~/.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. Open Cursor. Ga naar Instellingen → Cursor-instellingen → MCP en controleer of beide servers met een groene statusindicator verschijnen. Als ze rood zijn, klik op Vernieuwen.

4. Cursor opent een browsertab naar https://iam.wink.travel. Log in bij Wink en keur de machtigingen goed.

5. Open een chat (Ctrl+L / Cmd+L) en vraag Cursor om beschikbare Wink-tools te tonen om de verbinding te bevestigen.

Project-gescopeerde configuratie

Je kunt ook een mcp.json bestand in de root van je project plaatsen in plaats van in ~/.cursor/. Projectconfiguratie heeft voorrang en maakt de servers beschikbaar voor elk teamlid dat het project in Cursor opent.

Windsurf

1. Open (of maak aan) het Windsurf MCP-configuratiebestand:

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

2. Voeg de Wink MCP-serververmeldingen toe:

   ~/.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 volledig opnieuw op (Bestand → Afsluiten, daarna opnieuw openen).

4. Ga naar Instellingen → MCP Servers en controleer of beide servers als verbonden worden weergegeven. Windsurf opent bij eerste gebruik een browsertab naar https://iam.wink.travel.

5. Log in bij Wink en keur de machtigingen goed. De servers worden groen in het instellingenpaneel zodra ze geauthenticeerd zijn.

Opmerking

Windsurf MCP-ondersteuning vereist versie 1.4 of hoger. Controleer via Help → Over Windsurf en update indien nodig via de Windsurf-website.

Cline (VS Code)

Cline is een VS Code-extensie met een ingebouwde MCP-serverbeheerder. Handmatig JSON-bewerken is niet nodig.

1. Installeer Cline vanuit de VS Code Marketplace:

   • Open VS Code en druk op Ctrl+Shift+X / Cmd+Shift+X
   • Zoek op Cline en klik op Installeren

2. Klik op het Cline-icoon in de Activiteitenbalk (linkerzijbalk) om het Cline-paneel te openen.

3. Klik op het MCP Servers-icoon (stekker-icoon) in de Cline-werkbalk en kies MCP-instellingen bewerken.

4. VS Code opent cline_mcp_settings.json. Voeg de Wink-vermeldingen toe:

   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. Sla het bestand op. Cline herlaadt automatisch en opent een browsertab naar https://iam.wink.travel.

6. Log in bij Wink en keur de machtigingen goed. Beide servers verschijnen als actief in het MCP Servers-paneel.

Alternatief: toevoegen via URL

Klik in het MCP Servers-paneel op Server toevoegen en plak direct https://api.wink.travel/mcp. Cline vult de configuratie automatisch in en regelt authenticatie zonder handmatig JSON te bewerken.

---

Scopes

Wanneer je het toestemmingsscherm goedkeurt, zie je een overzicht van wat de agent aanvraagt. MCP-clients gebruiken dezelfde permissieterminologie als de rest van het platform — zie de volledige scope-referentie op de Authenticatiepagina.

Twee zaken zijn specifiek voor MCP:

• De scopes mcp.read, mcp.write en mcp.remove zijn aanvullend vereist om de MCP-transportlaag te openen. Een client met een mcp.* scope krijgt toegang tot /mcp, maar elke tool die wordt aangeroepen handhaaft nog steeds de sectiescope van het betreffende endpoint (bijv. booking.read).
• De AI-client vraagt alleen de scopes aan die nodig zijn. Je kunt individuele permissies weigeren op het toestemmingsscherm — tools die een geweigerde scope vereisen geven een foutmelding bij gebruik.

---

Problemen oplossen

Browsertab opent niet

Je AI-client ondersteunt mogelijk de interactieve PKCE-flow nog niet. Controleer of je een recente versie gebruikt:

• Claude Code: npm install -g @anthropic-ai/claude-code
• Codex CLI: npm install -g @openai/codex
• Claude Desktop / ChatGPT desktop: update via de ingebouwde updater van de app

401 Unauthorized na inloggen

Je opgeslagen token is mogelijk verlopen. Verwijder en voeg de server opnieuw toe om een verse login te forceren:

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

Voor Claude Desktop en ChatGPT, verwijder de server uit de instellingen, herstart de app en voeg hem opnieuw toe.

403 Forbidden bij aanroepen van een specifieke tool

De tool vereist een scope die je niet hebt goedgekeurd op het toestemmingsscherm. Verbind de server opnieuw — het toestemmingsscherm verschijnt weer en je kunt de ontbrekende permissie goedkeuren.

De server verschijnt maar tool-aanroepen geven “account niet gevonden”

Je bent ingelogd met een Wink-account zonder beheersentiteit. Ga naar Wink Portal en zorg dat je account correct is ingesteld voordat je de MCP-server gebruikt.

Token verloopt midden in een sessie

Tokens zijn 3 uur geldig. Claude Code en Claude Desktop vernieuwen tokens stil zonder je sessie te onderbreken. Zie je authenticatiefouten na lange inactiviteit, typ dan een nieuw bericht — de client herauthenticeert automatisch.

Codex CLI toont “MCP server unreachable”

Controleer of je ~/.codex/config.json geldige JSON is (geen trailing commas) en dat "type": "http" is ingesteld. Codex vereist HTTP-transport voor remote servers; stdio-transport is alleen voor lokale binaries.

ChatGPT “Connectors”-menu ontbreekt

MCP-ondersteuning vereist ChatGPT desktop-app versie 1.2024.352 of hoger en een actief Plus-, Pro-, Team- of Enterprise-abonnement. Update de app en controleer je abonnement via Instellingen → Account.

Cursor-server toont rood / “Failed to connect”

Controleer of je ~/.cursor/mcp.json geldige JSON bevat met "type": "http". Ga daarna naar Instellingen → Cursor-instellingen → MCP en klik op Vernieuwen. Blijft de fout, start Cursor volledig opnieuw op — configuratiewijzigingen worden niet altijd opgepikt zonder herstart.

Windsurf MCP-servers niet zichtbaar in instellingen

Windsurf vereist een volledige herstart (niet alleen venster herladen) om wijzigingen in mcp_config.json te detecteren. Gebruik Bestand → Afsluiten en start opnieuw. Verschijnen de servers nog niet, controleer of je Windsurf 1.4+ gebruikt via Help → Over Windsurf.

Cline “Server toevoegen”-optie niet zichtbaar

De MCP-serverbeheerder vereist Cline 2.0 of hoger. Open het VS Code Extensies-paneel, zoek Cline en klik op Bijwerken als er een update beschikbaar is. Herlaad daarna VS Code (Ctrl+Shift+P → “Developer: Reload Window”).

---

Open Wink Portal Wink op GitHub