MCP-servrar

Winks MCP-verktyg publiceras som verktygssatser — fokuserade endpoints, var och en täcker ett jobb. Du ansluter din AI-klient till en eller två som matchar ditt arbete, inte till alla.

Varje endpoint använder interaktiv OAuth2-inloggning (PKCE-auktoriseringskodflöde): din AI-agent öppnar en webbläsarflik, du loggar in med ditt Wink-konto, och det är allt. Inga klienthemligheter att hantera.

En kanalhanteringsintegratör ansluter till en endpoint

claude mcp add wink-channel-manager https://integrations.wink.travel/mcp/channel-manager --transport http

En hotellägare som hanterar sina egna priser ansluter till en annan

claude mcp add wink-rates https://api.wink.travel/mcp/extranet/rates --transport http

---

Varför verktygen är uppdelade över endpoints

Wink exponerar omkring 500 verktyg. Att ge alla till en agent på en gång är tekniskt möjligt — och en dålig idé.

Verktygsdefinitioner kostar kontext. Varje verktyg som en MCP-server annonserar laddas in i modellens kontextfönster innan det gör något arbete, tillsammans med dess beskrivning och fullständiga parameterschema. Fem hundra sådana förbrukar en stor del av budgeten som din faktiska uppgift behöver, vid varje enskild förfrågan.

Valkvaliteten försämras när listan växer. En agent som väljer bland 500 liknande namngivna verktyg gör sämre val än en som väljer bland 40. Om du integrerar en kanalhanterare är ungefär tjugo verktyg relevanta för dig; de andra 480 är brus som gör det svårare att hitta rätt verktyg.

Arbetet är verkligen separerbart. Någon som synkroniserar tillgänglighet från ett PMS och någon som kuraterar affiliate-landningssidor delar nästan inga verktyg. Uppdelning efter jobb innebär att varje anslutning bär vokabulären för ett jobb.

Verktygssatser är inte behörigheter

Att välja en smal verktygssats begränsar inte vad ditt konto kan göra, och att välja en bred ger inte något extra. Varje verktyg upprätthåller samma kontobehörigheter som webbportalen, under din inloggade identitet. Om ditt konto inte kan avboka en bokning i Wink Portal kan inte agenten heller — oavsett vilken endpoint den är ansluten till.

Välj verktygssatser för fokus, inte för säkerhet.

---

Endpoint-katalog

Två värdar tillhandahåller verktygssatser. Antal verktyg är ungefärliga och växer över tid.

https://api.wink.travel — plattformen

Endpoint	Verktyg	Vad den täcker
/mcp/extranet/facilities	~64	Bokningsbar och på plats-inventarie: gästrum och rumstyper, spa, restauranger, mötesrum, aktiviteter, attraktioner, platser, andra säljbara artiklar
/mcp/extranet/property	~62	Fastighetsregister och dess kommersiella villkor: profil och innehåll, tillägg, avbokningsregler, förmåner, meddelanden
/mcp/settings	~60	Kontoadministration: hantering av enhetsprofil och varumärke, chefer och deras behörigheter, anpassning, webhooks, notifieringsinställningar
/mcp/studio/embeds	~48	Publicering av kuraterad inventarie: widgets, rutnät och rankade rutnät, kort, kartor, djupa länkar till inventarie och leverantörssidor
/mcp/extranet/rates	~44	Priser och tillgänglighet: inventarieprisperioder och tilldelningar, prisplaner, huvudpriser, special- och kampanjpriser
/mcp/extranet/operations	~39	Drift av en live-fastighet: reservationer och deras livscykel, gästrecensioner och svar, kalenderflöden, schemalagda uppgifter
/mcp/extranet/distribution	~37	Var inventariet säljs: försäljningskanaler och prismodifierare, affiliate- och leverantörsförfrågningar, registrering, lead-fångst
/mcp/studio/curation	~35	Bygga säljbara samlingar: statiska och dynamiska listor, rankade listor, sparade sökningar, fastighetsaggregat
/mcp/link-manager	~28	Syndikerade länksamlingar, deras design, kategorier och taggar, plus förkortade URL:er
/mcp/reference	~24	Endast läsbar uppslagsdata: länder, valutor och växelkurser, språk, tidszoner, geografiska uppslag, IP-geolokalisering
/mcp/analytics	~18	Boknings- och intäktsanalys: översikter, linjediagram, topplistor, affiliate-prestanda, delningsmått
/mcp/payment	~18	Finansiella operationer: huvudbok, uttag och avgiftsuppskattningar, bokningsmedelsaggregat
/mcp/booking-engine	~17	Resenärsorienterad shoppingväg: sökning och uppslag, kundvagn och utcheckning, bucket lists, kampanjanpassning
/mcp/social	~17	Anslutna sociala konton, publicering och schemaläggning av inlägg, läsning av inläggsinsikter
/mcp/travel-agent	~8	Agentförmedlade bokningar för resenärer och agentrapporter

