Ir al contenido

Servidores MCP

Las herramientas MCP de Wink se publican como conjuntos de herramientas — endpoints enfocados, cada uno cubriendo una tarea. Conectás tu cliente de IA solo a uno o dos que coincidan con tu trabajo, no a todos.

Cada endpoint usa inicio de sesión interactivo OAuth2 (flujo de código de autorización PKCE): tu agente de IA abre una pestaña del navegador, iniciás sesión con tu cuenta Wink, y listo. No hay secretos de cliente para gestionar.

Un integrador de channel manager se conecta a un endpoint
claude mcp add wink-channel-manager https://integrations.wink.travel/mcp/channel-manager --transport http
Un hotelero que gestiona sus propias tarifas se conecta a otro
claude mcp add wink-rates https://api.wink.travel/mcp/extranet/rates --transport http

Por qué las herramientas están divididas en endpoints

Sección titulada «Por qué las herramientas están divididas en endpoints»

Wink expone alrededor de 500 herramientas. Entregar todas a un agente a la vez es técnicamente posible — y una mala idea.

Las definiciones de herramientas consumen contexto. Cada herramienta que un servidor MCP anuncia se carga en la ventana de contexto del modelo antes de que realice cualquier tarea, junto con su descripción y esquema completo de parámetros. Quinientas de esas consumen una gran parte del presupuesto que tu tarea real necesita, en cada solicitud.

La calidad de elección disminuye a medida que crece la lista. Un agente que elige entre 500 herramientas con nombres similares toma peores decisiones que uno que elige entre 40. Si integrás un channel manager, aproximadamente veinte herramientas son relevantes para vos; las otras 480 son ruido que dificulta encontrar la herramienta correcta.

El trabajo es genuinamente separable. Alguien sincronizando disponibilidad desde un PMS y alguien creando páginas afiliadas comparten casi ninguna herramienta. Dividir por tarea significa que cada conexión lleva el vocabulario de una tarea.


Dos hosts sirven conjuntos de herramientas. Los conteos de herramientas son aproximados y crecen con el tiempo.

EndpointHerramientasQué cubre
/mcp/extranet/facilities~64Inventario reservable y en sitio: habitaciones y tipos de habitación, spas, restaurantes, salas de reuniones, actividades, atracciones, lugares, otros ítems vendibles
/mcp/extranet/property~62Registro de la propiedad y sus términos comerciales: perfil y contenido, complementos, políticas de cancelación, beneficios, anuncios
/mcp/settings~60Administración de cuenta: perfil y branding de la entidad gestora, gerentes y sus permisos, personalización, webhooks, preferencias de notificación
/mcp/studio/embeds~48Publicación de inventario curado: widgets, grillas y grillas clasificadas, tarjetas, mapas, enlaces profundos a inventario y páginas de proveedores
/mcp/extranet/rates~44Precios y disponibilidad: períodos y cupos de tarifas de inventario, planes tarifarios, tarifas maestras, tarifas especiales y promocionales
/mcp/extranet/operations~39Operación de una propiedad en vivo: reservas y su ciclo de vida, reseñas y respuestas de huéspedes, feeds de calendario, tareas programadas
/mcp/extranet/distribution~37Dónde se vende el inventario: canales de venta y modificadores de tarifa, solicitudes de relación con afiliados y proveedores, registro, captura de leads
/mcp/studio/curation~35Construcción de colecciones comercializables: listas estáticas y dinámicas, listas clasificadas, búsquedas guardadas, agregados de propiedades
/mcp/link-manager~28Colecciones de enlaces sindicados, su diseño, categorías y etiquetas, además de URLs acortadas
/mcp/reference~24Datos de consulta solo lectura: países, monedas y tasas de cambio, idiomas, zonas horarias, consultas geográficas, geolocalización IP
/mcp/analytics~18Análisis de reservas e ingresos: resúmenes, gráficos de líneas, tablas de líderes, rendimiento de afiliados, métricas de participación
/mcp/payment~18Operaciones financieras: libro mayor, retiros y estimaciones de tarifas, agregados de fondos de reserva
/mcp/booking-engine~17Camino de compra para viajeros: búsqueda y consulta, carrito de compras y checkout, listas de deseos, personalización de campañas
/mcp/social~17Cuentas sociales conectadas, publicación y programación de posts, lectura de insights de posts
/mcp/travel-agent~8Reservas facilitadas por agentes en nombre de viajeros, y reportes de agentes

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

