Ga naar inhoud

MCP-servers

De MCP-tools van Wink worden gepubliceerd als toolsets — gerichte eindpunten, elk gericht op één taak. Je verbindt je AI-client met één of twee die bij je werk passen, niet met ze allemaal.

Elk eindpunt 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.

Een channel manager-integrator verbindt met één eindpunt
claude mcp add wink-channel-manager https://integrations.wink.travel/mcp/channel-manager --transport http
Een hotelier die zijn eigen tarieven beheert, verbindt met een ander
claude mcp add wink-rates https://api.wink.travel/mcp/extranet/rates --transport http

Waarom de tools zijn verdeeld over eindpunten

Section titled “Waarom de tools zijn verdeeld over eindpunten”

Wink biedt ongeveer 500 tools aan. Ze allemaal tegelijk aan een agent geven is technisch mogelijk — en een slecht idee.

Tooldefinities kosten context. Elke tool die een MCP-server adverteert, 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.


Twee hosts bedienen toolsets. Het aantal tools is bij benadering en groeit in de tijd.

EindpuntToolsWat het dekt
/mcp/extranet/facilities~64De boekbare en ter plaatse aanwezige inventaris: gastenkamers en kamertypes, spa’s, restaurants, vergaderruimtes, activiteiten, attracties, plaatsen, andere verkoopbare items
/mcp/extranet/property~62Het eigendomsrecord en de commerciële voorwaarden: profiel en inhoud, extra’s, annuleringsvoorwaarden, voordelen, aankondigingen
/mcp/settings~60Accountbeheer: profiel en branding van de beheersentiteit, managers en hun machtigingen, aanpassingen, webhooks, notificatievoorkeuren
/mcp/studio/embeds~48Gepubliceerde samengestelde inventaris: widgets, grids en gerangschikte grids, kaarten, kaarten, diepgaande links naar inventaris en leverancierspagina’s
/mcp/extranet/rates~44Prijzen en beschikbaarheid: inventaristariefperiodes en toewijzingen, tariefplannen, hoofdtarieven, speciale en promotietarieven
/mcp/extranet/operations~39Het runnen van een live eigendom: reserveringen en hun levenscyclus, gastbeoordelingen en reacties, kalenderfeeds, geplande taken
/mcp/extranet/distribution~37Waar inventaris wordt verkocht: verkoopkanalen en tariefmodifiers, affiliate- en leveranciersrelatieverzoeken, registratie, leadcaptatie
/mcp/studio/curation~35Het bouwen van merchandisable collecties: statische en dynamische lijsten, gerangschikte lijsten, opgeslagen zoekopdrachten, eigendomsaggregaten
/mcp/link-manager~28Gesyndiceerde linkcollecties, hun ontwerp, categorieën en tags, plus verkorte URL’s
/mcp/reference~24Alleen-lezen opzoekgegevens: landen, valuta’s en wisselkoersen, talen, tijdzones, geografische opzoekingen, IP-geolocatie
/mcp/analytics~18Boekings- en omzetanalyses: overzichten, lijndiagrammen, ranglijsten, affiliateprestaties, deelstatistieken
/mcp/payment~18Financiële operaties: het grootboek, opnames en kostenramingen, boekingsfondsaggregaten
/mcp/booking-engine~17Het reizigersgerichte winkelpad: zoeken en opzoeken, winkelwagen en afrekenen, bucketlists, campagne-aanpassing
/mcp/social~17Verbonden sociale accounts, publiceren en plannen van berichten, lezen van berichtinzichten
/mcp/travel-agent~8Door agent gefaciliteerde boekingen namens reizigers, en agentrapporten

https://integrations.wink.travel — channel manager-integraties

Section titled “https://integrations.wink.travel — channel manager-integraties”

Eén eindpunt, omdat deze host voor één taak bestaat.

EindpuntToolsWat het dekt
/mcp/channel-manager~9Verbinden en verifiëren van een channel manager-, PMS- of CRS-integratie

Elk eindpunt heeft ook een ping-tool, zodat je kunt bevestigen dat een verbinding live is voordat je echt werk vraagt.

Voor de complete reizigersboekingsflow, verbind Wink Booking Engine op https://api.wink.travel/mcp/booking-engine en een compatibele betalingsportemonnee. 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 booking en betaling zijn ingeschakeld voor die omgeving. Zie Agentic Payments voor de verbindingsinstellingen, de te selecteren permissies en de stappen van zoeken tot bevestiging.


