Gå til indhold

MCP-servere

Winks MCP-værktøjer udgives som værktøjssæt — fokuserede endpoints, der hver dækker ét job. Du forbinder din AI-klient til det ene eller to, der matcher dit arbejde, ikke til alle.

Hvert endpoint bruger interaktiv OAuth2-login (PKCE autorisationskode-flow): din AI-agent åbner en browsertab, du logger ind med din Wink-konto, og det er det. Ingen klienthemmeligheder at administrere.

En channel manager-integrator forbinder til ét endpoint
claude mcp add wink-channel-manager https://integrations.wink.travel/mcp/channel-manager --transport http
En hotelier, der administrerer egne priser, forbinder til et andet
claude mcp add wink-rates https://api.wink.travel/mcp/extranet/rates --transport http

Hvorfor værktøjerne er opdelt på endpoints

Sektion kaldt “Hvorfor værktøjerne er opdelt på endpoints”

Wink eksponerer omkring 500 værktøjer. At give alle til en agent på én gang er teknisk muligt — og en dårlig idé.

Værktøjsdefinitioner koster kontekst. Hvert værktøj, en MCP-server annoncerer, indlæses i modellens kontekstvindue, før den udfører noget arbejde, sammen med dets beskrivelse og fulde parameterskema. Fem hundrede af dem bruger en stor del af budgettet, som din egentlige opgave har brug for, ved hver enkelt forespørgsel.

Valgkvaliteten falder, når listen vokser. En agent, der vælger blandt 500 værktøjer med lignende navne, træffer dårligere valg end en, der vælger blandt 40. Hvis du integrerer en channel manager, er cirka tyve værktøjer relevante for dig; de øvrige 480 er støj, der gør det sværere at finde det rigtige værktøj.

Arbejdet er faktisk adskilleligt. En, der synkroniserer tilgængelighed fra et PMS, og en, der kuraterer affiliate landingssider, deler næsten ingen værktøjer. Opdeling efter job betyder, at hver forbindelse bærer ordforrådet for ét job.


To hosts leverer værktøjssæt. Antallet af værktøjer er omtrentligt og vokser over tid.

EndpointVærktøjerHvad det dækker
/mcp/extranet/facilities~64Den bookbare og onsite inventar: gæsteværelser og værelsestyper, spaer, restauranter, mødelokaler, aktiviteter, attraktioner, steder, andre salgbare genstande
/mcp/extranet/property~62Ejendomsoplysninger og kommercielle vilkår: profil og indhold, tillæg, afbestillingsregler, fordele, meddelelser
/mcp/settings~60Konto-administration: administrationsenhedsprofil og branding, ledere og deres beføjelser, tilpasning, webhooks, notifikationspræferencer
/mcp/studio/embeds~48Publicering af kurateret inventar: widgets, grids og rangerede grids, kort, kort, dybe links til inventar og leverandørsider
/mcp/extranet/rates~44Priser og tilgængelighed: inventarprisperiode og kvoter, rateplaner, masterpriser, særlige og kampagnepriser
/mcp/extranet/operations~39Drift af en live ejendom: reservationer og deres livscyklus, gæsteanmeldelser og svar, kalenderfeeds, planlagte opgaver
/mcp/extranet/distribution~37Hvor inventar sælges: salgskanaler og prisændringer, affiliate- og leverandørforholdsanmodninger, registrering, leadfangst
/mcp/studio/curation~35Opbygning af markedsførbare samlinger: statiske og dynamiske lister, rangerede lister, gemte søgninger, ejendomsaggregater
/mcp/link-manager~28Syndikerede link-samlinger, deres design, kategorier og tags, plus forkortede URL’er
/mcp/reference~24Læse-only opslagdata: lande, valutaer og valutakurser, sprog, tidszoner, geo-opslag, IP-geolokation
/mcp/analytics~18Booking- og indtægtsanalyse: oversigter, linjediagrammer, top-lister, affiliate-performance, delingsmålinger
/mcp/payment~18Finansielle operationer: regnskab, udbetalinger og gebyrestimater, bookingfondssummer
/mcp/booking-engine~17Rejsendes shoppingsti: søgning og opslag, indkøbskurv og checkout, bucket lists, kampagnetilpasning
/mcp/social~17Forbundne sociale konti, publicering og planlægning af opslag, læsning af opslagindsigter
/mcp/travel-agent~8Agent-faciliterede bookinger på vegne af rejsende og agentrapporter

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

