Serveur MCP

Vue d’ensemble

Le serveur MCP Wink hébergé est disponible à l’adresse :

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

Pointez les clients IA compatibles (VS Code, Cursor, autres implémentant le transport HTTP MCP) vers ce point de terminaison pour leur permettre de :

Parcourir la documentation produit & plateforme (wink://docs/...)
Parcourir les spécifications OpenAPI en direct et la documentation des opérations (wink://api/...)
Effectuer une recherche sémantique / par mots-clés légère sur la documentation et les API en direct

Transport

Utilisez le point de terminaison HTTP principal et streamable :

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

Si votre client ne supporte que SSE, utilisez :

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

Claude Code

Docs officielles : Connecter Claude Code aux outils via MCP

Anthropic recommande le transport HTTP distant pour les serveurs MCP hébergés dans le cloud :

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

Dans Claude Code, exécutez /mcp pour inspecter le statut du serveur. Si vous souhaitez partager le serveur avec tout le dépôt, ajoutez --scope project pour que Claude Code écrive la configuration dans .mcp.json.

Codex

Docs officielles : Démarrage rapide Docs MCP pour Codex

OpenAI documente la configuration MCP via le CLI Codex, et note que la configuration est partagée avec l’extension IDE :

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

Cursor

Docs MCP Cursor : https://cursor.com/docs/context/mcp Configuration : Ajoutez un serveur distant via les paramètres MCP.

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

VS Code

Docs officielles : https://code.visualstudio.com/docs/copilot/customization/mcp-servers Configuration distante minimale (fichier mcp.json utilisateur ou workspace) :

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

Conseils :

Utilisez la palette de commandes : « MCP : Lister les serveurs » pour confirmer la connexion et parcourir les outils.
Le sélecteur d’outils vous permet d’activer/désactiver api_search et docs_search.
Ajoutez du contexte : Vue Chat → Ajouter un contexte → Ressources MCP pour joindre des pages de documentation.

URI des ressources principales

URI	Description
`wink://docs`	Index de la documentation (groupé par catégorie)
`wink://docs/{path}`	Article de documentation spécifique (Markdown / MDX)
`wink://api`	Catalogue OpenAPI en direct découvert depuis la configuration swagger de Wink
`wink://api/{apiName}`	Résumé compact de l’API avec authentification, tags, en-têtes et opérations exemples
`wink://api/{apiName}/operations`	Liste complète des opérations groupées par tag
`wink://api/{apiName}/operation/{key}`	Détail d’une opération individuelle (paramètres, corps de requête, réponses)
`wink://api/{apiName}/schema/{schemaName}`	Schéma de composant résolu avec champs imbriqués, types et exemples
`wink://api/{apiName}/operation/{key}/request`	Vue centrée sur la requête avec entrées requises et exemple minimal de payload
`wink://api/{apiName}/operation/{key}/response/{status}`	Vue centrée sur la réponse pour un code de statut spécifique
`wink://api/{apiName}/operation/{key}/recipe`	Flux orienté tâche pour appeler correctement cette opération

Outils de recherche (référence rapide)

Outil	But	Exemples typiques de requêtes
`api_search`	Trouver l’API ou l’opération en direct à intégrer	`create affiliate`, `payment receipt`, `lookup inventory`, `invite manager`
`docs_search`	Trouver des docs conceptuelles / guides	`authentication`, `webhooks`, `wordPress`

Laissez query vide pour recevoir des suggestions. Chaque résultat inclut l’URI MCP que vous pouvez ouvrir. Pour les résultats d’opérations, api_search retourne aussi les URI liés de requête, réponse, schéma et recette pour que les agents puissent accéder directement à la sous-ressource la plus utile.

Schéma d’utilisation typique

Lancez api_search avec votre intention (ex. “create affiliate” ou “payment receipt”).
Ouvrez l’URI wink://api/... retournée, ou suivez ses champs liés request_uri, response_uris, request_schema_uris, response_schema_uris et recipe_uri.
Utilisez docs_search pour les concepts d’accompagnement (authentification, webhooks, workflows).

Compétences IA

Les compétences d’agent préconstruites utilisent ce serveur MCP comme source de vérité. Les compétences offrent à votre agent de codage un flux de travail structuré pour développer avec les API Wink — au lieu de deviner les points de terminaison, l’agent lit directement les contrats en direct depuis le serveur MCP.

Voir AI Skills pour les compétences disponibles et les instructions d’installation.

Notes

Chaque URI retournée peut être ouverte par l’agent pour accéder au contenu complet.
L’arborescence wink://api est en direct et suit le catalogue OpenAPI en amont actuel au lieu d’un index généré du dépôt.
Les suggestions apparaissent automatiquement lorsque les requêtes sont vides.

Wink sur GitHub