Ir al contenido

Servidores MCP

Las herramientas MCP de Wink se publican como conjuntos de herramientas — endpoints enfocados, cada uno cubriendo una tarea. Conectas 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, inicias sesión con tu cuenta Wink, y eso es todo. No hay secretos de cliente que 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 trabajo, 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 la lista crece. Un agente que elige entre 500 herramientas con nombres similares toma peores decisiones que uno que elige entre 40. Si integras un channel manager, aproximadamente veinte herramientas son relevantes para ti; 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 artículos 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 marca de la entidad gestora, gerentes y sus permisos, personalización, webhooks, preferencias de notificación
/mcp/studio/embeds~48Publicación de inventario curado: widgets, cuadrículas y cuadrículas 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~39Gestió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 tarifas, 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 tipos 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 clasificación, 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~17Ruta de compra para viajeros: búsqueda y consulta, carrito de compras y pago, 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 una 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, conecta Wink Booking Engine en https://api.wink.travel/mcp/booking-engine y una cartera 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 hotel y habitación, 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. Consulta 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 eres…Conéctate 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
Gestionando reservas diarias/mcp/extranet/operations
Ampliando distribución/mcp/extranet/distribution + /mcp/analytics
Creando páginas afiliadas/mcp/studio/curation + /mcp/studio/embeds
Gestionando 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 cartera 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 principal de reserva. Proporciona descubrimiento de cuenta y personalización, búsqueda de destino, disponibilidad de hotel y detalles de tarifas de habitación, carritos de compra, pago 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, usa 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.

Agrega /mcp/reference cuando necesites consultas de soporte como países, monedas y tipos 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.

Empieza con uno. Agrega otro cuando necesites algo que el primero no pueda hacer — cada conexión es independiente y agregar una nunca afecta a las otras.


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 conectas 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 aplicación.
  3. El cliente abre una pestaña del navegador a https://iam.wink.travel. Inicias sesión con tu cuenta Wink y apruebas 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 de nuevo.

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.


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

  1. En Claude, abre Customize › Connectors, haz clic en Add, luego en Add custom connector.

  2. Ingresa 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

    Haz clic en Continue.

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

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

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


Cuando apruebas 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 — consulta 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; usa la API REST para trabajo servidor a servidor.
  • El cliente de IA solicita solo los alcances que necesita. Puedes 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 conectas decide qué herramientas están listadas, no qué pueden hacer. Conectarte a /mcp/payment no otorga ningún permiso financiero que no tuvieras ya, y conectarte 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. Verifica 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: actualiza desde el actualizador integrado de la app

401 Unauthorized después de iniciar sesión

Tu token en caché puede estar obsoleto. Elimina y vuelve a agregar el servidor para forzar un nuevo inicio de sesión:

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, elimina la entrada del servidor en configuración, reinicia la app y agrégala 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. Reconecta 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 tienes; 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. Revisa el directorio de endpoints y agrega el conjunto que sí lo haga — las conexiones son independientes, así que agregar uno no cambia nada de los otros. Si no sabes cuál lo tiene, conéctate temporalmente a https://api.wink.travel/mcp, encuentra la herramienta y luego busca qué conjunto la lista.

404 Not Found en un endpoint de conjunto de herramientas

Revisa bien la ruta — los conjuntos anidados tienen dos segmentos (/mcp/extranet/rates, no /mcp/extranet-rates), y los planos tienen uno (/mcp/link-manager). Nota 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 necesitas leer o escribir las tarifas propias de una propiedad manualmente, esa es una tarea separada en un endpoint separado — consulta /mcp/extranet/rates.

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

Estás autenticado en una cuenta Wink que no tiene entidad gestora. Ve a Wink Portal y asegúrate 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, escribe un nuevo mensaje — el cliente se reautenticará automáticamente.

Codex CLI muestra “MCP server unreachable”

Verifica 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 la versión 1.2024.352 o superior de la app de escritorio ChatGPT y una suscripción activa Plus, Pro, Team o Enterprise. Actualiza la app y verifica tu plan en Settings → Account.

El servidor Cursor muestra rojo / “Failed to connect”

Verifica que tu ~/.cursor/mcp.json sea JSON válido y contenga "type": "http". Luego ve a Settings → Cursor Settings → MCP y haz clic en Refresh. Si el error persiste, reinicia completamente Cursor — los cambios de configuración no siempre se aplican sin reiniciar.

Los servidores MCP de Windsurf no aparecen en configuración

Windsurf requiere un reinicio completo (no solo recargar ventana) para aplicar cambios en mcp_config.json. Usa File → Quit y vuelve a abrir. Si los servidores aún no aparecen, confirma que estás en Windsurf 1.4+ vía Help → About Windsurf.

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

El gestor de servidores MCP requiere Cline 2.0 o superior. Abre el panel de extensiones de VS Code, busca Cline y haz clic en Update si hay una actualización disponible. Tras actualizar, recarga VS Code (Ctrl+Shift+P → “Developer: Reload Window”).


Abrir Wink Portal Wink en GitHub