Servidor MCP

Descripción general

El servidor MCP alojado de Wink está disponible en:

https://docs.mcp.wink.travel/mcp

Dirige clientes de IA compatibles (VS Code, Cursor, otros que implementen transporte MCP HTTP) a este endpoint para que puedan:

• Navegar documentación de productos y plataforma (wink://docs/...)
• Navegar especificaciones OpenAPI en vivo y documentación de operaciones (wink://api/...)
• Realizar búsquedas semánticas / por palabra clave ligeras sobre la documentación y APIs en vivo

Transporte

Usa el endpoint HTTP principal y transmisible:

https://docs.mcp.wink.travel/mcp

Si tu cliente solo soporta SSE, usa:

https://docs.mcp.wink.travel/sse

Claude Code

Documentación oficial: Conectar Claude Code a herramientas vía MCP

Anthropic recomienda el transporte HTTP remoto para servidores MCP alojados en la nube:

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

Dentro de Claude Code, ejecuta /mcp para inspeccionar el estado del servidor. Si quieres compartir el servidor con todo el repositorio, agrega --scope project para que Claude Code escriba la configuración en .mcp.json.

Codex

Documentación oficial: Inicio rápido de Docs MCP para Codex

OpenAI documenta la configuración MCP a través del CLI de Codex, y señala que la configuración se comparte con la extensión IDE:

codex mcp add wink-docs --url https://docs.mcp.wink.travel/mcp
codex mcp list

Cursor

Documentación MCP de Cursor: https://cursor.com/docs/context/mcp Configuración: Agrega servidor remoto vía ajustes MCP.

{
  "mcpServers": {
    "wink-docs": {
      "url": "https://docs.mcp.wink.travel/mcp",
    }
  }
}

VS Code

Documentación oficial: https://code.visualstudio.com/docs/copilot/customization/mcp-servers Configuración remota mínima (usuario o espacio de trabajo mcp.json):

{
  "servers": {
    "wink-docs": {
      "type": "http",
      "url": "https://docs.mcp.wink.travel/mcp"
    }
  }
}

Consejos:

• Usa la Paleta de Comandos: “MCP: List Servers” para confirmar conexión y explorar herramientas.
• El selector de herramientas te permite habilitar/deshabilitar api_search y docs_search.
• Agrega contexto: Vista de chat → Agregar contexto → Recursos MCP para adjuntar páginas de documentación.

URIs principales de recursos

URI	Descripción
wink://docs	Índice de documentación (agrupado por categoría)
wink://docs/{path}	Artículo específico de documentación (Markdown / MDX)
wink://api	Catálogo OpenAPI en vivo descubierto desde la configuración swagger de Wink
wink://api/{apiName}	Resumen compacto de API con autenticación, etiquetas, encabezados y operaciones de ejemplo
wink://api/{apiName}/operations	Listado completo de operaciones agrupadas por etiqueta
wink://api/{apiName}/operation/{key}	Detalle individual de operación (parámetros, cuerpo de solicitud, respuestas)
wink://api/{apiName}/schema/{schemaName}	Esquema de componente resuelto con campos anidados, tipos y ejemplos
wink://api/{apiName}/operation/{key}/request	Vista enfocada en la solicitud con entradas requeridas y ejemplo mínimo de carga útil
wink://api/{apiName}/operation/{key}/response/{status}	Vista enfocada en la respuesta para un código de estado específico
wink://api/{apiName}/operation/{key}/recipe	Flujo orientado a tareas para llamar correctamente a esa operación

Herramientas de búsqueda (Referencia rápida)

Herramienta	Propósito	Ejemplos típicos de consulta
api_search	Encontrar la API o operación en vivo para integrar	create affiliate, payment receipt, lookup inventory, invite manager
docs_search	Encontrar documentación conceptual / guías	authentication, webhooks, wordPress

Deja query vacío para recibir sugerencias. Cada resultado incluye el URI MCP que puedes abrir. Para resultados de operaciones, api_search también devuelve URIs vinculados de solicitud, respuesta, esquema y receta para que los agentes puedan saltar directamente al subrecurso más útil.

Patrón típico de uso

1. Ejecuta api_search con tu intención (por ejemplo “create affiliate” o “payment receipt”).
2. Abre el URI wink://api/... devuelto, o sigue sus campos vinculados request_uri, response_uris, request_schema_uris, response_schema_uris y recipe_uri.
3. Usa docs_search para conceptos de apoyo (autenticación, webhooks, flujos de trabajo).

Habilidades de IA

Las habilidades preconstruidas de agentes usan este servidor MCP como su fuente de verdad. Las habilidades le dan a tu agente de codificación un flujo de trabajo estructurado para construir contra las APIs de Wink — en lugar de adivinar endpoints, el agente lee los contratos en vivo directamente desde el servidor MCP.

Consulta AI Skills para habilidades disponibles e instrucciones de instalación.

Notas

• Cada URI devuelto puede ser abierto por el agente para contenido completo.
• El árbol wink://api es en vivo y sigue el catálogo OpenAPI corriente en lugar de un índice generado del repositorio.
• Las sugerencias aparecen automáticamente cuando las consultas están vacías.

Wink en GitHub