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.
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 httpPer 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.
Directori de punts finals
Section titled “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
Section titled “https://api.wink.travel — la plataforma”| Punt final | Eines | Què cobreix |
|---|---|---|
/mcp/extranet/facilities | ~64 | 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 | Registre de la propietat i termes comercials: perfil i contingut, complements, polítiques de cancel·lació, avantatges, anuncis |
/mcp/settings | ~60 | Administració de comptes: 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, calendaris, tasques programades |
/mcp/extranet/distribution | ~37 | On 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 | ~35 | Creació 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 | 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
Section titled “https://integrations.wink.travel — integracions de channel manager”Un punt final, perquè aquest host existeix per a una sola feina.
| Punt final | Eines | Què cobreix |
|---|---|---|
/mcp/channel-manager | ~9 | Connexió 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.
Pagaments agentics
Section titled “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 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ó.
Quins conjunts d’eines necessito?
Section titled “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 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.
Com funciona l’autenticació
Section titled “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:
- El teu client d’IA descobreix el servidor d’autorització a partir de les metadades
/.well-known/oauth-protected-resourcedel punt final MCP. - El client es registra automàticament via Dynamic Client Registration — no cal configurar manualment l’aplicació.
- 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. - Wink emet un token d’accés vinculat al teu compte i identitat.
- 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.
- 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.
Connecta el teu client d’IA
Section titled “Connecta el teu client d’IA”Afegeix cada conjunt d’eines a Claude com a connector personalitzat. No cal editar fitxers de configuració ni crear aplicacions o secrets.
-
A Claude, obre Customize › Connectors, fes clic a Add, després a Add custom connector.
-
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-managerFes clic a Continue.
-
Claude detecta l’inici de sessió de Wink. Mantingues Authentication: Sign in now i OAuth client: Register automatically, després fes clic a Add.
-
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. -
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.
-
Assegura’t que Claude Code està actualitzat:
Finestra del terminal npm install -g @anthropic-ai/claude-code -
Tria un conjunt d’eines del directori anterior i afegeix-lo. Per exemple, preus i disponibilitat:
Finestra del terminal claude mcp add wink-rates https://api.wink.travel/mcp/extranet/rates --transport http -
Claude Code contacta el servidor, descobreix el servidor d’autorització i obre el navegador per defecte.
-
Inicia sessió a Wink i aprova la sol·licitud de permisos a la pantalla de consentiment.
-
Claude Code confirma la connexió. Escriu
/mcpper verificar que el servidor apareix i que les 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 httpclaude mcp add wink-analytics https://api.wink.travel/mcp/analytics --transport httpNomé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.
-
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
- macOS:
-
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"}}} -
Tanca completament i reinicia Claude Desktop (fes servir Quit des del menú — tancar la finestra no és suficient).
-
Claude Desktop obre una pestanya del navegador per a cada servidor nou. Inicia sessió a Wink i aprova permisos.
-
L’icona d’endoll a la barra inferior mostra ambdós servidors com a connectats.
-
Assegura’t que Codex CLI està instal·lat:
Finestra del terminal npm install -g @openai/codex -
Obre (o crea) el fitxer de configuració de Codex:
- macOS / Linux:
~/.codex/config.json - Windows:
%USERPROFILE%\.codex\config.json
- macOS / Linux:
-
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"}}} -
Inicia Codex. A la primera utilització, Codex obre una pestanya del navegador a
https://iam.wink.travel. -
Inicia sessió a Wink i aprova els permisos sol·licitats.
-
Codex confirma la connexió. Executa
codexi demana que llisti les eines disponibles per verificar que els servidors Wink estan actius.
El suport de servidors MCP està disponible a l’aplicació d’escriptori ChatGPT per a subscriptors Plus, Pro, Team i Enterprise.
-
Descarrega i instal·la l’aplicació d’escriptori ChatGPT si encara no ho has fet.
-
Obre l’aplicació i fes clic a la icona del teu perfil a la cantonada superior dreta, després tria Settings.
-
Ves a Connectors (o MCP Servers segons la versió de l’aplicació) i fes clic a Add.
-
Introdueix la URL d’un conjunt d’eines del directori anterior, per exemple:
https://api.wink.travel/mcp/extranet/ratesDesprés fes clic a Connect.
-
ChatGPT obre una pestanya del navegador a
https://iam.wink.travel. Inicia sessió a Wink i aprova permisos. -
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 -
Cada conjunt d’eines apareix a la teva llista de Connectors. Comença una nova conversa — les eines Wink estan disponibles automàticament.
-
Obre (o crea) el fitxer de configuració MCP de Cursor:
- macOS / Linux:
~/.cursor/mcp.json - Windows:
%USERPROFILE%\.cursor\mcp.json
- macOS / Linux:
-
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"}}} -
Obre Cursor. Ves a Settings → Cursor Settings → MCP i comprova que ambdós servidors apareixen amb un indicador d’estat verd. Si apareixen en vermell, fes clic a Refresh.
-
Cursor obre una pestanya del navegador a
https://iam.wink.travel. Inicia sessió a Wink i aprova permisos. -
Obre una conversa (
Ctrl+L/Cmd+L) i demana a Cursor que llisti les eines Wink disponibles per confirmar la connexió.
-
Obre (o crea) el fitxer de configuració MCP de Windsurf:
- macOS / Linux:
~/.codeium/windsurf/mcp_config.json - Windows:
%USERPROFILE%\.codeium\windsurf\mcp_config.json
- macOS / Linux:
-
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"}}} -
Reinicia completament Windsurf (Fitxer → Quit, després torna a obrir).
-
Ves a Settings → MCP Servers i comprova que ambdós servidors apareixen com a connectats. Windsurf obre una pestanya del navegador a
https://iam.wink.travela la primera utilització. -
Inicia sessió a Wink i aprova permisos. Els servidors es posen verds al panell de configuració un cop autenticats.
Cline és una extensió de VS Code amb un gestor de servidors MCP integrat. No cal editar JSON manualment.
-
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 Install
- Obre VS Code i prem
-
Fes clic a la icona de Cline a la barra d’activitats (barra lateral esquerra) per obrir el panell de Cline.
-
Fes clic a la icona de MCP Servers (icona d’endoll) a la barra d’eines de Cline, després tria Edit MCP Settings.
-
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"}}} -
Desa el fitxer. Cline es recarrega automàticament i obre una pestanya del navegador a
https://iam.wink.travel. -
Inicia sessió a Wink i aprova permisos. Ambdós servidors apareixen actius al panell MCP Servers.
Àmbits
Section titled “Àmbits”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.writeimcp.removesón addicionalment requerits per obrir el transport MCP. Un client que tingui un àmbitmcp.*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.
Resolució de problemes
Section titled “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 Codeclaude mcp remove wink-ratesclaude mcp add wink-rates https://api.wink.travel/mcp/extranet/rates --transport httpPer 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