Sektion kaldt “https://integrations.wink.travel — channel manager-integrationer”

Ét endpoint, fordi denne host eksisterer til ét job.

EndpointVærktøjerHvad det dækker
/mcp/channel-manager~9Forbindelse og verifikation af en channel manager, PMS eller CRS-integration

Hvert endpoint har også et ping-værktøj, så du kan bekræfte, at en forbindelse er aktiv, før du beder det om at udføre rigtigt arbejde.

For den komplette rejsendes bookingflow, forbind Wink Booking Engine på https://api.wink.travel/mcp/booking-engine og en kompatibel betalingswallet. Tilføjelse af Wink MCP åbner browser-login og tilladelsesvalg; din klient håndterer derefter autentificering.

Booking Engine inkluderer destinationsopslag, hotel- og værelsessøgning, agentic_booking_quote, agentic_booking_pay, agentic_booking_book, bookinghentning og kvitteringer, når agentisk booking og betaling er aktiveret for det miljø. Se Agentic Payments for opsætning af forbindelse, de tilladelser der skal vælges, og trinene fra søgning til bekræftelse.


Hvis du er…Forbind til
Integrerer en channel manager, PMS eller CRSintegrations.wink.travel/mcp/channel-manager — kun denne
Administrerer en ejendoms indhold/mcp/extranet/property + /mcp/extranet/facilities
Administrerer værelser og værelsestyper/mcp/extranet/facilities
Administrerer priser og tilgængelighed/mcp/extranet/rates
Driver dag-til-dag reservationer/mcp/extranet/operations
Udvider distribution/mcp/extranet/distribution + /mcp/analytics
Bygger affiliate-sider/mcp/studio/curation + /mcp/studio/embeds
Driver link-in-bio-sider/mcp/link-manager + /mcp/social
Booker på vegne af rejsende/mcp/travel-agent
Afstemmer penge/mcp/payment
Booker et værelse med en AI-agent/mcp/booking-engine + en kompatibel betalingswallet — se Agentic Payments
Bygger en bookingoplevelse/mcp/booking-engine; eventuelt /mcp/reference til yderligere opslag

Booking Engine indeholder den centrale bookingworkflow. Den leverer konto- og tilpasningsopdagelse, destinationsopslag, hoteltilgængelighed og værelsesprisdetaljer, indkøbskurve, checkout og rejsendes bookingadministration. Agentiske booking- og betalingsværktøjer er også inkluderet, når de er aktiveret for det miljø.

For en bybaseret hotelsøgning, brug destination_lookup_search_suggestions til at løse destinationen, derefter inventory_search_city for at finde tilgængelige hoteller og priser. Begge værktøjer er i /mcp/booking-engine, så denne flow kræver ikke en Reference-forbindelse.

Tilføj /mcp/reference, når du har brug for understøttende opslag som lande, valutaer og valutakurser, understøttede sprog, tidszoner, bredere geografiske søgninger, OTA-klassifikationer eller offentlig ejendomsviden. Disse er valgfrie tilføjelser til bookingflowet.

Start med ét. Tilføj et andet, når du opdager, at du spørger efter noget, det ikke kan gøre — hver forbindelse er uafhængig, og tilføjelse af én påvirker aldrig de andre.


Wink MCP-servere bruger OAuth2 Authorization Code + PKCE flow og understøtter Dynamic Client Registration (RFC 7591). Her er, hvad der sker, når du forbinder første gang:

  1. Din AI-klient finder autorisationsserveren fra MCP-endpointets /.well-known/oauth-protected-resource metadata.
  2. Klienten selvregistrerer 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 adgangstoken scoped til din konto og knyttet til din identitet.
  5. AI-klienten vedhæfter token til hver MCP-forespørgsel. Alle værktøjsresultater er automatisk scoped til din administrationsenhed.
  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.


Tilføj hvert værktøjssæt til Claude som en brugerdefineret connector. Der er ingen konfigurationsfil at redigere og ingen applikation eller hemmelighed at oprette.

  1. I Claude, åbn Customize › Connectors, klik Add, og vælg derefter Add custom connector.

  2. Indtast et Navn (for eksempel Wink Link manager) og som MCP server URL et værktøjssæt fra kataloget ovenfor, for eksempel:

    https://api.wink.travel/mcp/link-manager

    Klik Continue.

  3. Claude registrerer Winks login. Behold Authentication: Sign in now og OAuth client: Register automatically, og klik derefter Add.

  4. Klik Connect. En Wink-login-side åbnes på https://iam.wink.travel. Log ind på Wink og godkend tilladelserne på samtykkeskærmen.

  5. Connectorens værktøjer er nu tilgængelige i dine chats. Gentag for hvert værktøjssæt, dit arbejde har brug for; hvert er sin egen connector.


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

