Serveurs MCP
Les outils MCP de Wink sont publiés sous forme de ensembles d’outils — des points de terminaison ciblés, chacun couvrant un métier. Vous connectez votre client IA à un ou deux qui correspondent à votre travail, pas à tous.
Chaque point de terminaison utilise une connexion OAuth2 interactive (flux d’autorisation par code PKCE) : votre agent IA ouvre un onglet navigateur, vous vous connectez avec votre compte Wink, et c’est tout. Aucun secret client à gérer.
claude mcp add wink-channel-manager https://integrations.wink.travel/mcp/channel-manager --transport httpclaude mcp add wink-rates https://api.wink.travel/mcp/extranet/rates --transport httpPourquoi les outils sont répartis sur plusieurs points de terminaison
Section intitulée « Pourquoi les outils sont répartis sur plusieurs points de terminaison »Wink expose environ 500 outils. Les fournir tous à un agent en même temps est techniquement possible — mais une mauvaise idée.
Les définitions d’outils consomment du contexte. Chaque outil qu’un serveur MCP annonce est chargé dans la fenêtre de contexte du modèle avant qu’il ne fasse quoi que ce soit, avec sa description et son schéma complet de paramètres. Cinq cents de ces outils consomment une grande partie du budget dont votre tâche réelle a besoin, à chaque requête.
La qualité du choix diminue avec la taille de la liste. Un agent qui choisit parmi 500 outils aux noms similaires fait de moins bons choix qu’un agent qui choisit parmi 40. Si vous intégrez un channel manager, environ vingt outils vous concernent ; les 480 autres sont du bruit qui rend l’outil juste plus difficile à trouver.
Le travail est réellement séparable. Quelqu’un qui synchronise la disponibilité depuis un PMS et quelqu’un qui crée des pages affiliées partagent presque aucun outil. Séparer par métier signifie que chaque connexion porte le vocabulaire d’un métier.
Répertoire des points de terminaison
Section intitulée « Répertoire des points de terminaison »Deux hôtes servent des ensembles d’outils. Les nombres d’outils sont approximatifs et évoluent dans le temps.
https://api.wink.travel — la plateforme
Section intitulée « https://api.wink.travel — la plateforme »| Point de terminaison | Outils | Ce qu’il couvre |
|---|---|---|
/mcp/extranet/facilities | ~64 | L’inventaire réservable et sur site : chambres et types de chambres, spas, restaurants, salles de réunion, activités, attractions, lieux, autres articles vendables |
/mcp/extranet/property | ~62 | La fiche de propriété et ses conditions commerciales : profil et contenu, options, politiques d’annulation, avantages, annonces |
/mcp/settings | ~60 | Administration du compte : profil et image de l’entité gestionnaire, gestionnaires et leurs droits, personnalisation, webhooks, préférences de notification |
/mcp/studio/embeds | ~48 | Publication d’inventaire sélectionné : widgets, grilles et grilles classées, cartes, cartes, liens profonds vers inventaire et pages fournisseurs |
/mcp/extranet/rates | ~44 | Tarifs et disponibilités : périodes et allotements de tarifs d’inventaire, plans tarifaires, tarifs maîtres, tarifs spéciaux et promotionnels |
/mcp/extranet/operations | ~39 | Gestion d’une propriété en direct : réservations et leur cycle de vie, avis clients et réponses, flux de calendrier, tâches planifiées |
/mcp/extranet/distribution | ~37 | Où l’inventaire est vendu : canaux de vente et modificateurs de tarifs, demandes de relations affiliées et fournisseurs, enregistrement, capture de leads |
/mcp/studio/curation | ~35 | Création de collections commercialisables : listes statiques et dynamiques, listes classées, recherches sauvegardées, agrégats de propriétés |
/mcp/link-manager | ~28 | Collections de liens syndiqués, leur design, catégories et tags, plus URLs raccourcies |
/mcp/reference | ~24 | Données de référence en lecture seule : pays, devises et taux de change, langues, fuseaux horaires, recherches géographiques, géolocalisation IP |
/mcp/analytics | ~18 | Analyses de réservations et revenus : vues d’ensemble, graphiques, classements, performances affiliées, métriques de partage |
/mcp/payment | ~18 | Opérations financières : grand livre, retraits et estimations de frais, agrégats de fonds de réservation |
/mcp/booking-engine | ~17 | Parcours d’achat côté voyageur : recherche et consultation, panier et paiement, listes de souhaits, personnalisation de campagnes |
/mcp/social | ~17 | Comptes sociaux connectés, publication et planification de posts, lecture des insights des posts |
/mcp/travel-agent | ~8 | Réservations facilitées par agent pour les voyageurs, et rapports d’agent |
https://integrations.wink.travel — intégrations channel manager
Section intitulée « https://integrations.wink.travel — intégrations channel manager »Un seul point de terminaison, car cet hôte existe pour un seul métier.
| Point de terminaison | Outils | Ce qu’il couvre |
|---|---|---|
/mcp/channel-manager | ~9 | Connexion et vérification d’une intégration channel manager, PMS ou CRS |
Chaque point de terminaison porte aussi un outil ping, pour confirmer qu’une connexion est active avant de lui demander un vrai travail.
Paiements agentiques
Section intitulée « Paiements agentiques »Pour le parcours complet de réservation voyageur, connectez Wink Booking Engine à https://api.wink.travel/mcp/booking-engine et un portefeuille de paiement compatible. Ajouter le MCP Wink ouvre la connexion navigateur et la sélection des permissions ; votre client gère ensuite l’authentification.
Booking Engine inclut la recherche de destination, la recherche d’hôtels et de chambres, agentic_booking_quote, agentic_booking_pay, agentic_booking_book, la récupération des réservations et des reçus, lorsque la réservation et le paiement agentiques sont activés pour cet environnement. Voir Agentic Payments pour la configuration de la connexion, les permissions à sélectionner et les étapes de la recherche à la confirmation.
Quels ensembles d’outils me faut-il ?
Section intitulée « Quels ensembles d’outils me faut-il ? »| Si vous êtes… | Connectez-vous à |
|---|---|
| Intégrateur channel manager, PMS ou CRS | integrations.wink.travel/mcp/channel-manager — uniquement celui-ci |
| Gestionnaire de contenu d’une propriété | /mcp/extranet/property + /mcp/extranet/facilities |
| Gestionnaire de chambres et types de chambres | /mcp/extranet/facilities |
| Gestionnaire des prix et disponibilités | /mcp/extranet/rates |
| Gestionnaire des réservations au quotidien | /mcp/extranet/operations |
| Développement de la distribution | /mcp/extranet/distribution + /mcp/analytics |
| Création de pages affiliées | /mcp/studio/curation + /mcp/studio/embeds |
| Gestion de pages link-in-bio | /mcp/link-manager + /mcp/social |
| Réservation au nom des voyageurs | /mcp/travel-agent |
| Rapprochement financier | /mcp/payment |
| Réservation de chambre avec un agent IA | /mcp/booking-engine + un portefeuille de paiement compatible — voir Agentic Payments |
| Création d’une expérience de réservation | /mcp/booking-engine ; optionnellement /mcp/reference pour recherches complémentaires |
Booking Engine inclut le flux principal de réservation. Il fournit la découverte de compte et personnalisation, la recherche de destination, la disponibilité d’hôtels et détails tarifs-chambres, les paniers, le paiement et la gestion des réservations voyageur. Les outils de réservation et paiement agentiques sont aussi inclus quand activés pour cet environnement.
Pour une recherche d’hôtel basée sur une ville, utilisez destination_lookup_search_suggestions pour résoudre la destination, puis inventory_search_city pour trouver hôtels et tarifs disponibles. Ces deux outils sont dans /mcp/booking-engine, donc ce flux ne nécessite pas de connexion Reference.
Ajoutez /mcp/reference quand vous avez besoin de recherches complémentaires comme pays, devises et taux de change, langues supportées, fuseaux horaires, recherches géographiques plus larges, classifications OTA, ou connaissances publiques sur les propriétés. Ce sont des ajouts optionnels au flux de réservation.
Commencez par un seul. Ajoutez-en un autre quand vous vous rendez compte qu’il vous manque quelque chose — chaque connexion est indépendante, et en ajouter une ne change rien aux autres.
Comment fonctionne l’authentification
Section intitulée « Comment fonctionne l’authentification »Les serveurs MCP Wink utilisent le flux OAuth2 Authorization Code + PKCE et supportent Dynamic Client Registration (RFC 7591). Voici ce qui se passe lors de votre première connexion :
- Votre client IA découvre le serveur d’autorisation depuis les métadonnées
/.well-known/oauth-protected-resourcedu point de terminaison MCP. - Le client s’auto-enregistre via Dynamic Client Registration — aucune configuration manuelle d’application requise.
- Le client ouvre un onglet navigateur vers
https://iam.wink.travel. Vous vous connectez avec votre compte Wink et approuvez les permissions demandées sur l’écran de consentement. - Wink émet un jeton d’accès lié à votre compte et à votre identité.
- Le client IA joint ce jeton à chaque requête MCP. Tous les résultats d’outils sont automatiquement limités à votre entité gestionnaire.
- Les jetons expirent après 3 heures. Votre client IA les renouvelle silencieusement en arrière-plan sans nouvelle demande.
Chaque appel d’outil s’exécute sous votre identité — les mêmes règles ACL qui protègent le portail web s’appliquent à l’agent IA.
Connectez votre client IA
Section intitulée « Connectez votre client IA »Ajoutez chaque ensemble d’outils à Claude comme connecteur personnalisé. Il n’y a pas de fichier de configuration à éditer ni d’application ou secret à créer.
-
Dans Claude, ouvrez Customize › Connectors, cliquez sur Add, puis Add custom connector.
-
Entrez un Nom (par exemple Wink Link manager) et, comme URL du serveur MCP, un ensemble d’outils du répertoire ci-dessus, par exemple :
https://api.wink.travel/mcp/link-managerCliquez sur Continue.
-
Claude détecte la connexion Wink. Gardez Authentication: Sign in now et OAuth client: Register automatically, puis cliquez sur Add.
-
Cliquez sur Connect. Une page de connexion Wink s’ouvre à
https://iam.wink.travel. Connectez-vous à Wink et approuvez les permissions sur l’écran de consentement. -
Les outils du connecteur sont maintenant disponibles dans vos conversations. Répétez pour chaque ensemble d’outils dont votre travail a besoin ; chacun est un connecteur distinct.
-
Assurez-vous que Claude Code est à jour :
Fenêtre de terminal npm install -g @anthropic-ai/claude-code -
Choisissez un ensemble d’outils dans le répertoire ci-dessus et ajoutez-le. Par exemple, tarifs et disponibilités :
Fenêtre de terminal claude mcp add wink-rates https://api.wink.travel/mcp/extranet/rates --transport http -
Claude Code contacte le serveur, découvre le serveur d’autorisation, et ouvre votre navigateur par défaut.
-
Connectez-vous à Wink et approuvez la demande de permission sur l’écran de consentement.
-
Claude Code confirme la connexion. Tapez
/mcppour vérifier que le serveur apparaît et que ses outils sont chargés.
Ajoutez autant d’ensembles d’outils que votre travail en a besoin — chacun est une entrée serveur distincte avec son propre nom :
claude mcp add wink-operations https://api.wink.travel/mcp/extranet/operations --transport httpclaude mcp add wink-analytics https://api.wink.travel/mcp/analytics --transport httpVous ne vous connectez qu’une fois. Après la première approbation dans le navigateur, Claude Code réutilise votre session Wink pour les points de terminaison Wink supplémentaires.
-
Éditez le fichier de configuration 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
- macOS :
-
Ajoutez les entrées des serveurs MCP :
claude_desktop_config.json {"mcpServers": {"wink-extranet-rates": {"type": "http","url": "https://api.wink.travel/mcp/extranet/rates"},"wink-extranet-operations": {"type": "http","url": "https://api.wink.travel/mcp/extranet/operations"}}} -
Quittez complètement et redémarrez Claude Desktop (utilisez Quit dans la barre de menu — fermer la fenêtre ne suffit pas).
-
Claude Desktop ouvre un onglet navigateur pour chaque nouveau serveur. Connectez-vous à Wink et approuvez les permissions.
-
L’icône de prise dans la barre d’outils inférieure montre les deux serveurs comme connectés.
-
Assurez-vous que Codex CLI est installé :
Fenêtre de terminal npm install -g @openai/codex -
Ouvrez (ou créez) le fichier de configuration Codex :
- macOS / Linux :
~/.codex/config.json - Windows :
%USERPROFILE%\.codex\config.json
- macOS / Linux :
-
Ajoutez les entrées des serveurs MCP Wink :
~/.codex/config.json {"mcpServers": {"wink-extranet-rates": {"type": "http","url": "https://api.wink.travel/mcp/extranet/rates"},"wink-extranet-operations": {"type": "http","url": "https://api.wink.travel/mcp/extranet/operations"}}} -
Lancez Codex. À la première utilisation, Codex ouvre un onglet navigateur vers
https://iam.wink.travel. -
Connectez-vous à Wink et approuvez les permissions demandées.
-
Codex confirme la connexion. Lancez
codexet demandez-lui de lister les outils disponibles pour vérifier que les serveurs Wink sont actifs.
Le support des serveurs MCP est disponible dans l’application desktop ChatGPT pour les abonnés Plus, Pro, Team et Enterprise.
-
Téléchargez et installez l’application desktop ChatGPT si ce n’est pas déjà fait.
-
Ouvrez l’application et cliquez sur votre icône de profil en haut à droite, puis choisissez Paramètres.
-
Allez dans Connecteurs (ou Serveurs MCP selon la version de votre app) et cliquez sur Ajouter.
-
Entrez l’URL d’un ensemble d’outils du répertoire ci-dessus, par exemple :
https://api.wink.travel/mcp/extranet/ratesPuis cliquez sur Connecter.
-
ChatGPT ouvre un onglet navigateur vers
https://iam.wink.travel. Connectez-vous à Wink et approuvez les permissions. -
Répétez les étapes 4–5 pour tout autre ensemble d’outils dont votre travail a besoin, par exemple :
https://api.wink.travel/mcp/extranet/operations -
Chaque ensemble d’outils apparaît dans votre liste de Connecteurs. Lancez une nouvelle conversation — les outils Wink sont disponibles automatiquement.
-
Ouvrez (ou créez) le fichier de configuration MCP Cursor :
- macOS / Linux :
~/.cursor/mcp.json - Windows :
%USERPROFILE%\.cursor\mcp.json
- macOS / Linux :
-
Ajoutez les entrées des serveurs MCP Wink :
~/.cursor/mcp.json {"mcpServers": {"wink-extranet-rates": {"type": "http","url": "https://api.wink.travel/mcp/extranet/rates"},"wink-extranet-operations": {"type": "http","url": "https://api.wink.travel/mcp/extranet/operations"}}} -
Ouvrez Cursor. Allez dans Settings → Cursor Settings → MCP et vérifiez que les deux serveurs apparaissent avec un indicateur de statut vert. S’ils sont rouges, cliquez sur Refresh.
-
Cursor ouvre un onglet navigateur vers
https://iam.wink.travel. Connectez-vous à Wink et approuvez les permissions. -
Ouvrez une conversation (
Ctrl+L/Cmd+L) et demandez à Cursor de lister les outils Wink disponibles pour confirmer la connexion.
-
Ouvrez (ou créez) le fichier de configuration MCP Windsurf :
- macOS / Linux :
~/.codeium/windsurf/mcp_config.json - Windows :
%USERPROFILE%\.codeium\windsurf\mcp_config.json
- macOS / Linux :
-
Ajoutez les entrées des serveurs MCP Wink :
~/.codeium/windsurf/mcp_config.json {"mcpServers": {"wink-extranet-rates": {"type": "http","url": "https://api.wink.travel/mcp/extranet/rates"},"wink-extranet-operations": {"type": "http","url": "https://api.wink.travel/mcp/extranet/operations"}}} -
Redémarrez complètement Windsurf (Fichier → Quitter, puis rouvrez).
-
Allez dans Settings → MCP Servers et vérifiez que les deux serveurs sont connectés. Windsurf ouvre un onglet navigateur vers
https://iam.wink.travelà la première utilisation. -
Connectez-vous à Wink et approuvez les permissions. Les serveurs deviennent verts dans le panneau des paramètres une fois authentifiés.
Cline est une extension VS Code avec un gestionnaire MCP intégré. Aucune édition manuelle de JSON n’est requise.
-
Installez Cline depuis le Marketplace VS Code :
- Ouvrez VS Code et appuyez sur
Ctrl+Shift+X/Cmd+Shift+X - Recherchez Cline et cliquez sur Installer
- Ouvrez VS Code et appuyez sur
-
Cliquez sur l’icône Cline dans la barre d’activités (barre latérale gauche) pour ouvrir le panneau Cline.
-
Cliquez sur l’icône Serveurs MCP (icône prise) dans la barre d’outils Cline, puis choisissez Modifier les paramètres MCP.
-
VS Code ouvre
cline_mcp_settings.json. Ajoutez les entrées Wink :cline_mcp_settings.json {"mcpServers": {"wink-extranet-rates": {"type": "http","url": "https://api.wink.travel/mcp/extranet/rates"},"wink-extranet-operations": {"type": "http","url": "https://api.wink.travel/mcp/extranet/operations"}}} -
Enregistrez le fichier. Cline recharge automatiquement et ouvre un onglet navigateur vers
https://iam.wink.travel. -
Connectez-vous à Wink et approuvez les permissions. Les deux serveurs apparaissent comme actifs dans le panneau Serveurs MCP.
Lorsque vous approuvez l’écran de consentement, vous verrez le détail des demandes de l’agent. Les clients MCP utilisent le même vocabulaire de permissions que le reste de la plateforme — voir la référence complète des scopes sur la page Authentification.
Trois points sont spécifiques à MCP :
- Les scopes
mcp.read,mcp.writeetmcp.removesont requis en plus pour ouvrir le transport MCP. Un client qui détient un scopemcp.*est admis sur n’importe quel point de terminaison MCP Wink, mais chaque outil invoqué applique toujours le scope de section du point de terminaison qu’il enveloppe (par exemplebooking.read). - MCP agit toujours en tant qu’utilisateur connecté. Le client IA reçoit les scopes
mcp.*via votre connexion, jamais d’une Application que vous créez. Les jetons machine-à-machine (client-credentials) ne peuvent pas ouvrir le transport MCP ; utilisez l’API REST pour le travail serveur-à-serveur. - Le client IA ne demande que les scopes dont il a besoin. Vous pouvez refuser des permissions individuelles sur l’écran de consentement — les outils qui requièrent un scope refusé renverront une erreur lorsqu’ils seront invoqués.
Les ensembles d’outils ne changent rien à cela. Le point de terminaison auquel vous vous connectez décide quels outils sont listés, pas ce qu’ils sont autorisés à faire. Se connecter à /mcp/payment ne donne aucune permission financière supplémentaire que vous n’aviez déjà, et se connecter à /mcp/reference n’empêche pas un outil d’appliquer son propre scope. L’autorisation est décidée à chaque appel d’outil, à partir de votre jeton et des droits de votre compte.
Dépannage
Section intitulée « Dépannage »L’onglet navigateur ne s’ouvre pas
Votre client IA ne supporte peut-être pas encore le flux PKCE interactif. Vérifiez que vous utilisez une version récente :
- Claude Code :
npm install -g @anthropic-ai/claude-code - Codex CLI :
npm install -g @openai/codex - Claude Desktop / ChatGPT desktop : mettez à jour via le système de mise à jour intégré de l’application
401 Unauthorized après connexion
Votre jeton mis en cache est peut-être périmé. Supprimez et réajoutez le serveur pour déclencher une nouvelle connexion :
# Claude Codeclaude mcp remove wink-ratesclaude mcp add wink-rates https://api.wink.travel/mcp/extranet/rates --transport httpPour Claude Desktop et ChatGPT, supprimez l’entrée serveur dans les paramètres, redémarrez l’application, puis ajoutez-la à nouveau.
403 Forbidden lors de l’appel d’un outil spécifique
L’outil requiert un scope que vous n’avez pas approuvé sur l’écran de consentement, ou une permission que votre compte ne possède pas. Reconnectez le serveur — l’écran de consentement apparaîtra à nouveau et vous pourrez approuver la permission manquante. Si cela échoue encore, l’outil nécessite une permission de compte que vous n’avez pas ; changer d’ensemble d’outils ne servira à rien, car les ensembles d’outils ne donnent pas de permissions.
L’outil dont j’ai besoin n’est pas dans la liste
Vous êtes probablement connecté à un ensemble d’outils qui ne couvre pas ce métier. Consultez le répertoire des points de terminaison et ajoutez l’ensemble d’outils qui le couvre — les connexions sont indépendantes, donc en ajouter une ne change rien aux autres. Si vous ne savez pas lequel le contient, connectez-vous temporairement à https://api.wink.travel/mcp, trouvez l’outil, puis regardez dans quel ensemble d’outils il est listé.
404 Not Found sur un point de terminaison d’ensemble d’outils
Vérifiez bien le chemin — les ensembles imbriqués ont deux segments (/mcp/extranet/rates, pas /mcp/extranet-rates), et les ensembles plats un seul (/mcp/link-manager). Notez qu’une requête non authentifiée vers n’importe quel chemin sous /mcp renvoie 401, pas 404, donc un 401 seul ne vous dit pas si le point de terminaison existe.
Je me suis connecté à api.wink.travel/mcp/channel-manager et je n’ai rien
Ce point de terminaison n’existe pas. L’intégration channel manager est servie uniquement depuis https://integrations.wink.travel/mcp/channel-manager. Si vous devez aussi lire ou écrire les tarifs propres d’une propriété manuellement, c’est un métier séparé sur un point de terminaison séparé — voir /mcp/extranet/rates.
Le serveur apparaît mais les appels d’outils renvoient “compte introuvable”
Vous êtes connecté à un compte Wink sans entité gestionnaire. Allez sur Wink Portal et assurez-vous que votre compte est configuré avant d’utiliser le serveur MCP.
Le jeton expire en cours de session
Les jetons sont valides 3 heures. Claude Code et Claude Desktop renouvellent les jetons silencieusement sans interrompre votre session. Si vous voyez des erreurs d’authentification après une longue période d’inactivité, tapez un nouveau message — le client se réauthentifiera automatiquement.
Codex CLI affiche “MCP server unreachable”
Vérifiez que votre ~/.codex/config.json est un JSON valide (pas de virgules finales) et que "type": "http" est bien défini. Codex requiert le transport HTTP pour les serveurs distants ; le transport stdio est réservé aux binaires locaux.
Le menu “Connectors” de ChatGPT est manquant
Le support MCP nécessite la version 1.2024.352 ou ultérieure de l’application desktop ChatGPT et un abonnement actif Plus, Pro, Team ou Enterprise. Mettez à jour l’application et vérifiez votre plan dans Paramètres → Compte.
Le serveur Cursor affiche rouge / “Failed to connect”
Vérifiez que votre ~/.cursor/mcp.json est un JSON valide et contient "type": "http". Ensuite, allez dans Settings → Cursor Settings → MCP et cliquez sur Refresh. Si l’erreur persiste, redémarrez complètement Cursor — les changements de config ne sont pas toujours pris en compte sans redémarrage.
Les serveurs MCP Windsurf ne s’affichent pas dans les paramètres
Windsurf nécessite un redémarrage complet (pas seulement un rechargement de fenêtre) pour prendre en compte les changements dans mcp_config.json. Utilisez Fichier → Quitter puis relancez. Si les serveurs n’apparaissent toujours pas, vérifiez que vous êtes sur Windsurf 1.4+ via Aide → À propos de Windsurf.
L’option “Add Server” de Cline n’est pas visible
Le gestionnaire de serveurs MCP nécessite Cline 2.0 ou ultérieur. Ouvrez le panneau Extensions VS Code, trouvez Cline, et cliquez sur Mettre à jour si une mise à jour est disponible. Après mise à jour, rechargez VS Code (Ctrl+Shift+P → “Developer: Reload Window”).
Ouvrir Wink Portal Wink sur GitHub
