Saltar al contingut

Servidors MCP

Les eines MCP de Wink es publiquen com a conjunts d’eines — punts finals enfocats, cadascun cobrint una tasca. Connectes el teu client d’IA només als un o dos que coincideixen 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

Section titled “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 tasca significa que cada connexió porta el vocabulari d’una sola feina.


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

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

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

Section titled “https://integrations.wink.travel — integracions de channel manager”

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

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

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

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 consulta 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 aquell 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ó.


Si ets…Connecta a
Integrant un channel manager, PMS o CRSintegrations.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 principal de reserva. Proporciona descobriment de compte i personalització, consulta de destinació, disponibilitat d’hotel i detalls de tarifes d’habitació, cistelles de compra, pagament i gestió de reserves de viatgers. També inclou eines de reserva i pagament agentics quan estan habilitades per a aquell 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 estan 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 complements 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.


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 configurar manualment 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 vinculat al teu compte i identitat.
  5. El client d’IA adjunta el token a cada sol·licitud MCP. Tots els resultats d’eines s’apliquen 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 amb la teva identitat — s’apliquen les mateixes regles ACL que protegeixen el portal web a l’agent d’IA.


Afegeix cada conjunt d’eines a Claude com a connector personalitzat. No cal editar fitxers de configuració ni crear aplicacions o secrets.

  1. A Claude, obre Customize › Connectors, fes clic a Add, després a Add custom connector.

  2. Introdueix un Nom (per exemple Wink Link manager) i, com a URL del servidor MCP, un conjunt d’eines del directori anterior, per exemple:

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

    Fes clic a Continue.

  3. Claude detecta l’inici de sessió de Wink. Mantingues Authentication: Sign in now i OAuth client: Register automatically, després fes clic a Add.

  4. Fes clic a Connect. S’obre una pàgina d’inici de sessió de Wink a https://iam.wink.travel. Inicia sessió a Wink i aprova els permisos a la pantalla de consentiment.

  5. Les eines del connector ja estan disponibles a les teves converses. Repeteix per a cada conjunt d’eines que necessiti la teva feina; cada un és un connector propi.


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’àmbits a la pàgina d’Autenticació.

Tres coses són específiques de MCP:

  • Els àmbits mcp.read, mcp.write i mcp.remove són addicionalment requerits per obrir el transport MCP. Un client que tingui un àmbit mcp.* pot accedir a qualsevol punt final MCP de Wink, però cada eina que invoqui encara aplica l’àmbit de secció del punt final que encapsula (per exemple, booking.read).
  • MCP sempre actua com un usuari autenticat. El client d’IA rep els àmbits mcp.* a través del teu inici de sessió, mai d’una Aplicació que creïs. Els tokens de màquina a màquina (client-credentials) no poden obrir el transport MCP; utilitza l’API REST per a treballs servidor a servidor.
  • El client d’IA sol·licita només els àmbits que necessita. Pots denegar permisos individuals a la pantalla de consentiment — les eines que requereixen un àmbit 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è estan permeses a 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à apliqui el seu propi àmbit. L’autorització es decideix per trucada d’eina, a partir del teu token i les autoritzacions del teu compte.


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ó:

Finestra del terminal
# 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 de la configuració, reinicia l’aplicació i torna a afegir-lo.

403 Forbidden en trucar una eina específica

L’eina requereix un àmbit 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 aquella 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 saps quin la té, connecta 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

Comprova bé la ruta — els conjunts d’eines anidats tenen dos segments (/mcp/extranet/rates, no /mcp/extranet-rates), i els plans tenen un segment (/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 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, és una feina separada en un punt final separat — consulta /mcp/extranet/rates.

El servidor apareix però les trucades a eines retornen “account not found”

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

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 Settings → Cursor Settings → MCP i fes clic a Refresh. 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. Fes servir File → Quit i torna a obrir. Si els servidors encara no apareixen, comprova que tens Windsurf 1.4+ a Help → About 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, busca Cline i fes clic a Update 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