Als je…Verbind met
Een channel manager, PMS of CRS integreertintegrations.wink.travel/mcp/channel-manager — alleen deze
De inhoud van een eigendom 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
Affiliatepagina’s bouwt/mcp/studio/curation + /mcp/studio/embeds
Link-in-bio-pagina’s runt/mcp/link-manager + /mcp/social
Boekingen namens reizigers doet/mcp/travel-agent
Geld afstemt/mcp/payment
Een kamer boekt met een AI-agent/mcp/booking-engine + een compatibele betalingsportemonnee — 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 booking- en betalingstools zijn ook inbegrepen wanneer ingeschakeld voor die omgeving.

Voor een stadgebaseerde 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 eigendomskennis. 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 het toevoegen van één beïnvloedt de anderen nooit.


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:

  1. Je AI-client ontdekt de autorisatieserver via de /.well-known/oauth-protected-resource metadata van het MCP-eindpunt.
  2. De client registreert zichzelf via Dynamic Client Registration — geen handmatige applicatie-instelling nodig.
  3. 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.
  4. Wink geeft een toegangstoken uit dat is gescopeerd op je account en gekoppeld aan je identiteit.
  5. De AI-client voegt het token toe aan elke MCP-aanvraag. Alle toolresultaten zijn automatisch gescopeerd op jouw beheersentiteit.
  6. Tokens verlopen na 3 uur. Je AI-client vernieuwt ze stil op de achtergrond zonder opnieuw te vragen.

Elke toolaanroep draait onder jouw identiteit — dezelfde ACL-regels die het webportaal beschermen, gelden ook voor de AI-agent.


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

    Terminal window
    npm install -g @anthropic-ai/claude-code
  2. 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
  3. Claude Code neemt contact op met de server, ontdekt de autorisatieserver en opent je standaardbrowser.

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

  5. Claude Code bevestigt de verbinding. Typ /mcp om 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:

Terminal window
claude mcp add wink-operations https://api.wink.travel/mcp/extranet/operations --transport http
claude mcp add wink-analytics https://api.wink.travel/mcp/analytics --transport http

Je logt maar één keer in. Na de eerste browsergoedkeuring hergebruikt Claude Code je Wink-sessie voor extra Wink-eindpunten.


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.

Twee dingen zijn specifiek voor MCP:

  • De mcp.read mcp.write mcp.remove scopes zijn daarnaast vereist om de MCP-transport te openen. Een client met een mcp.* scope mag elk Wink MCP-eindpunt gebruiken, maar elke tool die hij aanroept handhaaft nog steeds de sectiescope van het eindpunt dat hij omhult (bijv. booking.read).
  • 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 eindpunt 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 voorkomt niet dat een tool daar zijn eigen scope afdwingt. Autorisatie wordt per toolaanroep bepaald, op basis van je token en de machtigingen van je account.


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 opgeslagen token is mogelijk verlopen. Verwijder en voeg de server opnieuw toe om een verse login te forceren:

Terminal window
# Claude Code
claude mcp remove wink-rates
claude mcp add wink-rates https://api.wink.travel/mcp/extranet/rates --transport http

Voor 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 endpointdirectory 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 heeft, verbind dan tijdelijk met https://api.wink.travel/mcp, zoek de tool en kijk welke toolset hem vermeldt.

404 Not Found op een toolset-eindpunt

Controleer het pad goed — de geneste toolsets hebben twee segmenten (/mcp/extranet/rates, niet /mcp/extranet-rates), en de platte 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 eindpunt bestaat.

Ik verbond met api.wink.travel/mcp/channel-manager en kreeg niets

Dat eindpunt 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 eigendom moet lezen of schrijven, is dat een aparte taak op een apart eindpunt — zie /mcp/extranet/rates.

De server verschijnt maar toolaanroepen 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 “Connectors”-menu ontbreekt

MCP-ondersteuning vereist ChatGPT desktop-app versie 1.2024.352 of later en een actief Plus-, Pro-, Team- of Enterprise-abonnement. Update de app en controleer je abonnement in 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 Instellingen → Cursor-instellingen → MCP en klik op Vernieuwen. 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 “Server toevoegen”-optie niet zichtbaar

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


Open Wink Portal Wink op GitHub