Servidor MCP

Descripción general

El servidor MCP alojado de Wink está disponible en:

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

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

• Navegar la 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 palabras clave livianas sobre la documentación y APIs en vivo

Transporte

Usá el endpoint HTTP principal y transmisible:

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

Si tu cliente solo soporta SSE, usá:

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, ejecutá /mcp para inspeccionar el estado del servidor. Si querés compartir el servidor con todo el repositorio, agregá --scope project para que Claude Code escriba la configuración en .mcp.json.

Codex

Documentación oficial: Inicio rápido 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: Agregá 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:

• Usá la Paleta de Comandos: “MCP: List Servers” para confirmar la conexión y navegar herramientas.
• El selector de herramientas permite habilitar/deshabilitar api_search y docs_search.
• Agregá 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 centrada en la solicitud con entradas requeridas y ejemplo mínimo de payload
wink://api/{apiName}/operation/{key}/response/{status}	Vista centrada 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

Dejá query vacío para recibir sugerencias. Cada resultado incluye el URI MCP que podés 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. Ejecutá api_search con tu intención (por ejemplo “create affiliate” o “payment receipt”).
2. Abrí el URI wink://api/... devuelto, o seguí sus campos vinculados request_uri, response_uris, request_schema_uris, response_schema_uris y recipe_uri.
3. Usá 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 sobre las APIs de Wink — en lugar de adivinar endpoints, el agente lee los contratos en vivo directamente desde el servidor MCP.

Consultá AI Skills para ver 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