MCP-servers
De MCP-tools van Wink worden gepubliceerd als toolsets — gerichte endpoints, elk gericht op één taak. Je verbindt je AI-client met één of twee die bij je werk passen, niet met ze allemaal.
Elk endpoint gebruikt interactieve OAuth2-login (PKCE autorisatiecode-flow): je AI-agent opent een browsertabblad, je logt in met je Wink-account, en dat is het. Geen client secrets om te beheren.
claude mcp add wink-channel-manager https://integrations.wink.travel/mcp/channel-manager --transport httpclaude mcp add wink-rates https://api.wink.travel/mcp/extranet/rates --transport httpWaarom de tools zijn verdeeld over endpoints
Section titled “Waarom de tools zijn verdeeld over endpoints”Wink biedt ongeveer 500 tools aan. Ze allemaal tegelijk aan een agent geven is technisch mogelijk — maar geen goed idee.
Tooldefinities kosten context. Elke tool die een MCP-server aanbiedt, wordt geladen in het contextvenster van het model voordat het werk begint, samen met de beschrijving en het volledige parameterschema. Vijfhonderd van die tools verbruiken een groot deel van het budget dat je daadwerkelijke taak nodig heeft, bij elke aanvraag.
De kwaliteit van keuzes neemt af naarmate de lijst groeit. Een agent die uit 500 vergelijkbaar genaamde tools kiest, maakt slechtere keuzes dan een agent die uit 40 kiest. Als je een channel manager integreert, zijn ongeveer twintig tools relevant voor jou; de andere 480 zijn ruis die het moeilijker maakt om de juiste tool te vinden.
Het werk is echt te scheiden. Iemand die beschikbaarheid synchroniseert vanuit een PMS en iemand die affiliate landingspagina’s samenstelt, delen bijna geen tools. Splitsen per taak betekent dat elke verbinding het vocabulaire van één taak draagt.
Endpoint-directory
Section titled “Endpoint-directory”Twee hosts serveren toolsets. Het aantal tools is bij benadering en groeit in de tijd.
https://api.wink.travel — het platform
Section titled “https://api.wink.travel — het platform”| Endpoint | Tools | Wat het dekt |
|---|---|---|
/mcp/extranet/facilities | ~64 | De boekbare en aanwezige inventaris: gastenkamers en kamertypes, spa’s, restaurants, vergaderruimtes, activiteiten, attracties, locaties, andere verkoopbare items |
/mcp/extranet/property | ~62 | Het eigendomsrecord en de commerciële voorwaarden: profiel en inhoud, extra’s, annuleringsvoorwaarden, voordelen, aankondigingen |
/mcp/settings | ~60 | Accountbeheer: profiel en branding van de beheersentiteit, managers en hun machtigingen, aanpassingen, webhooks, notificatievoorkeuren |
/mcp/studio/embeds | ~48 | Gepubliceerde samengestelde inventaris: widgets, grids en gerangschikte grids, kaarten, kaarten, diepe links naar inventaris- en leverancierspagina’s |
/mcp/extranet/rates | ~44 | Prijzen en beschikbaarheid: inventaris-tariefperiodes en allotments, tariefplannen, hoofdprijzen, speciale en promotietarieven |
/mcp/extranet/operations | ~39 | Het runnen van een live accommodatie: reserveringen en hun levenscyclus, gastbeoordelingen en reacties, kalenderfeeds, geplande taken |
/mcp/extranet/distribution | ~37 | Waar inventaris wordt verkocht: verkoopkanalen en tariefmodifiers, affiliate- en leveranciersrelatieverzoeken, registratie, leadcaptatie |
/mcp/studio/curation | ~35 | Het bouwen van merchandisable collecties: statische en dynamische lijsten, gerangschikte lijsten, opgeslagen zoekopdrachten, eigendomsaggregaten |
/mcp/link-manager | ~28 | Gesyndiceerde linkcollecties, hun ontwerp, categorieën en tags, plus verkorte URL’s |
/mcp/reference | ~24 | Alleen-lezen opzoekgegevens: landen, valuta’s en wisselkoersen, talen, tijdzones, geografische opzoekingen, IP-geolocatie |
/mcp/analytics | ~18 | Boekings- en omzetanalyse: overzichten, lijndiagrammen, ranglijsten, affiliate-prestaties, deelstatistieken |
/mcp/payment | ~18 | Financiële operaties: grootboek, opnames en kostenramingen, boekingsfondsaggregaten |
/mcp/booking-engine | ~17 | Het reizigersgerichte winkelpad: zoeken en opzoeken, winkelwagen en afrekenen, bucketlists, campagne-aanpassing |
/mcp/social | ~17 | Verbonden sociale accounts, publiceren en plannen van berichten, lezen van berichtinzichten |
/mcp/travel-agent | ~8 | Door agent gefaciliteerde boekingen namens reizigers, en agentrapportages |
https://integrations.wink.travel — channel manager-integraties
Section titled “https://integrations.wink.travel — channel manager-integraties”Één endpoint, omdat deze host voor één taak bestaat.
| Endpoint | Tools | Wat het dekt |
|---|---|---|
/mcp/channel-manager | ~9 | Verbinden en verifiëren van een channel manager-, PMS- of CRS-integratie |
Elk endpoint heeft ook een ping-tool, zodat je kunt bevestigen dat een verbinding live is voordat je echt werk vraagt.
Agentic payments
Section titled “Agentic payments”Voor de complete reizigersboekingsflow, verbind Wink Booking Engine op https://api.wink.travel/mcp/booking-engine en een compatibele betalingswallet. Het toevoegen van de Wink MCP opent browser-login en permissiekeuze; je client handelt daarna authenticatie af.
Booking Engine bevat bestemmingsopzoeking, hotel- en kamerzoekopdrachten, agentic_booking_quote, agentic_booking_pay, agentic_booking_book, boekingsopvraging en bonnetjes, wanneer agentic boeken en betalen voor die omgeving zijn ingeschakeld. Zie Agentic Payments voor de verbindingsinstellingen, de te selecteren permissies en de stappen van zoeken tot bevestiging.
Welke toolsets heb ik nodig?
Section titled “Welke toolsets heb ik nodig?”| Als je… | Verbind met |
|---|---|
| Een channel manager, PMS of CRS integreert | integrations.wink.travel/mcp/channel-manager — alleen deze |
| De inhoud van een accommodatie beheert | /mcp/extranet/property + /mcp/extranet/facilities |
| Kamers en kamertypes beheert | /mcp/extranet/facilities |
| Prijzen en beschikbaarheid beheert | /mcp/extranet/rates |
| Dagelijkse reserveringen runt | /mcp/extranet/operations |
| Distributie uitbreidt | /mcp/extranet/distribution + /mcp/analytics |
| Affiliate-pagina’s bouwt | /mcp/studio/curation + /mcp/studio/embeds |
| Link-in-bio-pagina’s runt | /mcp/link-manager + /mcp/social |
| Boekt namens reizigers | /mcp/travel-agent |
| Geld afstemt | /mcp/payment |
| Een kamer boekt met een AI-agent | /mcp/booking-engine + een compatibele betalingswallet — zie Agentic Payments |
| Een boekingservaring bouwt | /mcp/booking-engine; optioneel /mcp/reference voor extra opzoekingen |
Booking Engine bevat de kern van de boekingsworkflow. Het biedt account- en aanpassingsontdekking, bestemmingsopzoeking, hotelbeschikbaarheid en kamerprijsdetails, winkelwagens, afrekenen en reizigersboekingsbeheer. Agentic boekings- en betaaltools zijn ook inbegrepen wanneer ingeschakeld voor die omgeving.
Voor een stad-gebaseerde hotelzoekopdracht gebruik je destination_lookup_search_suggestions om de bestemming te bepalen, daarna inventory_search_city om beschikbare hotels en tarieven te vinden. Beide tools zitten in /mcp/booking-engine, dus deze flow vereist geen Reference-verbinding.
Voeg /mcp/reference toe wanneer je ondersteunende opzoekingen nodig hebt zoals landen, valuta’s en wisselkoersen, ondersteunde talen, tijdzones, bredere geografische zoekopdrachten, OTA-classificaties of publieke accommodatiekennis. Dit zijn optionele aanvullingen op de boekingsflow.
Begin met één. Voeg er een toe als je iets vraagt wat het niet kan — elke verbinding is onafhankelijk, en toevoegen verandert niets aan de anderen.
Hoe authenticatie werkt
Section titled “Hoe authenticatie werkt”Wink MCP-servers gebruiken de OAuth2 Authorization Code + PKCE flow en ondersteunen Dynamic Client Registration (RFC 7591). Dit gebeurt als je voor het eerst verbindt:
- Je AI-client ontdekt de autorisatieserver via de
/.well-known/oauth-protected-resourcemetadata van het MCP-endpoint. - De client registreert zichzelf via Dynamic Client Registration — geen handmatige applicatie-instelling nodig.
- De client opent een browsertabblad naar
https://iam.wink.travel. Je logt in met je Wink-account en keurt de gevraagde permissies goed op het toestemmingsscherm. - Wink geeft een access token uit dat is gescopeerd op je account en gekoppeld aan je identiteit.
- De AI-client voegt het token toe aan elke MCP-aanvraag. Alle toolresultaten zijn automatisch gescopeerd op jouw beheersentiteit.
- Tokens verlopen na 3 uur. Je AI-client vernieuwt stil op de achtergrond zonder opnieuw te vragen.
Elke tool-aanroep draait onder jouw identiteit — dezelfde ACL-regels die het webportaal beschermen, gelden ook voor de AI-agent.
Verbind je AI-client
Section titled “Verbind je AI-client”Voeg elke toolset toe aan Claude als een aangepaste connector. Er is geen configuratiebestand om te bewerken en geen applicatie of secret om aan te maken.
-
Open in Claude Customize › Connectors, klik op Add, dan Add custom connector.
-
Voer een Naam in (bijvoorbeeld Wink Link manager) en als MCP server URL een toolset uit de directory hierboven, bijvoorbeeld:
https://api.wink.travel/mcp/link-managerKlik op Continue.
-
Claude detecteert Wink’s aanmelding. Laat Authentication: Sign in now en OAuth client: Register automatically aanstaan, klik dan op Add.
-
Klik op Connect. Er opent een Wink-aanmeldpagina op
https://iam.wink.travel. Log in bij Wink en keur de permissies goed op het toestemmingsscherm. -
De tools van de connector zijn nu beschikbaar in je chats. Herhaal voor elke toolset die je werk nodig heeft; elke toolset is een eigen connector.
-
Zorg dat Claude Code up-to-date is:
Terminal window npm install -g @anthropic-ai/claude-code -
Kies een toolset uit de directory hierboven en voeg die toe. Bijvoorbeeld prijzen en beschikbaarheid:
Terminal window claude mcp add wink-rates https://api.wink.travel/mcp/extranet/rates --transport http -
Claude Code neemt contact op met de server, ontdekt de autorisatieserver en opent je standaardbrowser.
-
Log in bij Wink en keur de permissieverzoek goed op het toestemmingsscherm.
-
Claude Code bevestigt de verbinding. Typ
/mcpom te controleren of de server verschijnt en de tools geladen zijn.
Voeg zoveel toolsets toe als je werk nodig heeft — elk is een aparte serververmelding met een eigen naam:
claude mcp add wink-operations https://api.wink.travel/mcp/extranet/operations --transport httpclaude mcp add wink-analytics https://api.wink.travel/mcp/analytics --transport httpJe logt maar één keer in. Na de eerste browsergoedkeuring hergebruikt Claude Code je Wink-sessie voor extra Wink-endpoints.
-
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
- macOS:
-
Voeg de MCP-serververmeldingen toe:
claude_desktop_config.json {"mcpServers": {"wink-extranet-rates": {"type": "http","url": "https://api.wink.travel/mcp/extranet/rates"},"wink-extranet-operations": {"type": "http","url": "https://api.wink.travel/mcp/extranet/operations"}}} -
Sluit Claude Desktop volledig af en start opnieuw (gebruik Quit in de menubalk — alleen het venster sluiten is niet genoeg).
-
Claude Desktop opent een browsertabblad voor elke nieuwe server. Log in bij Wink en keur de permissies goed.
-
Het stekker-icoon in de onderste werkbalk toont beide servers als verbonden.
-
Zorg dat Codex CLI is geïnstalleerd:
Terminal window npm install -g @openai/codex -
Open (of maak aan) het Codex-configuratiebestand:
- macOS / Linux:
~/.codex/config.json - Windows:
%USERPROFILE%\.codex\config.json
- macOS / Linux:
-
Voeg de Wink MCP-serververmeldingen toe:
~/.codex/config.json {"mcpServers": {"wink-extranet-rates": {"type": "http","url": "https://api.wink.travel/mcp/extranet/rates"},"wink-extranet-operations": {"type": "http","url": "https://api.wink.travel/mcp/extranet/operations"}}} -
Start Codex. Bij eerste gebruik opent Codex een browsertabblad naar
https://iam.wink.travel. -
Log in bij Wink en keur de gevraagde permissies goed.
-
Codex bevestigt de verbinding. Voer
codexuit en vraag om een lijst met beschikbare tools om te controleren of de Wink-servers actief zijn.
MCP-serverondersteuning is beschikbaar in de ChatGPT desktop-app voor Plus-, Pro-, Team- en Enterprise-abonnees.
-
Download en installeer de ChatGPT desktop-app als je dat nog niet hebt gedaan.
-
Open de app en klik op je profielicoon rechtsboven, kies dan Instellingen.
-
Ga naar Connectors (of MCP Servers, afhankelijk van je app-versie) en klik op Toevoegen.
-
Voer de URL in van een toolset uit de directory hierboven, bijvoorbeeld:
https://api.wink.travel/mcp/extranet/ratesKlik daarna op Connect.
-
ChatGPT opent een browsertabblad naar
https://iam.wink.travel. Log in bij Wink en keur de permissies goed. -
Herhaal stap 4–5 voor elke andere toolset die je werk nodig heeft, bijvoorbeeld:
https://api.wink.travel/mcp/extranet/operations -
Elke toolset verschijnt in je Connectors-lijst. Begin een nieuw gesprek — Wink-tools zijn automatisch beschikbaar.
-
Open (of maak aan) het Cursor MCP-configuratiebestand:
- macOS / Linux:
~/.cursor/mcp.json - Windows:
%USERPROFILE%\.cursor\mcp.json
- macOS / Linux:
-
Voeg de Wink MCP-serververmeldingen toe:
~/.cursor/mcp.json {"mcpServers": {"wink-extranet-rates": {"type": "http","url": "https://api.wink.travel/mcp/extranet/rates"},"wink-extranet-operations": {"type": "http","url": "https://api.wink.travel/mcp/extranet/operations"}}} -
Open Cursor. Ga naar Settings → Cursor Settings → MCP en controleer of beide servers met een groene statusindicator verschijnen. Als ze rood tonen, klik op Refresh.
-
Cursor opent een browsertabblad naar
https://iam.wink.travel. Log in bij Wink en keur de permissies goed. -
Open een chat (
Ctrl+L/Cmd+L) en vraag Cursor om beschikbare Wink-tools te tonen om de verbinding te bevestigen.
-
Open (of maak aan) het Windsurf MCP-configuratiebestand:
- macOS / Linux:
~/.codeium/windsurf/mcp_config.json - Windows:
%USERPROFILE%\.codeium\windsurf\mcp_config.json
- macOS / Linux:
-
Voeg de Wink MCP-serververmeldingen toe:
~/.codeium/windsurf/mcp_config.json {"mcpServers": {"wink-extranet-rates": {"type": "http","url": "https://api.wink.travel/mcp/extranet/rates"},"wink-extranet-operations": {"type": "http","url": "https://api.wink.travel/mcp/extranet/operations"}}} -
Start Windsurf volledig opnieuw op (Bestand → Afsluiten, dan opnieuw openen).
-
Ga naar Instellingen → MCP Servers en controleer of beide servers als verbonden worden weergegeven. Windsurf opent bij eerste gebruik een browsertabblad naar
https://iam.wink.travel. -
Log in bij Wink en keur de permissies goed. De servers worden groen in het instellingenpaneel zodra ze geauthenticeerd zijn.
Cline is een VS Code-extensie met een ingebouwde MCP-serverbeheerder. Geen handmatige JSON-bewerking nodig.
-
Installeer Cline vanuit de VS Code Marketplace:
- Open VS Code en druk op
Ctrl+Shift+X/Cmd+Shift+X - Zoek naar Cline en klik op Installeren
- Open VS Code en druk op
-
Klik op het Cline-icoon in de Activiteitenbalk (linkerzijbalk) om het Cline-paneel te openen.
-
Klik op het MCP Servers-icoon (stekker-icoon) in de Cline-werkbalk, kies dan Edit MCP Settings.
-
VS Code opent
cline_mcp_settings.json. Voeg de Wink-vermeldingen toe:cline_mcp_settings.json {"mcpServers": {"wink-extranet-rates": {"type": "http","url": "https://api.wink.travel/mcp/extranet/rates"},"wink-extranet-operations": {"type": "http","url": "https://api.wink.travel/mcp/extranet/operations"}}} -
Sla het bestand op. Cline herlaadt automatisch en opent een browsertabblad naar
https://iam.wink.travel. -
Log in bij Wink en keur de permissies goed. Beide servers verschijnen als actief in het MCP Servers-paneel.
Scopes
Section titled “Scopes”Wanneer je het toestemmingsscherm goedkeurt, zie je een overzicht van wat de agent aanvraagt. MCP-clients gebruiken hetzelfde permissievocabulaire als de rest van het platform — zie de volledige scope-referentie op de Authenticatiepagina.
Drie dingen zijn specifiek voor MCP:
- De scopes
mcp.read,mcp.writeenmcp.removezijn daarnaast vereist om de MCP-transport te openen. Een client met eenmcp.*scope krijgt toegang tot elk Wink MCP-endpoint, maar elke tool die wordt aangeroepen handhaaft nog steeds de sectiescope van het endpoint dat het omsluit (bijv.booking.read). - MCP handelt altijd als een ingelogde gebruiker. De AI-client ontvangt de
mcp.*scopes via jouw aanmelding, nooit via een Applicatie die je aanmaakt. Machine-to-machine (client-credentials) tokens kunnen de MCP-transport niet openen; gebruik de REST API voor server-naar-server werk. - De AI-client vraagt alleen de scopes aan die hij nodig heeft. Je kunt individuele permissies weigeren op het toestemmingsscherm — tools die een geweigerde scope vereisen, geven een foutmelding bij aanroep.
Toolsets veranderen hier niets aan. Het endpoint waar je verbinding mee maakt bepaalt welke tools vermeld worden, niet wat ze mogen doen. Verbinden met /mcp/payment geeft geen financiële permissie die je nog niet had, en verbinden met /mcp/reference verhindert niet dat een tool daar zijn eigen scope afdwingt. Autorisatie wordt per tool-aanroep beslist, op basis van je token en de machtigingen van je account.
Problemen oplossen
Section titled “Problemen oplossen”Browsertabblad 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 gecachte token is mogelijk verlopen. Verwijder en voeg de server opnieuw toe om een verse aanmelding te forceren:
# Claude Codeclaude mcp remove wink-ratesclaude mcp add wink-rates https://api.wink.travel/mcp/extranet/rates --transport httpVoor Claude Desktop en ChatGPT, verwijder de serververmelding 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, of een permissie die je account niet heeft. Verbind de server opnieuw — het toestemmingsscherm verschijnt weer en je kunt de ontbrekende permissie goedkeuren. Als het nog steeds mislukt, heeft de tool een accountpermissie nodig die je niet hebt; verbinden met een andere toolset helpt niet, want toolsets verlenen geen permissies.
De tool die ik nodig heb staat niet in de lijst
Je bent waarschijnlijk verbonden met een toolset die die taak niet dekt. Controleer de endpoint-directory en voeg de toolset toe die dat wel doet — verbindingen zijn onafhankelijk, dus toevoegen verandert niets aan de anderen. Als je niet zeker weet welke het is, verbind tijdelijk met https://api.wink.travel/mcp, zoek de tool en kijk dan welke toolset hem vermeldt.
404 Not Found op een toolset-endpoint
Controleer het pad goed — geneste toolsets hebben twee segmenten (/mcp/extranet/rates, niet /mcp/extranet-rates), en vlakke hebben er één (/mcp/link-manager). Let op dat een niet-geauthenticeerde aanvraag naar een pad onder /mcp een 401 teruggeeft, geen 404, dus alleen een 401 zegt niet of het endpoint bestaat.
Ik verbond met api.wink.travel/mcp/channel-manager en kreeg niets
Dat endpoint bestaat niet. Channel manager-integratie wordt alleen bediend vanaf https://integrations.wink.travel/mcp/channel-manager. Als je ook handmatig de eigen tarieven van een accommodatie moet lezen of schrijven, is dat een aparte taak op een apart endpoint — zie /mcp/extranet/rates.
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 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. Als je na een lange inactiviteit authenticatiefouten ziet, 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 externe servers; stdio-transport is alleen voor lokale binaries.
ChatGPT-menu “Connectors” 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 is en "type": "http" bevat. Ga dan naar Settings → Cursor Settings → MCP en klik op Refresh. Als de fout blijft, 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 op te pikken. Gebruik Bestand → Afsluiten en start opnieuw. Als servers nog steeds niet verschijnen, controleer of je Windsurf 1.4+ gebruikt via Help → Over Windsurf.
Cline-optie “Add Server” niet zichtbaar
De MCP-serverbeheerder vereist Cline 2.0 of hoger. Open het VS Code Extensions-paneel, zoek Cline en klik op Update als er een update beschikbaar is. Na update, herlaad VS Code (Ctrl+Shift+P → “Developer: Reload Window”).
Open Wink Portal Wink op GitHub