https://integrations.wink.travel — kanalhanterarintegrationer

En endpoint, eftersom denna värd finns för ett jobb.

Endpoint	Verktyg	Vad den täcker
/mcp/channel-manager	~9	Anslutning och verifiering av kanalhanterare, PMS eller CRS-integration

Integrera en kanalhanterare vs. hantera egna priser

Detta är olika jobb för olika personer, och de delar inte en endpoint.

En kanalhanterare, PMS- eller CRS-leverantör integrerar en gång via integrations.wink.travel/mcp/channel-manager, och utbyter därefter fastigheter, priser, tillgänglighet och reservationer över den integrationen. Den enda endpointen är hela ytan.

En hotellägare som ändrar sina egna priser manuellt använder extranet-verktygssatserna på api.wink.travel — /mcp/extranet/rates och vänner. Dessa är inte en del av en kanalhanterarintegration och en integratör har ingen anledning att ansluta till dem.

Kontoadministration finns också på api.wink.travel, på /mcp/settings. Det finns ingen /mcp/settings på integrationsvärden.

Varje endpoint har också ett ping-verktyg, så att du kan bekräfta att en anslutning är aktiv innan du ber den göra verkligt arbete.

Agentiska betalningar

För det kompletta resenärsbokningsflödet, anslut Wink Booking Engine på https://api.wink.travel/mcp/booking-engine och en kompatibel betalningsplånbok. Att lägga till Wink MCP öppnar webbläsarinloggning och behörighetsval; din klient hanterar sedan autentisering.

Booking Engine inkluderar destinationsuppslag, hotell- och rumsökning, agentic_booking_quote, agentic_booking_pay, agentic_booking_book, bokningshämtning och kvitton, när agentisk bokning och betalning är aktiverade för den miljön. Se Agentic Payments för anslutningsinställningar, behörigheter att välja och stegen från sökning till bekräftelse.

---

Vilka verktygssatser behöver jag?

Om du är…	Anslut till
Integrerar en kanalhanterare, PMS eller CRS	integrations.wink.travel/mcp/channel-manager — bara denna
Hantera en fastighets innehåll	/mcp/extranet/property + /mcp/extranet/facilities
Hantera rum och rumstyper	/mcp/extranet/facilities
Hantera priser och tillgänglighet	/mcp/extranet/rates
Driva dagliga reservationer	/mcp/extranet/operations
Växa distributionen	/mcp/extranet/distribution + /mcp/analytics
Bygga affiliate-sidor	/mcp/studio/curation + /mcp/studio/embeds
Driva länk-i-bio-sidor	/mcp/link-manager + /mcp/social
Boka på uppdrag av resenärer	/mcp/travel-agent
Avstämma pengar	/mcp/payment
Boka ett rum med en AI-agent	/mcp/booking-engine + en kompatibel betalningsplånbok — se Agentic Payments
Bygga en bokningsupplevelse	/mcp/booking-engine; valfritt /mcp/reference för ytterligare uppslag

