Servidores MCP

Wink expone dos servidores MCP autenticados. Ambos usan inicio de sesión interactivo OAuth2 (flujo de código de autorización PKCE): tu agente de IA abre una pestaña del navegador para que inicies sesión con tu cuenta Wink. No hay secretos de cliente que gestionar.

Servidor	URL	Qué hace
Inventory API	https://api.wink.travel/mcp	Inventario, reservas, tarifas, canales de venta, analíticas y todas las operaciones de la plataforma
Integrations	https://integrations.wink.travel/mcp	Integraciones con gestores de canales — sincroniza propiedades, tarifas y disponibilidad con OTAs

---

Cómo funciona la autenticación

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 a partir de los metadatos /.well-known/oauth-protected-resource del endpoint MCP.
2. El cliente se registra automáticamente mediante Registro Dinámico de Clientes — no se requiere configuración manual de la aplicación.
3. El cliente abre una pestaña del navegador en 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 vinculado a tu cuenta e identidad.
5. El cliente de IA adjunta el token a cada solicitud MCP. Todos los resultados de las herramientas se limitan automáticamente a tu entidad gestora.
6. Los tokens expiran tras 3 horas. Tu cliente de IA los renueva silenciosamente en segundo plano sin pedirte que inicies sesión de nuevo.

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

---

Conecta tu cliente de IA

Claude Code

1. Asegúrate de que Claude Code está actualizado:

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

2. Añade el servidor MCP de Wink Inventory:

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

3. Claude Code contacta al servidor, descubre el servidor de autorización y abre tu navegador predeterminado.

4. Inicia sesión en Wink y aprueba la solicitud de permisos en la pantalla de consentimiento.

5. Claude Code confirma la conexión. Escribe /mcp para verificar que el servidor aparece y sus herramientas se han cargado.

Para añadir también el servidor Integrations:

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

Comparte con tu equipo

Añade --scope project a claude mcp add y Claude Code escribirá la URL del servidor en .mcp.json en la raíz del repositorio. Haz commit de ese archivo — cada miembro del equipo completará su propio inicio de sesión en el navegador la primera vez que se conecte.

Claude Desktop

1. Edita el archivo de configuración 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. Añade las entradas de los servidores MCP:

   claude_desktop_config.json

   {
     "mcpServers": {
       "wink-inventory": {
         "type": "http",
         "url": "https://api.wink.travel/mcp"
       },
       "wink-integrations": {
         "type": "http",
         "url": "https://integrations.wink.travel/mcp"
       }
     }
   }

3. Cierra completamente y reinicia Claude Desktop (usa Salir desde la barra de menú — cerrar la ventana no es suficiente).

4. Claude Desktop abre una pestaña del navegador para cada servidor nuevo. Inicia sesión en Wink y aprueba los permisos.

5. El icono de enchufe en la barra inferior muestra ambos servidores como conectados.

OpenAI Codex

1. Asegúrate de que Codex CLI está instalado:

   npm install -g @openai/codex

2. Abre (o crea) el archivo de configuración de Codex:

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

3. Añade las entradas de los servidores MCP de Wink:

   ~/.codex/config.json

   {
     "mcpServers": {
       "wink-inventory": {
         "type": "http",
         "url": "https://api.wink.travel/mcp"
       },
       "wink-integrations": {
         "type": "http",
         "url": "https://integrations.wink.travel/mcp"
       }
     }
   }

4. Inicia Codex. En el primer uso, Codex abre una pestaña del navegador en https://iam.wink.travel.

5. Inicia sesión en Wink y aprueba los permisos solicitados.

6. Codex confirma la conexión. Ejecuta codex y pídele que liste las herramientas disponibles para verificar que los servidores Wink están activos.

Nota

El soporte MCP en Codex CLI requiere la versión 1.0 o superior. Ejecuta codex --version para comprobar y npm install -g @openai/codex para actualizar.

ChatGPT

El soporte para servidores MCP está disponible en la app de escritorio ChatGPT para suscriptores Plus, Pro, Team y Enterprise.

1. Descarga e instala la app de escritorio ChatGPT si aún no lo has hecho.

2. Abre la app y haz clic en tu icono de perfil en la esquina superior derecha, luego elige Configuración.

3. Ve a Conectores (o Servidores MCP según la versión de la app) y haz clic en Agregar.

4. Introduce la URL del servidor Wink Inventory:

   https://api.wink.travel/mcp

   Luego haz clic en Conectar.

5. ChatGPT abre una pestaña del navegador en https://iam.wink.travel. Inicia sesión en Wink y aprueba los permisos.

6. Repite los pasos 4–5 para el servidor Integrations:

   https://integrations.wink.travel/mcp

7. Ambos servidores aparecen en tu lista de Conectores. Inicia un chat nuevo — las herramientas Wink estarán disponibles automáticamente.

Limitación en la app web

Los servidores MCP solo se pueden configurar en la app de escritorio. La interfaz web de ChatGPT en chatgpt.com no soporta servidores MCP personalizados.

Cursor

1. Abre (o crea) el archivo de configuración MCP de Cursor:

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

2. Añade las entradas de los servidores MCP de Wink:

   ~/.cursor/mcp.json

   {
     "mcpServers": {
       "wink-inventory": {
         "type": "http",
         "url": "https://api.wink.travel/mcp"
       },
       "wink-integrations": {
         "type": "http",
         "url": "https://integrations.wink.travel/mcp"
       }
     }
   }

