Skip to content

MCP-servere

Winks MCP-verktøy publiseres som verktøysett — fokuserte endepunkter, hver dekker én jobb. Du kobler AI-klienten din til én eller to som passer til arbeidet ditt, ikke til alle.

Hvert endepunkt bruker interaktiv OAuth2-pålogging (PKCE autorisasjonskodeflyt): AI-agenten din åpner en nettleserfane, du logger inn med Wink-kontoen din, og det er det. Ingen klienthemmeligheter å håndtere.

En kanalmanager-integrator kobler til ett endepunkt
claude mcp add wink-channel-manager https://integrations.wink.travel/mcp/channel-manager --transport http
En hotellvert som administrerer egne priser kobler til et annet
claude mcp add wink-rates https://api.wink.travel/mcp/extranet/rates --transport http

Hvorfor verktøyene er delt opp i endepunkter

Section titled “Hvorfor verktøyene er delt opp i endepunkter”

Wink eksponerer rundt 500 verktøy. Å gi alle til en agent samtidig er teknisk mulig — og en dårlig idé.

Verktøydefinisjoner koster kontekst. Hvert verktøy en MCP-server annonserer lastes inn i modellens kontekstvindu før den gjør noe arbeid, sammen med beskrivelse og full parameter-skjema. Fem hundre slike bruker en stor del av budsjettet som den faktiske oppgaven din trenger, ved hver eneste forespørsel.

Valgkvaliteten faller når listen vokser. En agent som velger blant 500 verktøy med lignende navn gjør dårligere valg enn en som velger blant 40. Hvis du integrerer en kanalmanager, er omtrent tjue verktøy relevante for deg; de andre 480 er støy som gjør det vanskeligere å finne riktig verktøy.

Arbeidet er genuint separerbart. Noen som synkroniserer tilgjengelighet fra et PMS og noen som kuraterer affiliate-landingssider deler nesten ingen verktøy. Å dele etter jobb betyr at hver tilkobling bærer vokabularet til én jobb.


To verter serverer verktøysett. Antall verktøy er omtrentlige og øker over tid.

EndepunktVerktøyHva det dekker
/mcp/extranet/facilities~64Den bookbare og på stedet beholdningen: gjesterom og romtyper, spa, restauranter, møterom, aktiviteter, attraksjoner, steder, andre salgbare varer
/mcp/extranet/property~62Eiendomsoppføringen og dens kommersielle vilkår: profil og innhold, tillegg, avbestillingsregler, fordeler, kunngjøringer
/mcp/settings~60Konto-administrasjon: administrerende enhets profil og merkevarebygging, ledere og deres fullmakter, tilpasning, webhooks, varslingspreferanser
/mcp/studio/embeds~48Publisering av kuratert beholdning: widgets, rutenett og rangerte rutenett, kort, kart, dype lenker til beholdning og leverandørsider
/mcp/extranet/rates~44Priser og tilgjengelighet: beholdningsprisperioder og kvoter, prisplaner, hovedpriser, spesial- og kampanjepriser
/mcp/extranet/operations~39Drift av en aktiv eiendom: reservasjoner og deres livssyklus, gjesteanmeldelser og svar, kalenderfeeds, planlagte oppgaver
/mcp/extranet/distribution~37Hvor beholdningen selges: salgskanaler og prisjusteringer, affiliate- og leverandørrelasjonsforespørsler, registrering, leadfangst
/mcp/studio/curation~35Bygge salgbare samlinger: statiske og dynamiske lister, rangerte lister, lagrede søk, eiendomsaggregater
/mcp/link-manager~28Syndikerte lenkesamlinger, deres design, kategorier og tagger, pluss forkortede URL-er
/mcp/reference~24Kun lesetilgang til oppslagsdata: land, valutaer og valutakurser, språk, tidssoner, geografiske oppslag, IP-geolokalisering
/mcp/analytics~18Booking- og inntektsanalyse: oversikter, linjediagrammer, topplister, affiliate-ytelse, delingsmålinger
/mcp/payment~18Finansielle operasjoner: hovedbok, uttak og gebyrestimater, bookingfond-aggregater
/mcp/booking-engine~17Den reisende sin handlebane: søk og oppslag, handlekurv og utsjekk, ønskelister, kampanjetilpasning
/mcp/social~17Tilknyttede sosiale kontoer, publisering og planlegging av innlegg, lese innsikt om innlegg
/mcp/travel-agent~8Agentformidlet booking på vegne av reisende, og agentrapporter