Booking Engine inkluderar den grundläggande bokningsflödet. Den tillhandahåller konto- och anpassningsupptäckt, destinationsuppslag, hotelltillgänglighet och rumsprisdetaljer, kundvagnar, utcheckning och hantering av resenärsbokningar. Agentiska boknings- och betalningsverktyg ingår också när de är aktiverade för den miljön.

För en stadsbaserad hotellsökning, använd destination_lookup_search_suggestions för att lösa destinationen, sedan inventory_search_city för att hitta tillgängliga hotell och priser. Båda verktygen finns i /mcp/booking-engine, så detta flöde kräver ingen Reference-anslutning.

Lägg till /mcp/reference när du behöver stödjande uppslag som länder, valutor och växelkurser, stödda språk, tidszoner, bredare geografiska sökningar, OTA-klassificeringar eller offentlig fastighetskunskap. Dessa är valfria tillägg till bokningsflödet.

Börja med en. Lägg till en annan när du upptäcker att du frågar efter något den inte kan göra — varje anslutning är oberoende, och att lägga till en påverkar aldrig de andra.

Vill du ändå ha allt?

https://api.wink.travel/mcp och https://integrations.wink.travel/mcp är fortfarande tillgängliga och tillhandahåller alla verktyg på sin värd. De är användbara för att utforska vad som finns, men vi rekommenderar dem inte för dagligt arbete: verktygslistan är tillräckligt stor för att tränga ut din uppgift och försämra agentens verktygsval. Föredra verktygssatserna ovan.

---

Hur autentisering fungerar

Wink MCP-servrar använder OAuth2 Authorization Code + PKCE-flödet och stödjer Dynamic Client Registration (RFC 7591). Så här går det till när du ansluter första gången:

1. Din AI-klient upptäcker auktoriseringsservern från MCP-endpointens /.well-known/oauth-protected-resource metadata.
2. Klienten registrerar sig själv via Dynamic Client Registration — ingen manuell applikationsinställning krävs.
3. Klienten öppnar en webbläsarflik till https://iam.wink.travel. Du loggar in med ditt Wink-konto och godkänner de begärda behörigheterna på samtyckesskärmen.
4. Wink utfärdar en åtkomsttoken som är begränsad till ditt konto och kopplad till din identitet.
5. AI-klienten bifogar token till varje MCP-förfrågan. Alla verktygsresultat är automatiskt begränsade till din hanterande enhet.
6. Token går ut efter 3 timmar. Din AI-klient uppdaterar tyst i bakgrunden utan att fråga igen.

Varje verktygsanrop körs under din identitet — samma ACL-regler som skyddar webbportalen gäller för AI-agenten.

---

Anslut din AI-klient

Claude Code

1. Se till att Claude Code är uppdaterad:

   npm install -g @anthropic-ai/claude-code

2. Välj en verktygssats från katalogen ovan och lägg till den. Till exempel priser och tillgänglighet:

   claude mcp add wink-rates https://api.wink.travel/mcp/extranet/rates --transport http

3. Claude Code kontaktar servern, upptäcker auktoriseringsservern och öppnar din standardwebbläsare.

4. Logga in på Wink och godkänn behörighetsbegäran på samtyckesskärmen.

5. Claude Code bekräftar anslutningen. Skriv /mcp för att verifiera att servern visas och att dess verktyg har laddats.

Lägg till så många verktygssatser som ditt arbete behöver — varje är en separat serverpost med eget namn:

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

Du loggar bara in en gång. Efter första webbläsargodkännandet återanvänder Claude Code din Wink-session för ytterligare Wink-endpoints.

Dela med ditt team

Lägg till --scope project till claude mcp add så skriver Claude Code server-URL:en till .mcp.json i repo-roten. Committa den filen — varje teammedlem får samma verktygssatser, och var och en slutför sin egen webbläsarinloggning första gången de ansluter.

