Servidors MCP

Les eines MCP de Wink es publiquen com a conjunts d’eines — punts finals enfocats, cadascun cobrint una feina. Connectes el teu client d’IA a un o dos que coincideixin amb la teva feina, no a tots.

Cada punt final utilitza inici de sessió interactiu OAuth2 (flux d’autorització amb codi PKCE): el teu agent d’IA obre una pestanya del navegador, inicies sessió amb el teu compte Wink, i això és tot. No cal gestionar secrets de client.

Un integrador de channel manager es connecta a un punt final

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

Un hoteler que gestiona les seves pròpies tarifes es connecta a un altre

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

---

Per què les eines estan dividides en punts finals

Wink exposa al voltant de 500 eines. Donar-les totes a un agent alhora és tècnicament possible — i una mala idea.

Les definicions d’eines consumeixen context. Cada eina que un servidor MCP anuncia es carrega a la finestra de context del model abans que faci qualsevol feina, juntament amb la seva descripció i l’esquema complet de paràmetres. Cinc-cents d’aquestes consumeixen una gran part del pressupost que necessita la teva tasca real, en cada sol·licitud.

La qualitat de la tria disminueix a mesura que la llista creix. Un agent que tria entre 500 eines amb noms similars fa pitjors eleccions que un que tria entre 40. Si integres un channel manager, aproximadament vint eines són rellevants per a tu; les altres 480 són soroll que dificulta trobar l’eina correcta.

La feina és realment separable. Algú que sincronitza disponibilitat des d’un PMS i algú que crea pàgines d’afiliats comparteixen gairebé cap eina. Dividir per feina significa que cada connexió porta el vocabulari d’una feina.

Els conjunts d'eines no són permisos

Escollir un conjunt d’eines estret no restringeix el que pot fer el teu compte, i escollir-ne un ampli no atorga res addicional. Cada eina fa complir els mateixos permisos de compte que el portal web, sota la teva identitat iniciada. Si el teu compte no pot cancel·lar una reserva al Wink Portal, l’agent tampoc pot — independentment del punt final al qual estigui connectat.

Tria conjunts d’eines per enfocament, no per seguretat.

---

Directori de punts finals

Dos hosts serveixen conjunts d’eines. El nombre d’eines és aproximat i creix amb el temps.

https://api.wink.travel — la plataforma

Punt final	Eines	Què cobreix
/mcp/extranet/facilities	~64	L’inventari reservable i in situ: habitacions i tipus d’habitació, spas, restaurants, sales de reunions, activitats, atraccions, llocs, altres articles venibles
/mcp/extranet/property	~62	El registre de la propietat i els seus termes comercials: perfil i contingut, complements, polítiques de cancel·lació, avantatges, anuncis
/mcp/settings	~60	Administració del compte: perfil i marca de l’entitat gestora, gestors i les seves autoritzacions, personalització, webhooks, preferències de notificació
/mcp/studio/embeds	~48	Publicació d’inventari curat: widgets, graelles i graelles ordenades, targetes, mapes, enllaços profunds a inventari i pàgines de proveïdors
/mcp/extranet/rates	~44	Preus i disponibilitat: períodes i allotjaments de tarifes d’inventari, plans tarifaris, tarifes mestres, tarifes especials i promocionals
/mcp/extranet/operations	~39	Gestió d’una propietat en viu: reserves i el seu cicle de vida, ressenyes i respostes de clients, fonts de calendari, tasques programades
/mcp/extranet/distribution	~37	On es ven l’inventari: canals de venda i modificadors de tarifes, sol·licituds de relació amb afiliats i proveïdors, registre, captura de clients potencials
/mcp/studio/curation	~35	Construcció de col·leccions comercialitzables: llistes estàtiques i dinàmiques, llistes ordenades, cerques guardades, agregats de propietats
/mcp/link-manager	~28	Col·leccions d’enllaços sindicats, el seu disseny, categories i etiquetes, més URLs abreujades
/mcp/reference	~24	Dades de consulta només lectura: països, monedes i tipus de canvi, idiomes, zones horàries, consultes geogràfiques, geolocalització IP
/mcp/analytics	~18	Anàlisi de reserves i ingressos: resums, gràfics de línies, classificacions, rendiment d’afiliats, mètriques de compartició
/mcp/payment	~18	Operacions financeres: llibre major, retirades i estimacions de comissions, agregats de fons de reserva
/mcp/booking-engine	~17	El camí de compra per al viatger: cerca i consulta, cistella de compra i pagament, llistes de desitjos, personalització de campanyes
/mcp/social	~17	Comptes socials connectats, publicació i programació de publicacions, lectura d’informació de publicacions
/mcp/travel-agent	~8	Reserves facilitades per agents en nom dels viatgers, i informes d’agents