https://integrations.wink.travel — kanalmanager-integrasjoner

Section titled “https://integrations.wink.travel — kanalmanager-integrasjoner”

Ett endepunkt, fordi denne verten finnes for én jobb.

EndepunktVerktøyHva det dekker
/mcp/channel-manager~9Koble til og verifisere en kanalmanager-, PMS- eller CRS-integrasjon

Hvert endepunkt har også et ping-verktøy, slik at du kan bekrefte at en tilkobling er aktiv før du ber det gjøre reelt arbeid.

For komplett bookingflyt for reisende, koble til Wink Booking Engine på https://api.wink.travel/mcp/booking-engine og en kompatibel betalingslommebok. Å legge til Wink MCP åpner nettleserpålogging og valg av tillatelser; klienten din håndterer deretter autentisering.

Booking Engine inkluderer destinasjonsoppslag, hotell- og romsøk, agentic_booking_quote, agentic_booking_pay, agentic_booking_book, bookinghenting og kvitteringer, når agentisk booking og betaling er aktivert for det miljøet. Se Agentic Payments for oppsett av tilkobling, tillatelser som skal velges og trinnene fra søk til bekreftelse.


Hvis du er…Koble til
Integrerer en kanalmanager, PMS eller CRSintegrations.wink.travel/mcp/channel-manager — bare dette
Administrerer en eiendoms innhold/mcp/extranet/property + /mcp/extranet/facilities
Administrerer rom og romtyper/mcp/extranet/facilities
Administrerer priser og tilgjengelighet/mcp/extranet/rates
Driver daglige reservasjoner/mcp/extranet/operations
Øker distribusjon/mcp/extranet/distribution + /mcp/analytics
Bygger affiliate-sider/mcp/studio/curation + /mcp/studio/embeds
Driver lenke-i-bio-sider/mcp/link-manager + /mcp/social
Booker på vegne av reisende/mcp/travel-agent
Avstemmer penger/mcp/payment
Booker et rom med en AI-agent/mcp/booking-engine + en kompatibel betalingslommebok — se Agentic Payments
Bygger en bookingopplevelse/mcp/booking-engine; valgfritt /mcp/reference for ekstra oppslag

Booking Engine inkluderer kjerneflyten for booking. Den tilbyr konto- og tilpasningsoppdagelse, destinasjonsoppslag, hotelltilgjengelighet og romprisdetaljer, handlekurver, utsjekk og administrasjon av reisendes bookinger. Agentiske booking- og betalingsverktøy er også inkludert når aktivert for det miljøet.

For et bybasert hotell-søk, bruk destination_lookup_search_suggestions for å løse destinasjonen, deretter inventory_search_city for å finne tilgjengelige hoteller og priser. Begge verktøyene er i /mcp/booking-engine, så denne flyten krever ikke en Reference-tilkobling.

Legg til /mcp/reference når du trenger støttende oppslag som land, valutaer og valutakurser, støttede språk, tidssoner, bredere geografiske søk, OTA-klassifiseringer eller offentlig eiendomskunnskap. Dette er valgfrie tillegg til bookingflyten.

Start med ett. Legg til et annet når du oppdager at du trenger noe det ikke kan gjøre — hver tilkobling er uavhengig, og å legge til en påvirker aldri de andre.


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 token til hver MCP-forespørsel. Alle verktøyresultater er automatisk knyttet til din administrerende enhet.
  6. Token utløper etter 3 timer. AI-klienten din oppdaterer stille i bakgrunnen uten å be om pålogging igjen.

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