Claude Desktop

1. Redigera Claude Desktop-konfigurationsfilen:

   • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
   • Windows: %APPDATA%\Claude\claude_desktop_config.json
   • Linux: ~/.config/Claude/claude_desktop_config.json

2. Lägg till MCP-serverposter:

   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"
       }
     }
   }

3. Avsluta helt och starta om Claude Desktop (använd Quit från menyraden — att bara stänga fönstret räcker inte).

4. Claude Desktop öppnar en webbläsarflik för varje ny server. Logga in på Wink och godkänn behörigheter.

5. Pluggikonen i bottenverktygsfältet visar båda servrarna som anslutna.

OpenAI Codex

1. Se till att Codex CLI är installerad:

   npm install -g @openai/codex

2. Öppna (eller skapa) Codex-konfigurationsfilen:

   • macOS / Linux: ~/.codex/config.json
   • Windows: %USERPROFILE%\.codex\config.json

3. Lägg till Wink MCP-serverposter:

   ~/.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"
       }
     }
   }

4. Starta Codex. Vid första användning öppnar Codex en webbläsarflik till https://iam.wink.travel.

5. Logga in på Wink och godkänn de begärda behörigheterna.

6. Codex bekräftar anslutningen. Kör codex och be den lista tillgängliga verktyg för att verifiera att Wink-servrarna är aktiva.

Note

Codex CLI MCP-stöd kräver version 1.0 eller senare. Kör codex --version för att kontrollera, och npm install -g @openai/codex för att uppgradera.

ChatGPT

MCP-serverstöd finns i ChatGPT desktop app för Plus, Pro, Team och Enterprise-prenumeranter.

1. Ladda ner och installera ChatGPT desktop app om du inte redan har den.

2. Öppna appen och klicka på din profilikon uppe till höger, välj sedan Settings.

3. Gå till Connectors (eller MCP Servers beroende på appversion) och klicka på Add.

4. Ange URL för en verktygssats från katalogen ovan, till exempel:

   https://api.wink.travel/mcp/extranet/rates

   Klicka sedan på Connect.

5. ChatGPT öppnar en webbläsarflik till https://iam.wink.travel. Logga in på Wink och godkänn behörigheter.

6. Upprepa steg 4–5 för andra verktygssatser ditt arbete behöver, till exempel:

   https://api.wink.travel/mcp/extranet/operations

7. Varje verktygssats visas i din Connectors-lista. Starta en ny chatt — Wink-verktyg är tillgängliga automatiskt.

Begränsning i webbappen

MCP-servrar kan endast konfigureras i desktop-appen. ChatGPT:s webbgränssnitt på chatgpt.com stödjer inte anpassade MCP-servrar.

Cursor

1. Öppna (eller skapa) Cursor MCP-konfigurationsfilen:

   • macOS / Linux: ~/.cursor/mcp.json
   • Windows: %USERPROFILE%\.cursor\mcp.json

2. Lägg till Wink MCP-serverposter:

   ~/.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"
       }
     }
   }

3. Öppna Cursor. Gå till Settings → Cursor Settings → MCP och bekräfta att båda servrarna visas med grön statusindikator. Om de visar rött, klicka på Refresh.

4. Cursor öppnar en webbläsarflik till https://iam.wink.travel. Logga in på Wink och godkänn behörigheter.

5. Öppna en chatt (Ctrl+L / Cmd+L) och be Cursor lista tillgängliga Wink-verktyg för att bekräfta anslutningen.

Projektavgränsad konfig

Du kan också placera en mcp.json-fil i roten av ditt projekt istället för i ~/.cursor/. Projektkonfiguration har företräde och gör servrarna tillgängliga för varje teammedlem som öppnar projektet i Cursor.

Windsurf