https://integrations.wink.travel — integracions de channel manager

Un punt final, perquè aquest host existeix per a una feina.

Punt final	Eines	Què cobreix
/mcp/channel-manager	~9	Connexió i verificació d’una integració de channel manager, PMS o CRS

Integrar un channel manager vs. gestionar les teves pròpies tarifes

Són feines diferents per a persones diferents, i no comparteixen punt final.

Un proveïdor de channel manager, PMS o CRS integra una vegada a través de integrations.wink.travel/mcp/channel-manager, i a partir d’aleshores intercanvia propietats, tarifes, disponibilitat i reserves per aquesta integració. Aquest únic punt final és tota la superfície.

Un hoteler que canvia les seves pròpies tarifes manualment utilitza els conjunts d’eines de l’extranet a api.wink.travel — /mcp/extranet/rates i companyia. Aquests no formen part d’una integració de channel manager i un integrador no té motiu per connectar-s’hi.

L’administració del compte també és a api.wink.travel, a /mcp/settings. No hi ha /mcp/settings a l’host d’integracions.

Cada punt final també porta una eina ping, per confirmar que la connexió està activa abans de demanar que faci feina real.

Pagaments agentics

Per al flux complet de reserva del viatger, connecta Wink Booking Engine a https://api.wink.travel/mcp/booking-engine i una cartera de pagament compatible. Afegir el MCP de Wink obre l’inici de sessió al navegador i la selecció de permisos; el teu client gestiona després l’autenticació.

Booking Engine inclou la cerca de destinació, cerca d’hotel i habitació, agentic_booking_quote, agentic_booking_pay, agentic_booking_book, recuperació de reserves i rebuts, quan la reserva i el pagament agentics estan habilitats per a aquest entorn. Consulta Agentic Payments per a la configuració de connexió, els permisos a seleccionar i els passos des de la cerca fins a la confirmació.

---

Quins conjunts d’eines necessito?

Si ets…	Connecta a
Integrant un channel manager, PMS o CRS	integrations.wink.travel/mcp/channel-manager — només aquest
Gestionant el contingut d’una propietat	/mcp/extranet/property + /mcp/extranet/facilities
Gestionant habitacions i tipus d’habitació	/mcp/extranet/facilities
Gestionant preus i disponibilitat	/mcp/extranet/rates
Gestionant reserves diàries	/mcp/extranet/operations
Fent créixer la distribució	/mcp/extranet/distribution + /mcp/analytics
Creant pàgines d’afiliats	/mcp/studio/curation + /mcp/studio/embeds
Gestionant pàgines de link-in-bio	/mcp/link-manager + /mcp/social
Reservant en nom dels viatgers	/mcp/travel-agent
Conciliant diners	/mcp/payment
Reservant una habitació amb un agent d’IA	/mcp/booking-engine + una cartera de pagament compatible — consulta Agentic Payments
Creant una experiència de reserva	/mcp/booking-engine; opcionalment /mcp/reference per a consultes addicionals

Booking Engine inclou el flux bàsic de reserva. Proporciona descobriment de compte i personalització, cerca de destinació, disponibilitat d’hotel i detalls de tarifes d’habitació, cistelles de compra, pagament i gestió de reserves de viatgers. Les eines de reserva i pagament agentics també s’inclouen quan estan habilitades per a aquest entorn.

Per a una cerca d’hotel basada en ciutat, utilitza destination_lookup_search_suggestions per resoldre la destinació, després inventory_search_city per trobar hotels i tarifes disponibles. Ambdues eines són a /mcp/booking-engine, així que aquest flux no requereix una connexió de Referència.

Afegeix /mcp/reference quan necessitis consultes de suport com països, monedes i tipus de canvi, idiomes suportats, zones horàries, cerques geogràfiques més àmplies, classificacions OTA o coneixement públic de propietats. Són afegits opcionals al flux de reserva.

Comença amb un. Afegeix-ne un altre quan trobis que demanes alguna cosa que no pot fer — cada connexió és independent, i afegir-ne una no afecta les altres.

Encara vols tot?

https://api.wink.travel/mcp i https://integrations.wink.travel/mcp continuen disponibles i serveixen totes les eines del seu host. Són útils per explorar què existeix, però no els recomanem per a la feina diària: la llista d’eines és prou gran per ofegar la teva tasca i degradar la selecció d’eines de l’agent. Prefereix els conjunts d’eines anteriors.

