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.
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 httpHvorfor 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.
Endepunktkatalog
Section titled “Endepunktkatalog”To verter serverer verktøysett. Antall verktøy er omtrentlige og øker over tid.
https://api.wink.travel — plattformen
Section titled “https://api.wink.travel — plattformen”| Endepunkt | Verktøy | Hva det dekker |
|---|---|---|
/mcp/extranet/facilities | ~64 | Den bookbare og på stedet beholdningen: gjesterom og romtyper, spa, restauranter, møterom, aktiviteter, attraksjoner, steder, andre salgbare varer |
/mcp/extranet/property | ~62 | Eiendomsoppføringen og dens kommersielle vilkår: profil og innhold, tillegg, avbestillingsregler, fordeler, kunngjøringer |
/mcp/settings | ~60 | Konto-administrasjon: administrerende enhets profil og merkevarebygging, ledere og deres fullmakter, tilpasning, webhooks, varslingspreferanser |
/mcp/studio/embeds | ~48 | Publisering av kuratert beholdning: widgets, rutenett og rangerte rutenett, kort, kart, dype lenker til beholdning og leverandørsider |
/mcp/extranet/rates | ~44 | Priser og tilgjengelighet: beholdningsprisperioder og kvoter, prisplaner, hovedpriser, spesial- og kampanjepriser |
/mcp/extranet/operations | ~39 | Drift av en aktiv eiendom: reservasjoner og deres livssyklus, gjesteanmeldelser og svar, kalenderfeeds, planlagte oppgaver |
/mcp/extranet/distribution | ~37 | Hvor beholdningen selges: salgskanaler og prisjusteringer, affiliate- og leverandørrelasjonsforespørsler, registrering, leadfangst |
/mcp/studio/curation | ~35 | Bygge salgbare samlinger: statiske og dynamiske lister, rangerte lister, lagrede søk, eiendomsaggregater |
/mcp/link-manager | ~28 | Syndikerte lenkesamlinger, deres design, kategorier og tagger, pluss forkortede URL-er |
/mcp/reference | ~24 | Kun lesetilgang til oppslagsdata: land, valutaer og valutakurser, språk, tidssoner, geografiske oppslag, IP-geolokalisering |
/mcp/analytics | ~18 | Booking- og inntektsanalyse: oversikter, linjediagrammer, topplister, affiliate-ytelse, delingsmålinger |
/mcp/payment | ~18 | Finansielle operasjoner: hovedbok, uttak og gebyrestimater, bookingfond-aggregater |
/mcp/booking-engine | ~17 | Den reisende sin handlebane: søk og oppslag, handlekurv og utsjekk, ønskelister, kampanjetilpasning |
/mcp/social | ~17 | Tilknyttede sosiale kontoer, publisering og planlegging av innlegg, lese innsikt om innlegg |
/mcp/travel-agent | ~8 | Agentformidlet 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.
| Endepunkt | Verktøy | Hva det dekker |
|---|---|---|
/mcp/channel-manager | ~9 | Koble 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.
Agentiske betalinger
Section titled “Agentiske betalinger”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.
Hvilke verktøysett trenger jeg?
Section titled “Hvilke verktøysett trenger jeg?”| Hvis du er… | Koble til |
|---|---|
| Integrerer en kanalmanager, PMS eller CRS | integrations.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.
Hvordan autentisering fungerer
Section titled “Hvordan autentisering fungerer”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:
- AI-klienten din oppdager autorisasjonsserveren fra MCP-endepunktets
/.well-known/oauth-protected-resourcemetadata. - Klienten registrerer seg selv via Dynamic Client Registration — ingen manuell applikasjonsoppsett kreves.
- Klienten åpner en nettleserfane til
https://iam.wink.travel. Du logger inn med Wink-kontoen din og godkjenner de forespurte tillatelsene på samtykkeskjermen. - Wink utsteder en tilgangstoken som er knyttet til kontoen din og identiteten din.
- AI-klienten legger token til hver MCP-forespørsel. Alle verktøyresultater er automatisk knyttet til din administrerende enhet.
- 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.
Koble til AI-klienten din
Section titled “Koble til AI-klienten din”Legg til hvert verktøysett i Claude som en egendefinert tilkobler. Det finnes ingen konfigurasjonsfil å redigere og ingen applikasjon eller hemmelighet å opprette.
-
I Claude, åpne Customize › Connectors, klikk Add, deretter Add custom connector.
-
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-managerKlikk Continue.
-
Claude oppdager Winks pålogging. Behold Authentication: Sign in now og OAuth client: Register automatically, og klikk deretter Add.
-
Klikk Connect. En Wink-påloggingsside åpnes på
https://iam.wink.travel. Logg inn på Wink og godkjenn tillatelsene på samtykkeskjermen. -
Tilkoblerens verktøy er nå tilgjengelige i chattene dine. Gjenta for hvert verktøysett arbeidet ditt trenger; hvert er sin egen tilkobler.
-
Sørg for at Claude Code er oppdatert:
Terminal window npm install -g @anthropic-ai/claude-code -
Velg et verktøysett fra katalogen ovenfor og legg det til. For eksempel priser og tilgjengelighet:
Terminal window claude mcp add wink-rates https://api.wink.travel/mcp/extranet/rates --transport http -
Claude Code kontakter serveren, oppdager autorisasjonsserveren og åpner standard nettleser.
-
Logg inn på Wink og godkjenn tillatelsesforespørselen på samtykkeskjermen.
-
Claude Code bekrefter tilkoblingen. Skriv
/mcpfor å verifisere at serveren vises og verktøyene er lastet.
Legg til så mange verktøysett som arbeidet ditt trenger — hvert er en egen serveroppføring med eget navn:
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 httpDu logger bare inn én gang. Etter første nettlesergodkjenning gjenbruker Claude Code Wink-økten din for flere Wink-endepunkter.
-
Rediger Claude Desktop-konfigurasjonsfilen:
- macOS:
~/Library/Application Support/Claude/claude_desktop_config.json - Windows:
%APPDATA%\Claude\claude_desktop_config.json - Linux:
~/.config/Claude/claude_desktop_config.json
- macOS:
-
Legg til MCP-serveroppføringene:
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"}}} -
Avslutt helt og start på nytt Claude Desktop (bruk Quit fra menylinjen — det holder ikke å bare lukke vinduet).
-
Claude Desktop åpner en nettleserfane for hver ny server. Logg inn på Wink og godkjenn tillatelser.
-
Pluggikonet i bunnverktøylinjen viser begge serverne som tilkoblet.
-
Sørg for at Codex CLI er installert:
Terminal window npm install -g @openai/codex -
Åpne (eller opprett) Codex-konfigurasjonsfilen:
- macOS / Linux:
~/.codex/config.json - Windows:
%USERPROFILE%\.codex\config.json
- macOS / Linux:
-
Legg til Wink MCP-serveroppføringene:
~/.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. Ved første bruk åpner Codex en nettleserfane til
https://iam.wink.travel. -
Logg inn på Wink og godkjenn de forespurte tillatelsene.
-
Codex bekrefter tilkoblingen. Kjør
codexog be den liste tilgjengelige verktøy for å verifisere at Wink-serverne er aktive.
MCP-serverstøtte er tilgjengelig i ChatGPT desktop app for Plus, Pro, Team og Enterprise-abonnenter.
-
Last ned og installer ChatGPT desktop app hvis du ikke allerede har den.
-
Åpne appen og klikk på profilikonet ditt øverst til høyre, velg deretter Settings.
-
Gå til Connectors (eller MCP Servers avhengig av app-versjon) og klikk Add.
-
Skriv inn URL-en til et verktøysett fra katalogen ovenfor, for eksempel:
https://api.wink.travel/mcp/extranet/ratesKlikk deretter Connect.
-
ChatGPT åpner en nettleserfane til
https://iam.wink.travel. Logg inn på Wink og godkjenn tillatelser. -
Gjenta trinn 4–5 for andre verktøysett arbeidet ditt trenger, for eksempel:
https://api.wink.travel/mcp/extranet/operations -
Hvert verktøysett vises i listen over Connectors. Start en ny chat — Wink-verktøy er tilgjengelige automatisk.
-
Åpne (eller opprett) Cursor MCP-konfigurasjonsfilen:
- macOS / Linux:
~/.cursor/mcp.json - Windows:
%USERPROFILE%\.cursor\mcp.json
- macOS / Linux:
-
Legg til Wink MCP-serveroppføringene:
~/.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"}}} -
Åpne Cursor. Gå til Settings → Cursor Settings → MCP og bekreft at begge serverne vises med grønn statusindikator. Hvis de viser rødt, klikk Refresh.
-
Cursor åpner en nettleserfane til
https://iam.wink.travel. Logg inn på Wink og godkjenn tillatelser. -
Åpne en chat (
Ctrl+L/Cmd+L) og be Cursor liste tilgjengelige Wink-verktøy for å bekrefte tilkoblingen.
-
Åpne (eller opprett) Windsurf MCP-konfigurasjonsfilen:
- macOS / Linux:
~/.codeium/windsurf/mcp_config.json - Windows:
%USERPROFILE%\.codeium\windsurf\mcp_config.json
- macOS / Linux:
-
Legg til Wink MCP-serveroppføringene:
~/.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 helt på nytt (Fil → Avslutt, så åpne på nytt).
-
Gå til Settings → MCP Servers og bekreft at begge serverne vises som tilkoblet. Windsurf åpner en nettleserfane til
https://iam.wink.travelved første bruk. -
Logg inn på Wink og godkjenn tillatelser. Serverne blir grønne i innstillingspanelet når autentisert.
Cline er en VS Code-utvidelse med innebygd MCP-serverbehandler. Ingen manuell JSON-redigering kreves.
-
Installer Cline fra VS Code Marketplace:
- Åpne VS Code og trykk
Ctrl+Shift+X/Cmd+Shift+X - Søk etter Cline og klikk Install
- Åpne VS Code og trykk
-
Klikk på Cline-ikonet i aktivitetslinjen (venstre sidepanel) for å åpne Cline-panelet.
-
Klikk på MCP Servers-ikonet (pluggikon) i Cline-verktøylinjen, velg deretter Edit MCP Settings.
-
VS Code åpner
cline_mcp_settings.json. Legg til Wink-oppføringene: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"}}} -
Lagre filen. Cline laster inn på nytt automatisk og åpner en nettleserfane til
https://iam.wink.travel. -
Logg inn på Wink og godkjenn tillatelser. Begge serverne vises som aktive i MCP Servers-panelet.
Tillatelser
Section titled “Tillatelser”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.readmcp.writemcp.removescopes kreves i tillegg for å åpne MCP transporten. En klient medmcp.*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.
Feilsøking
Section titled “Feilsøking”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:
# Claude Codeclaude mcp remove wink-ratesclaude mcp add wink-rates https://api.wink.travel/mcp/extranet/rates --transport httpFor 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