1. Öppna (eller skapa) Windsurf MCP-konfigurationsfilen:

   • macOS / Linux: ~/.codeium/windsurf/mcp_config.json
   • Windows: %USERPROFILE%\.codeium\windsurf\mcp_config.json

2. Lägg till Wink MCP-serverposter:

   ~/.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"
       }
     }
   }

3. Starta om Windsurf helt (Arkiv → Avsluta, sedan öppna igen).

4. Gå till Settings → MCP Servers och verifiera att båda servrarna visas som anslutna. Windsurf öppnar en webbläsarflik till https://iam.wink.travel vid första användning.

5. Logga in på Wink och godkänn behörigheter. Servrarna blir gröna i inställningspanelen när autentisering är klar.

Note

Windsurf MCP-stöd kräver version 1.4 eller senare. Kontrollera via Hjälp → Om Windsurf och uppdatera från Windsurf-webbplatsen vid behov.

Cline (VS Code)

Cline är en VS Code-tillägg med inbyggd MCP-serverhanterare. Ingen manuell JSON-redigering krävs.

1. Installera Cline från VS Code Marketplace:

   • Öppna VS Code och tryck Ctrl+Shift+X / Cmd+Shift+X
   • Sök efter Cline och klicka på Install

2. Klicka på Cline-ikonen i aktivitetsfältet (vänster sidopanel) för att öppna Cline-panelen.

3. Klicka på MCP Servers-ikonen (pluggikon) i Cline-verktygsfältet, välj sedan Edit MCP Settings.

4. VS Code öppnar cline_mcp_settings.json. Lägg till Wink-posterna:

   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"
       }
     }
   }

5. Spara filen. Cline laddar om automatiskt och öppnar en webbläsarflik till https://iam.wink.travel.

6. Logga in på Wink och godkänn behörigheter. Båda servrarna visas som aktiva i MCP Servers-panelen.

Alternativ: lägg till via URL

I MCP Servers-panelen klickar du på Add Server och klistrar in en verktygssats-URL som https://api.wink.travel/mcp/extranet/rates direkt. Cline fyller automatiskt i konfigurationen och hanterar autentisering utan manuell JSON-redigering.

---

Behörigheter (Scopes)

När du godkänner samtyckesskärmen ser du en uppdelning av vad agenten begär. MCP-klienter använder samma behörighetsvokabulär som resten av plattformen — se fullständig scope-referens på autentiseringssidan.

Två saker är specifika för MCP:

• mcp.read mcp.write mcp.remove scopes krävs dessutom för att öppna MCP-transporten. En klient som har en mcp.*-scope släpps in till vilken Wink MCP-endpoint som helst, men varje verktyg den anropar upprätthåller fortfarande sektionens scope för den endpoint den omsluter (t.ex. booking.read).
• AI-klienten begär bara de scopes den behöver. Du kan neka individuella behörigheter på samtyckesskärmen — verktyg som kräver en nekad scope returnerar ett fel vid anrop.

Verktygssatser ändrar inget av detta. Den endpoint du ansluter till bestämmer vilka verktyg som listas, inte vad de får göra. Att ansluta till /mcp/payment ger inga finansiella behörigheter du inte redan hade, och att ansluta till /mcp/reference hindrar inte ett verktyg där från att upprätthålla sin egen scope. Auktorisering avgörs per verktygsanrop, från din token och ditt kontos behörigheter.

---

Felsökning

Webbläsarflik öppnas inte

Din AI-klient kanske inte stöder det interaktiva PKCE-flödet än. Kontrollera att du kör en aktuell version:

• Claude Code: npm install -g @anthropic-ai/claude-code
• Codex CLI: npm install -g @openai/codex
• Claude Desktop / ChatGPT desktop: uppdatera via appens inbyggda uppdaterare

401 Unauthorized efter inloggning

Din cachade token kan vara föråldrad. Ta bort och lägg till servern igen för att trigga en ny inloggning:

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