---

Com funciona l’autenticació

Els servidors MCP de Wink utilitzen el flux OAuth2 Authorization Code + PKCE i suporten Dynamic Client Registration (RFC 7591). Això és el que passa quan et connectes per primera vegada:

1. El teu client d’IA descobreix el servidor d’autorització a partir de les metadades /.well-known/oauth-protected-resource del punt final MCP.
2. El client es registra automàticament via Dynamic Client Registration — no cal configuració manual de l’aplicació.
3. El client obre una pestanya del navegador a https://iam.wink.travel. Inicies sessió amb el teu compte Wink i aproves els permisos sol·licitats a la pantalla de consentiment.
4. Wink emet un token d’accés amb abast al teu compte i vinculat a la teva identitat.
5. El client d’IA adjunta el token a cada sol·licitud MCP. Tots els resultats d’eines s’abasten automàticament a la teva entitat gestora.
6. Els tokens expiren després de 3 hores. El teu client d’IA els renova silenciosament en segon pla sense tornar a demanar permís.

Cada trucada d’eina s’executa sota la teva identitat — s’apliquen les mateixes regles ACL que protegeixen el portal web a l’agent d’IA.

---

Connecta el teu client d’IA

Claude Code

1. Assegura’t que Claude Code està actualitzat:

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

2. Tria un conjunt d’eines del directori anterior i afegeix-lo. Per exemple, preus i disponibilitat:

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

3. Claude Code contacta el servidor, descobreix el servidor d’autorització i obre el navegador per defecte.

4. Inicia sessió a Wink i aprova la sol·licitud de permisos a la pantalla de consentiment.

5. Claude Code confirma la connexió. Escriu /mcp per verificar que el servidor apareix i que les seves eines s’han carregat.

Afegeix tants conjunts d’eines com necessiti la teva feina — cada un és una entrada de servidor separada amb el seu propi nom:

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

Només inicies sessió una vegada. Després de la primera aprovació al navegador, Claude Code reutilitza la teva sessió Wink per a punts finals Wink addicionals.

Comparteix amb el teu equip

Afegeix --scope project a claude mcp add i Claude Code escriu la URL del servidor a .mcp.json a l’arrel del repositori. Fes commit d’aquest fitxer — cada membre de l’equip obté els mateixos conjunts d’eines, i cadascú completa el seu propi inici de sessió al navegador la primera vegada que es connecta.

Claude Desktop

1. Edita el fitxer de configuració de Claude Desktop:

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

2. Afegeix les entrades dels servidors MCP:

   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. Tanca completament i reinicia Claude Desktop (usa Quit des de la barra de menú — tancar la finestra no és suficient).

4. Claude Desktop obre una pestanya del navegador per a cada nou servidor. Inicia sessió a Wink i aprova els permisos.

5. L’icona d’endoll a la barra inferior mostra ambdós servidors com a connectats.

OpenAI Codex

1. Assegura’t que Codex CLI està instal·lat:

   npm install -g @openai/codex

2. Obre (o crea) el fitxer de configuració de Codex:

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

3. Afegeix les entrades dels servidors MCP de Wink:

   ~/.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. Inicia Codex. A la primera utilització, Codex obre una pestanya del navegador a https://iam.wink.travel.

5. Inicia sessió a Wink i aprova els permisos sol·licitats.

6. Codex confirma la connexió. Executa codex i demana que llisti les eines disponibles per verificar que els servidors Wink estan actius.

Nota

El suport MCP de Codex CLI requereix la versió 1.0 o superior. Executa codex --version per comprovar-ho, i npm install -g @openai/codex per actualitzar.

ChatGPT

El suport de servidors MCP està disponible a l’aplicació d’escriptori ChatGPT per a subscriptors Plus, Pro, Team i Enterprise.

1. Descarrega i instal·la l’aplicació d’escriptori ChatGPT si encara no ho has fet.

2. Obre l’aplicació i fes clic a la icona del teu perfil a la cantonada superior dreta, després tria Configuració.

3. Ves a Connectors (o Servidors MCP segons la versió de l’aplicació) i fes clic a Afegeix.

4. Introdueix la URL d’un conjunt d’eines del directori anterior, per exemple:

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

   Després fes clic a Connecta.

5. ChatGPT obre una pestanya del navegador a https://iam.wink.travel. Inicia sessió a Wink i aprova els permisos.

6. Repeteix els passos 4–5 per a qualsevol altre conjunt d’eines que necessiti la teva feina, per exemple:

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