Tre ting er specifikke for MCP:

  • mcp.read mcp.write mcp.remove scopes kræves desuden for at åbne MCP-transporten. En klient med et mcp.* scope får adgang til ethvert Wink MCP-endpoint, men hvert værktøj, den kalder, håndhæver stadig sektionens scope for det endpoint, det omslutter (f.eks. booking.read).
  • MCP optræder altid som en indlogget bruger. AI-klienten modtager mcp.* scopes gennem din login, aldrig fra en Application, du opretter. Maskine-til-maskine (client-credentials) tokens kan ikke åbne MCP-transporten; brug REST API til server-til-server arbejde.
  • AI-klienten anmoder kun om de scopes, den har brug for. Du kan nægte individuelle tilladelser på samtykkeskærmen — værktøjer, der kræver et nægtet scope, returnerer en fejl ved kald.

Værktøjssæt ændrer ikke noget af dette. Det endpoint, du forbinder til, bestemmer, hvilke værktøjer der vises, ikke hvad de må gøre. Forbindelse til /mcp/payment giver ingen finansiel tilladelse, du ikke allerede havde, og forbindelse til /mcp/reference forhindrer ikke et værktøj i at håndhæve sit eget scope. Autorisation afgøres per værktøjskald, ud fra dit token og din kontos beføjelser.


Browserfanen åbner ikke

Din AI-klient understøtter muligvis ikke det interaktive PKCE-flow endnu. Bekræft, 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:

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

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

403 Forbidden ved kald af et bestemt værktøj

Værktøjet kræver et scope, du ikke godkendte på samtykkeskærmen, eller en tilladelse, din konto ikke har. Forbind serveren igen — samtykkeskærmen vises igen, og du kan godkende den manglende tilladelse. Hvis det stadig fejler, kræver værktøjet en kontotilladelse, du ikke har; at forbinde til et andet værktøjssæt hjælper ikke, fordi værktøjssæt ikke giver tilladelser.

Det værktøj, jeg har brug for, er ikke på listen

Du er sandsynligvis forbundet til et værktøjssæt, der ikke dækker det job. Tjek endpoint-kataloget og tilføj det værktøjssæt, der gør — forbindelser er uafhængige, så tilføjelse af ét ændrer ikke noget ved de andre. Hvis du er usikker på, hvilket der har det, kan du midlertidigt forbinde til https://api.wink.travel/mcp, finde værktøjet og derefter se, hvilket værktøjssæt der indeholder det.

404 Not Found på et værktøjssæt-endpoint

Tjek stien nøje — de indlejrede værktøjssæt har to segmenter (/mcp/extranet/rates, ikke /mcp/extranet-rates), og de flade har ét (/mcp/link-manager). Bemærk, at en unauthentificeret forespørgsel til en hvilken som helst sti under /mcp returnerer 401, ikke 404, så en 401 alene fortæller ikke, om endpointet findes.

Jeg forbandt til api.wink.travel/mcp/channel-manager og fik intet

Det endpoint findes ikke. Channel manager-integration serveres kun fra https://integrations.wink.travel/mcp/channel-manager. Hvis du også skal læse eller skrive en ejendoms egne priser manuelt, er det et separat job på et separat endpoint — se /mcp/extranet/rates.

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

Du er logget ind på en Wink-konto uden en administrationsenhed. Gå til Wink Portal og sørg for, at din konto er sat op, 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 til 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 Settings → Account.

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

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

Windsurf MCP-servere vises ikke i indstillinger

Windsurf kræver fuld genstart (ikke kun genindlæsning af vindue) for at opfange ændringer i mcp_config.json. Brug File → Quit og genstart. Hvis serverne stadig ikke vises, bekræft, at du kører Windsurf 1.4+ via Help → About 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 Update, hvis en opdatering er tilgængelig. Efter opdatering, genindlæs VS Code (Ctrl+Shift+P → “Developer: Reload Window”).


Åbn Wink Portal Wink på GitHub