För Claude Desktop och ChatGPT, ta bort serverposten från inställningarna, starta om appen och lägg till den igen.

403 Forbidden vid anrop av specifikt verktyg

Verktyget kräver en scope du inte godkände på samtyckesskärmen, eller en behörighet ditt konto inte har. Anslut servern igen — samtyckesskärmen visas på nytt och du kan godkänna den saknade behörigheten. Om det fortfarande misslyckas behöver verktyget en kontobehörighet du inte har; att ansluta till en annan verktygssats hjälper inte, eftersom verktygssatser inte ger behörigheter.

Verktyget jag behöver finns inte i listan

Du är förmodligen ansluten till en verktygssats som inte täcker det jobbet. Kontrollera endpoint-katalogen och lägg till verktygssatsen som gör det — anslutningar är oberoende, så att lägga till en ändrar inget för de andra. Om du är osäker på vilken som har det, anslut till https://api.wink.travel/mcp tillfälligt, hitta verktyget, och se sedan vilken verktygssats som listar det.

404 Not Found på en verktygssats-endpoint

Kontrollera sökvägen noggrant — de nästlade verktygssatserna har två segment (/mcp/extranet/rates, inte /mcp/extranet-rates), och de platta har ett (/mcp/link-manager). Observera att en oauktoriserad förfrågan till någon sökväg under /mcp returnerar 401, inte 404, så enbart 401 säger inte om endpointen finns.

Jag anslöt till api.wink.travel/mcp/channel-manager och fick inget

Den endpointen finns inte. Kanalhanterarintegration serveras endast från https://integrations.wink.travel/mcp/channel-manager. Om du också behöver läsa eller skriva en fastighets egna priser manuellt är det ett separat jobb på en separat endpoint — se /mcp/extranet/rates.

Servern visas men verktygsanrop returnerar “konto hittades inte”

Du är inloggad på ett Wink-konto som inte har någon hanterande enhet. Gå till Wink Portal och se till att ditt konto är konfigurerat innan du använder MCP-servern.

Token går ut mitt i sessionen

Token är giltiga i 3 timmar. Claude Code och Claude Desktop uppdaterar token tyst utan att avbryta din session. Om du ser autentiseringsfel efter en lång inaktiv period, skriv ett nytt meddelande — klienten autentiserar om automatiskt.

Codex CLI visar “MCP server unreachable”

Kontrollera att din ~/.codex/config.json är giltig JSON (inga avslutande kommatecken) och att "type": "http" är satt. Codex kräver HTTP-transport för fjärrservrar; stdio-transport är endast för lokala binärer.

ChatGPT:s “Connectors”-meny saknas

MCP-stöd kräver ChatGPT desktop app version 1.2024.352 eller senare och en aktiv Plus-, Pro-, Team- eller Enterprise-prenumeration. Uppdatera appen och kontrollera din plan under Inställningar → Konto.

Cursor-server visar rött / “Failed to connect”

Verifiera att din ~/.cursor/mcp.json är giltig JSON och innehåller "type": "http". Gå sedan till Settings → Cursor Settings → MCP och klicka på Refresh. Om felet kvarstår, starta om Cursor helt — konfigurationsändringar plockas inte alltid upp utan omstart.

Windsurf MCP-servrar visas inte i inställningar

Windsurf kräver full omstart (inte bara fönsterladdning) för att plocka upp ändringar i mcp_config.json. Använd Arkiv → Avsluta och starta om. Om servrar fortfarande inte visas, kontrollera att du har Windsurf 1.4+ via Hjälp → Om Windsurf.

Cline “Add Server”-alternativ syns inte

MCP-serverhanteraren kräver Cline 2.0 eller senare. Öppna VS Code Extensions-panelen, hitta Cline och klicka på Update om en uppdatering finns. Efter uppdatering, ladda om VS Code (Ctrl+Shift+P → “Developer: Reload Window”).

---

Öppna Wink Portal Wink på GitHub