7. Cada conjunt d’eines apareix a la teva llista de Connectors. Comença un nou xat — les eines Wink estan disponibles automàticament.

Limitació de l’aplicació web

Els servidors MCP només es poden configurar a l’aplicació d’escriptori. La interfície web de ChatGPT a chatgpt.com no suporta servidors MCP personalitzats.

Cursor

1. Obre (o crea) el fitxer de configuració MCP de Cursor:

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

2. Afegeix les entrades dels servidors MCP de Wink:

   ~/.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. Obre Cursor. Ves a Configuració → Configuració de Cursor → MCP i comprova que ambdós servidors apareixen amb un indicador d’estat verd. Si mostren vermell, fes clic a Actualitza.

4. Cursor obre una pestanya del navegador a https://iam.wink.travel. Inicia sessió a Wink i aprova els permisos.

5. Obre un xat (Ctrl+L / Cmd+L) i demana a Cursor que llisti les eines Wink disponibles per confirmar la connexió.

Configuració amb abast de projecte

També pots col·locar un fitxer mcp.json a l’arrel del teu projecte en lloc de a ~/.cursor/. La configuració a nivell de projecte té prioritat i fa que els servidors estiguin disponibles per a cada membre de l’equip que obri el projecte a Cursor.

Windsurf

1. Obre (o crea) el fitxer de configuració MCP de Windsurf:

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

2. Afegeix les entrades dels servidors MCP de Wink:

   ~/.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. Reinicia completament Windsurf (Fitxer → Surt, després torna a obrir).

4. Ves a Configuració → Servidors MCP i comprova que ambdós servidors apareixen com a connectats. Windsurf obre una pestanya del navegador a https://iam.wink.travel a la primera utilització.

5. Inicia sessió a Wink i aprova els permisos. Els servidors es posen verds al panell de configuració un cop autenticats.

Nota

El suport MCP de Windsurf requereix la versió 1.4 o superior. Comprova-ho a través de Ajuda → Sobre Windsurf i actualitza des del lloc web de Windsurf si cal.

Cline (VS Code)

Cline és una extensió de VS Code amb un gestor de servidors MCP integrat. No cal editar JSON manualment.

1. Instal·la Cline des del Marketplace de VS Code:

   • Obre VS Code i prem Ctrl+Shift+X / Cmd+Shift+X
   • Cerca Cline i fes clic a Instal·la

2. Fes clic a la icona de Cline a la barra d’activitats (barra lateral esquerra) per obrir el panell de Cline.

3. Fes clic a la icona de Servidors MCP (icona d’endoll) a la barra d’eines de Cline, després tria Edita la configuració MCP.

4. VS Code obre cline_mcp_settings.json. Afegeix les entrades de Wink:

   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. Desa el fitxer. Cline es recarrega automàticament i obre una pestanya del navegador a https://iam.wink.travel.

6. Inicia sessió a Wink i aprova els permisos. Ambdós servidors apareixen actius al panell de Servidors MCP.

Alternativa: afegeix via URL

Al panell de Servidors MCP, fes clic a Afegeix servidor i enganxa directament una URL de conjunt d’eines com https://api.wink.travel/mcp/extranet/rates. Cline auto-completa la configuració i gestiona l’autenticació sense editar JSON manualment.

---

Abastaments

Quan aproves la pantalla de consentiment veuràs un desglossament del que l’agent està sol·licitant. Els clients MCP utilitzen el mateix vocabulari de permisos que la resta de la plataforma — consulta la referència completa d’abastaments a la pàgina d’Autenticació.

Hi ha dues coses específiques de MCP:

• Els abastaments mcp.read, mcp.write i mcp.remove són addicionalment requerits per obrir el transport MCP. Un client que tingui un abast mcp.* pot accedir a qualsevol punt final MCP de Wink, però cada eina que invoqui encara fa complir l’abast de secció del punt final que envolta (per exemple, booking.read).
• El client d’IA sol·licita només els abastaments que necessita. Pots denegar permisos individuals a la pantalla de consentiment — les eines que requereixin un abast denegat retornaran un error quan s’invoquin.

Els conjunts d’eines no canvien res d’això. El punt final al qual et connectes decideix quines eines es llisten, no què se’ls permet fer. Connectar a /mcp/payment no atorga cap permís financer que no tinguessis ja, i connectar a /mcp/reference no impedeix que una eina allà faci complir el seu propi abast. L’autorització es decideix per trucada d’eina, a partir del teu token i les autoritzacions del teu compte.

---

Resolució de problemes