3. Abre Cursor. Ve a Configuración → Configuración de Cursor → MCP y confirma que ambos servidores aparecen con indicador de estado verde. Si están en rojo, haz clic en Actualizar.

4. Cursor abre una pestaña del navegador en https://iam.wink.travel. Inicia sesión en Wink y aprueba los permisos.

5. Abre un chat (Ctrl+L / Cmd+L) y pide a Cursor que liste las herramientas Wink disponibles para confirmar la conexión.

Configuración con alcance de proyecto

También puedes colocar un archivo mcp.json en la raíz de tu proyecto en lugar de en ~/.cursor/. La configuración a nivel de proyecto tiene prioridad y hace que los servidores estén disponibles para todos los miembros del equipo que abran el proyecto en Cursor.

Windsurf

1. Abre (o crea) el archivo de configuración MCP de Windsurf:

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

2. Añade las entradas de los servidores MCP de Wink:

   ~/.codeium/windsurf/mcp_config.json

   {
     "mcpServers": {
       "wink-inventory": {
         "type": "http",
         "url": "https://api.wink.travel/mcp"
       },
       "wink-integrations": {
         "type": "http",
         "url": "https://integrations.wink.travel/mcp"
       }
     }
   }

3. Reinicia completamente Windsurf (Archivo → Salir, luego vuelve a abrir).

4. Ve a Configuración → Servidores MCP y verifica que ambos servidores aparecen como conectados. Windsurf abre una pestaña del navegador en https://iam.wink.travel en el primer uso.

5. Inicia sesión en Wink y aprueba los permisos. Los servidores se pondrán en verde en el panel de configuración una vez autenticados.

Nota

El soporte MCP en Windsurf requiere la versión 1.4 o superior. Compruébalo en Ayuda → Acerca de Windsurf y actualiza desde la web de Windsurf si es necesario.

Cline (VS Code)

Cline es una extensión para VS Code con un gestor integrado de servidores MCP. No es necesario editar JSON manualmente.

1. Instala Cline desde el Marketplace de VS Code:

   • Abre VS Code y presiona Ctrl+Shift+X / Cmd+Shift+X
   • Busca Cline y haz clic en Instalar

2. Haz clic en el icono de Cline en la barra de actividad (barra lateral izquierda) para abrir el panel de Cline.

3. Haz clic en el icono de Servidores MCP (icono de enchufe) en la barra de herramientas de Cline, luego elige Editar configuración MCP.

4. VS Code abre cline_mcp_settings.json. Añade las entradas de Wink:

   cline_mcp_settings.json

   {
     "mcpServers": {
       "wink-inventory": {
         "type": "http",
         "url": "https://api.wink.travel/mcp"
       },
       "wink-integrations": {
         "type": "http",
         "url": "https://integrations.wink.travel/mcp"
       }
     }
   }

5. Guarda el archivo. Cline se recarga automáticamente y abre una pestaña del navegador en https://iam.wink.travel.

6. Inicia sesión en Wink y aprueba los permisos. Ambos servidores aparecen como activos en el panel de Servidores MCP.

Alternativa: añadir vía URL

En el panel de Servidores MCP, haz clic en Agregar servidor y pega directamente https://api.wink.travel/mcp. Cline autocompleta la configuración y gestiona la autenticación sin necesidad de editar JSON manualmente.

---

Alcances

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.

Dos cosas son específicas de MCP:

• Los alcances mcp.read, mcp.write y mcp.remove son además requeridos para abrir el transporte MCP. Un cliente que tenga un alcance mcp.* puede acceder a /mcp, pero cada herramienta que invoque sigue aplicando el alcance de sección del endpoint que envuelve (por ejemplo, booking.read).
• El cliente de IA solicita solo los alcances que necesita. Puedes denegar permisos individuales en la pantalla de consentimiento — las herramientas que requieran un alcance denegado devolverán un error al invocarlas.

---

Solución de problemas

No se abre la pestaña del navegador

Tu cliente de IA puede no soportar aún el flujo interactivo PKCE. Verifica que usas 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 tras iniciar sesión

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

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

Para Claude Desktop y ChatGPT, elimina la entrada del servidor en configuración, reinicia la app y añádelo de nuevo.

403 Forbidden al llamar a una herramienta específica

La herramienta requiere un alcance que no aprobaste en la pantalla de consentimiento. Reconecta el servidor — la pantalla de consentimiento aparecerá de nuevo y podrás aprobar el permiso faltante.

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

Has iniciado sesión con 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 durante 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 periodo inactivo, escribe un nuevo mensaje — el cliente se reautenticará automáticamente.

Codex CLI muestra “MCP server unreachable”

Verifica que tu ~/.codex/config.json es 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ú “Conectores” 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 Configuración → Cuenta.

El servidor Cursor aparece en rojo / “Error al conectar”

Verifica que tu ~/.cursor/mcp.json es JSON válido y contiene "type": "http". Luego ve a Configuración → Configuración de Cursor → MCP y haz clic en Actualizar. Si el error persiste, reinicia completamente Cursor — los cambios en configuración no siempre se detectan sin reinicio.

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. Usa Archivo → Salir y vuelve a abrir. Si los servidores siguen sin aparecer, confirma que usas Windsurf 1.4+ en Ayuda → Acerca de Windsurf.

La opción “Agregar servidor” 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 Actualizar si hay una actualización disponible. Tras actualizar, recarga VS Code (Ctrl+Shift+P → “Developer: Reload Window”).

---

Abrir Wink Portal Wink en GitHub