Sección titulada «https://integrations.wink.travel — integraciones de channel manager»

Un endpoint, porque este host existe para una sola tarea.

EndpointHerramientasQué cubre
/mcp/channel-manager~9Conexión y verificación de integración de channel manager, PMS o CRS

Cada endpoint también incluye una herramienta ping, para que puedas confirmar que la conexión está activa antes de pedirle que haga trabajo real.

Para el flujo completo de reserva de viajeros, conectá Wink Booking Engine en https://api.wink.travel/mcp/booking-engine y una billetera de pago compatible. Agregar el MCP de Wink abre el inicio de sesión en el navegador y la selección de permisos; tu cliente luego maneja la autenticación.

Booking Engine incluye búsqueda de destino, búsqueda de hoteles y habitaciones, agentic_booking_quote, agentic_booking_pay, agentic_booking_book, recuperación de reservas y recibos, cuando la reserva y pago agenticos están habilitados para ese entorno. Consultá Pagos Agenticos para la configuración de conexión, los permisos a seleccionar y los pasos desde la búsqueda hasta la confirmación.


Si sos…Conectate a
Integrando un channel manager, PMS o CRSintegrations.wink.travel/mcp/channel-manager — solo este
Gestionando el contenido de una propiedad/mcp/extranet/property + /mcp/extranet/facilities
Gestionando habitaciones y tipos de habitación/mcp/extranet/facilities
Gestionando precios y disponibilidad/mcp/extranet/rates
Manejando reservas diarias/mcp/extranet/operations
Expandiendo distribución/mcp/extranet/distribution + /mcp/analytics
Creando páginas afiliadas/mcp/studio/curation + /mcp/studio/embeds
Manejando páginas link-in-bio/mcp/link-manager + /mcp/social
Reservando en nombre de viajeros/mcp/travel-agent
Conciliando dinero/mcp/payment
Reservando una habitación con un agente de IA/mcp/booking-engine + una billetera de pago compatible — ver Pagos Agenticos
Construyendo una experiencia de reserva/mcp/booking-engine; opcionalmente /mcp/reference para consultas adicionales

Booking Engine incluye el flujo central de reserva. Proporciona descubrimiento de cuenta y personalización, búsqueda de destino, disponibilidad de hoteles y detalles de tarifas de habitaciones, carritos de compra, checkout y gestión de reservas de viajeros. Las herramientas de reserva y pago agenticos también están incluidas cuando están habilitadas para ese entorno.

Para una búsqueda de hotel basada en ciudad, usá destination_lookup_search_suggestions para resolver el destino, luego inventory_search_city para encontrar hoteles y tarifas disponibles. Ambas herramientas están en /mcp/booking-engine, por lo que este flujo no requiere conexión a Reference.

Agregá /mcp/reference cuando necesites consultas de soporte como países, monedas y tasas de cambio, idiomas soportados, zonas horarias, búsquedas geográficas más amplias, clasificaciones OTA o conocimiento público de propiedades. Son adiciones opcionales al flujo de reserva.

Empezá con uno. Agregá otro cuando necesites algo que el primero no pueda hacer — cada conexión es independiente y agregar uno nunca afecta a los demás.