No s’obre la pestanya del navegador

El teu client d’IA pot no suportar encara el flux interactiu PKCE. Verifica que tens una versió recent:

• Claude Code: npm install -g @anthropic-ai/claude-code
• Codex CLI: npm install -g @openai/codex
• Claude Desktop / ChatGPT desktop: actualitza des de l’actualitzador integrat de l’aplicació

401 Unauthorized després d’iniciar sessió

El teu token emmagatzemat pot estar caducat. Elimina i torna a afegir el servidor per forçar un nou inici de sessió:

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

Per a Claude Desktop i ChatGPT, elimina l’entrada del servidor a la configuració, reinicia l’aplicació i torna a afegir-lo.

403 Forbidden en trucar una eina específica

L’eina requereix un abast que no vas aprovar a la pantalla de consentiment, o un permís que el teu compte no té. Torna a connectar el servidor — la pantalla de consentiment apareixerà de nou i podràs aprovar el permís que falta. Si encara falla, l’eina necessita un permís de compte que no tens; connectar a un altre conjunt d’eines no ajudarà, perquè els conjunts d’eines no atorguen permisos.

L’eina que necessito no està a la llista

Probablement estàs connectat a un conjunt d’eines que no cobreix aquesta feina. Consulta el directori de punts finals i afegeix el conjunt d’eines que sí que ho fa — les connexions són independents, així que afegir-ne una no canvia res de les altres. Si no estàs segur de quin la té, connecta’t temporalment a https://api.wink.travel/mcp, troba l’eina i després consulta quin conjunt d’eines la llista.

404 Not Found en un punt final de conjunt d’eines

Revisa bé la ruta — els conjunts d’eines anidats tenen dos segments (/mcp/extranet/rates, no /mcp/extranet-rates), i els plans tenen un (/mcp/link-manager). Tingues en compte que una sol·licitud no autenticada a qualsevol ruta sota /mcp retorna 401, no 404, així que un 401 per si sol no indica si el punt final existeix.

Em vaig connectar a api.wink.travel/mcp/channel-manager i no vaig obtenir res

Aquest punt final no existeix. La integració de channel manager es serveix només des de https://integrations.wink.travel/mcp/channel-manager. Si també necessites llegir o escriure les tarifes pròpies d’una propietat manualment, això és una feina separada en un punt final separat — consulta /mcp/extranet/rates.

El servidor apareix però les trucades a eines retornen “compte no trobat”

Estàs iniciat amb un compte Wink que no té cap entitat gestora. Ves a Wink Portal i assegura’t que el teu compte està configurat abans d’utilitzar el servidor MCP.

El token caduca a mitja sessió

Els tokens són vàlids durant 3 hores. Claude Code i Claude Desktop renoven els tokens silenciosament sense interrompre la sessió. Si veus errors d’autenticació després d’un període llarg d’inactivitat, escriu un nou missatge — el client es reautenticarà automàticament.

Codex CLI mostra “MCP server unreachable”

Comprova que el teu ~/.codex/config.json és JSON vàlid (sense comes finals) i que "type": "http" està configurat. Codex requereix transport HTTP per a servidors remots; el transport stdio és només per a binaris locals.

El menú “Connectors” de ChatGPT no apareix

El suport MCP requereix la versió 1.2024.352 o superior de l’aplicació d’escriptori ChatGPT i una subscripció activa Plus, Pro, Team o Enterprise. Actualitza l’aplicació i comprova el teu pla a Configuració → Compte.

El servidor Cursor mostra vermell / “Failed to connect”

Verifica que el teu ~/.cursor/mcp.json és JSON vàlid i conté "type": "http". Després ves a Configuració → Configuració de Cursor → MCP i fes clic a Actualitza. Si l’error persisteix, reinicia completament Cursor — els canvis de configuració no sempre es detecten sense reinici.

Els servidors MCP de Windsurf no apareixen a la configuració

Windsurf requereix un reinici complet (no només recarregar la finestra) per detectar canvis a mcp_config.json. Usa Fitxer → Surt i torna a obrir. Si els servidors encara no apareixen, comprova que tens Windsurf 1.4+ a través de Ajuda → Sobre Windsurf.

L’opció “Add Server” de Cline no és visible

El gestor de servidors MCP requereix Cline 2.0 o superior. Obre el panell d’extensions de VS Code, troba Cline i fes clic a Actualitza si hi ha una actualització disponible. Després d’actualitzar, recarrega VS Code (Ctrl+Shift+P → “Developer: Reload Window”).

---

Obre Wink Portal Wink a GitHub