Legg til hvert verktøysett i Claude som en egendefinert tilkobler. Det finnes ingen konfigurasjonsfil å redigere og ingen applikasjon eller hemmelighet å opprette.

  1. I Claude, åpne Customize › Connectors, klikk Add, deretter Add custom connector.

  2. Skriv inn et Navn (for eksempel Wink Link manager) og som MCP server URL et verktøysett fra katalogen ovenfor, for eksempel:

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

    Klikk Continue.

  3. Claude oppdager Winks pålogging. Behold Authentication: Sign in now og OAuth client: Register automatically, og klikk deretter Add.

  4. Klikk Connect. En Wink-påloggingsside åpnes på https://iam.wink.travel. Logg inn på Wink og godkjenn tillatelsene på samtykkeskjermen.

  5. Tilkoblerens verktøy er nå tilgjengelige i chattene dine. Gjenta for hvert verktøysett arbeidet ditt trenger; hvert er sin egen tilkobler.


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.

Tre 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 alle Wink MCP-endepunkter, men hvert verktøy den kaller håndhever fortsatt seksjonstillatelsen til endepunktet det omslutter (f.eks. booking.read).
  • MCP opptrer alltid som en pålogget bruker. AI-klienten mottar mcp.* scopes gjennom din pålogging, aldri fra en Applikasjon du oppretter. Maskin-til-maskin (client-credentials) tokens kan ikke åpne MCP-transporten; bruk REST API for server-til-server-arbeid.
  • 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.

Verktøysett endrer ikke noe av dette. Endepunktet du kobler til bestemmer hvilke verktøy som listes, ikke hva de har lov til å gjøre. Å koble til /mcp/payment gir ingen finansielle tillatelser du ikke allerede hadde, og å koble til /mcp/reference hindrer ikke et verktøy der i å håndheve sin egen scope. Autorisasjon avgjøres per verktøykall, basert på token og kontoens fullmakter.


Nettleserfane åpnes ikke

AI-klienten din støtter kanskje ikke den interaktive PKCE-flyten ennå. Sjekk at du kjører en nyere 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 å trigge ny pålogging:

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

403 Forbidden ved kall til et spesifikt verktøy

Verktøyet krever en scope du ikke godkjente på samtykkeskjermen, eller en tillatelse kontoen din ikke har. Koble til serveren på nytt — samtykkeskjermen vises igjen og du kan godkjenne manglende tillatelse. Hvis det fortsatt feiler, trenger verktøyet en kontotillatelse du ikke har; å koble til et annet verktøysett hjelper ikke, fordi verktøysett ikke gir tillatelser.

Verktøyet jeg trenger er ikke i listen

Du er sannsynligvis koblet til et verktøysett som ikke dekker den jobben. Sjekk endepunktkatalogen og legg til verktøysettet som gjør det — tilkoblinger er uavhengige, så å legge til ett endrer ingenting for de andre. Hvis du er usikker på hvilket som har det, koble midlertidig til https://api.wink.travel/mcp, finn verktøyet, og se deretter hvilket verktøysett som lister det.

404 Not Found på et verktøysett-endepunkt

Sjekk stien nøye — de nestede verktøysettene har to segmenter (/mcp/extranet/rates, ikke /mcp/extranet-rates), og de flate har ett (/mcp/link-manager). Merk at en uautentisert forespørsel til hvilken som helst sti under /mcp returnerer 401, ikke 404, så bare 401 alene forteller ikke om endepunktet finnes.

Jeg koblet til api.wink.travel/mcp/channel-manager og fikk ingenting

Det endepunktet finnes ikke. Kanalmanager-integrasjon serveres kun fra https://integrations.wink.travel/mcp/channel-manager. Hvis du også trenger å lese eller skrive en eiendoms egne priser manuelt, er det en separat jobb på et separat endepunkt — se /mcp/extranet/rates.

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 ser autentiseringsfeil etter lang inaktivitet, skriv en ny melding — klienten autentiserer på nytt automatisk.

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 i Settings → Account.

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

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

Windsurf MCP-servere vises ikke i innstillinger

Windsurf krever full omstart (ikke bare vindusoppdatering) for å plukke opp endringer i mcp_config.json. Bruk File → Quit og start på nytt. Hvis serverne fortsatt ikke vises, bekreft at du har Windsurf 1.4+ via Help → About Windsurf.

Cline “Add Server”-valg er ikke synlig

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


Åpne Wink Portal Wink på GitHub