Los servidores MCP de Wink usan el flujo OAuth2 Authorization Code + PKCE y soportan Registro Dinámico de Clientes (RFC 7591). Esto es lo que sucede cuando te conectás por primera vez:

  1. Tu cliente de IA descubre el servidor de autorización desde los metadatos /.well-known/oauth-protected-resource del endpoint MCP.
  2. El cliente se registra automáticamente vía Registro Dinámico de Clientes — no se requiere configuración manual de la aplicación.
  3. El cliente abre una pestaña del navegador a https://iam.wink.travel. Iniciás sesión con tu cuenta Wink y aprobás los permisos solicitados en la pantalla de consentimiento.
  4. Wink emite un token de acceso con alcance para tu cuenta y vinculado a tu identidad.
  5. El cliente de IA adjunta el token a cada solicitud MCP. Todos los resultados de herramientas se limitan automáticamente a tu entidad gestora.
  6. Los tokens expiran después de 3 horas. Tu cliente de IA los renueva silenciosamente en segundo plano sin pedirte que inicies sesión otra vez.

Cada llamada a una herramienta se ejecuta bajo tu identidad — las mismas reglas ACL que protegen el portal web se aplican al agente de IA.


Agregá cada conjunto de herramientas a Claude como un conector personalizado. No hay archivo de configuración para editar ni aplicación o secreto para crear.

  1. En Claude, abrí Customize › Connectors, hacé clic en Add, luego en Add custom connector.

  2. Ingresá un Nombre (por ejemplo Wink Link manager) y, como URL del servidor MCP, un conjunto de herramientas del directorio arriba, por ejemplo:

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

    Hacé clic en Continue.

  3. Claude detecta el inicio de sesión de Wink. Mantené Authentication: Sign in now y OAuth client: Register automatically, luego hacé clic en Add.

  4. Hacé clic en Connect. Se abre una página de inicio de sesión de Wink en https://iam.wink.travel. Iniciá sesión en Wink y aprobá los permisos en la pantalla de consentimiento.

  5. Las herramientas del conector ya están disponibles en tus chats. Repetí para cada conjunto de herramientas que necesite tu trabajo; cada uno es su propio conector.


Cuando aprobás la pantalla de consentimiento verás un desglose de lo que el agente está solicitando. Los clientes MCP usan el mismo vocabulario de permisos que el resto de la plataforma — consultá la referencia completa de alcances en la página de Autenticación.

Tres cosas son específicas de MCP:

  • Los alcances mcp.read, mcp.write y mcp.remove son requeridos adicionalmente para abrir el transporte MCP. Un cliente que tenga un alcance mcp.* puede acceder a cualquier endpoint MCP de Wink, pero cada herramienta que invoque sigue aplicando el alcance de sección del endpoint que envuelve (por ejemplo, booking.read).
  • MCP siempre actúa como un usuario autenticado. El cliente de IA recibe los alcances mcp.* a través de tu inicio de sesión, nunca de una Aplicación que crees. Los tokens máquina a máquina (client-credentials) no pueden abrir el transporte MCP; usá la API REST para trabajo servidor a servidor.
  • El cliente de IA solicita solo los alcances que necesita. Podés negar permisos individuales en la pantalla de consentimiento — las herramientas que requieran un alcance denegado devolverán un error al invocarlas.

Los conjuntos de herramientas no cambian nada de esto. El endpoint al que te conectás decide qué herramientas están listadas, no qué pueden hacer. Conectarse a /mcp/payment no otorga ningún permiso financiero que no tengas ya, y conectarse a /mcp/reference no impide que una herramienta allí aplique su propio alcance. La autorización se decide por llamada a herramienta, a partir de tu token y los permisos de tu cuenta.


No se abre la pestaña del navegador

Tu cliente de IA puede no soportar aún el flujo interactivo PKCE. Verificá que estés usando una versión reciente:

  • Claude Code: npm install -g @anthropic-ai/claude-code
  • Codex CLI: npm install -g @openai/codex
  • Claude Desktop / ChatGPT desktop: actualizá desde el actualizador incorporado de la app

401 Unauthorized después de iniciar sesión

Tu token en caché puede estar obsoleto. Eliminá y agregá de nuevo el servidor para forzar un inicio de sesión fresco:

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

Para Claude Desktop y ChatGPT, eliminá la entrada del servidor en configuración, reiniciá la app y agregala de nuevo.

403 Forbidden al llamar a una herramienta específica

La herramienta requiere un alcance que no aprobaste en la pantalla de consentimiento, o un permiso que tu cuenta no tiene. Reconectá el servidor — la pantalla de consentimiento aparecerá de nuevo y podrás aprobar el permiso faltante. Si sigue fallando, la herramienta necesita un permiso de cuenta que no tenés; conectarte a otro conjunto de herramientas no ayudará, porque los conjuntos no otorgan permisos.

La herramienta que necesito no está en la lista

Probablemente estés conectado a un conjunto de herramientas que no cubre esa tarea. Revisá el directorio de endpoints y agregá el conjunto que sí lo haga — las conexiones son independientes, así que agregar uno no cambia nada de los demás. Si no estás seguro cuál lo tiene, conectate temporalmente a https://api.wink.travel/mcp, encontrá la herramienta y luego buscá qué conjunto la lista.

404 Not Found en un endpoint de conjunto de herramientas

Revisá bien la ruta — los conjuntos anidados tienen dos segmentos (/mcp/extranet/rates, no /mcp/extranet-rates), y los planos tienen uno (/mcp/link-manager). Tené en cuenta que una solicitud no autenticada a cualquier ruta bajo /mcp devuelve 401, no 404, así que un 401 solo no indica si el endpoint existe.

Me conecté a api.wink.travel/mcp/channel-manager y no obtuve nada

Ese endpoint no existe. La integración de channel manager se sirve solo desde https://integrations.wink.travel/mcp/channel-manager. Si también necesitás leer o escribir las tarifas propias de una propiedad manualmente, esa es una tarea separada en un endpoint separado — ver /mcp/extranet/rates.

El servidor aparece pero las llamadas a herramientas devuelven “cuenta no encontrada”

Estás conectado a una cuenta Wink que no tiene entidad gestora. Entrá a Wink Portal y asegurate de que tu cuenta esté configurada antes de usar el servidor MCP.

El token expira en medio de la sesión

Los tokens son válidos por 3 horas. Claude Code y Claude Desktop renuevan tokens silenciosamente sin interrumpir tu sesión. Si ves errores de autenticación tras un largo período inactivo, escribí un nuevo mensaje — el cliente se reautenticará automáticamente.

Codex CLI muestra “MCP server unreachable”

Verificá que tu ~/.codex/config.json sea JSON válido (sin comas finales) y que "type": "http" esté configurado. Codex requiere transporte HTTP para servidores remotos; el transporte stdio es solo para binarios locales.

El menú “Connectors” de ChatGPT no aparece

El soporte MCP requiere versión 1.2024.352 o superior de la app de escritorio ChatGPT y una suscripción activa Plus, Pro, Team o Enterprise. Actualizá la app y verificá tu plan en Settings → Account.

El servidor Cursor muestra rojo / “Failed to connect”

Verificá que tu ~/.cursor/mcp.json sea JSON válido y contenga "type": "http". Luego andá a Settings → Cursor Settings → MCP y hacé clic en Refresh. Si el error persiste, reiniciá completamente Cursor — los cambios en configuración no siempre se detectan sin reiniciar.

Los servidores MCP de Windsurf no aparecen en configuración

Windsurf requiere un reinicio completo (no solo recargar ventana) para detectar cambios en mcp_config.json. Usá Archivo → Salir y relanzá. Si los servidores siguen sin aparecer, confirmá que estás en Windsurf 1.4+ vía Ayuda → Acerca de Windsurf.

La opción “Add Server” en Cline no es visible

El gestor de servidores MCP requiere Cline 2.0 o superior. Abrí el panel de Extensiones de VS Code, buscá Cline y hacé clic en Actualizar si hay una actualización disponible. Después de actualizar, recargá VS Code (Ctrl+Shift+P → “Developer: Reload Window”).


Abrir Wink Portal Wink en GitHub