Aller au contenu

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.

Un intégrateur channel manager se connecte à un point de terminaison
claude mcp add wink-channel-manager https://integrations.wink.travel/mcp/channel-manager --transport http
Un hôtelier gérant ses propres tarifs se connecte à un autre
claude mcp add wink-rates https://api.wink.travel/mcp/extranet/rates --transport http

Pourquoi 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.


Deux hôtes servent des ensembles d’outils. Les nombres d’outils sont approximatifs et évoluent dans le temps.

Point de terminaisonOutilsCe qu’il couvre
/mcp/extranet/facilities~64L’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~62La fiche de propriété et ses conditions commerciales : profil et contenu, options, politiques d’annulation, avantages, annonces
/mcp/settings~60Administration du compte : profil et image de l’entité gestionnaire, gestionnaires et leurs droits, personnalisation, webhooks, préférences de notification
/mcp/studio/embeds~48Publication d’inventaire sélectionné : widgets, grilles et grilles classées, cartes, cartes, liens profonds vers inventaire et pages fournisseurs
/mcp/extranet/rates~44Tarifs et disponibilités : périodes et allotements de tarifs d’inventaire, plans tarifaires, tarifs maîtres, tarifs spéciaux et promotionnels
/mcp/extranet/operations~39Gestion 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~37Où 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~35Création de collections commercialisables : listes statiques et dynamiques, listes classées, recherches sauvegardées, agrégats de propriétés
/mcp/link-manager~28Collections de liens syndiqués, leur design, catégories et tags, plus URLs raccourcies
/mcp/reference~24Donné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~18Analyses de réservations et revenus : vues d’ensemble, graphiques, classements, performances affiliées, métriques de partage
/mcp/payment~18Opérations financières : grand livre, retraits et estimations de frais, agrégats de fonds de réservation
/mcp/booking-engine~17Parcours d’achat côté voyageur : recherche et consultation, panier et paiement, listes de souhaits, personnalisation de campagnes
/mcp/social~17Comptes sociaux connectés, publication et planification de posts, lecture des insights des posts
/mcp/travel-agent~8Ré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 terminaisonOutilsCe qu’il couvre
/mcp/channel-manager~9Connexion 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.

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.


Si vous êtes…Connectez-vous à
Intégrateur channel manager, PMS ou CRSintegrations.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.


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 :

  1. Votre client IA découvre le serveur d’autorisation depuis les métadonnées /.well-known/oauth-protected-resource du point de terminaison MCP.
  2. Le client s’auto-enregistre via Dynamic Client Registration — aucune configuration manuelle d’application requise.
  3. 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.
  4. Wink émet un jeton d’accès lié à votre compte et à votre identité.
  5. Le client IA joint ce jeton à chaque requête MCP. Tous les résultats d’outils sont automatiquement limités à votre entité gestionnaire.
  6. 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.


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.

  1. Dans Claude, ouvrez Customize › Connectors, cliquez sur Add, puis Add custom connector.

  2. 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-manager

    Cliquez sur Continue.

  3. Claude détecte la connexion Wink. Gardez Authentication: Sign in now et OAuth client: Register automatically, puis cliquez sur Add.

  4. 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.

  5. 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.


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.write et mcp.remove sont requis en plus pour ouvrir le transport MCP. Un client qui détient un scope mcp.* 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 exemple booking.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.


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 :

Fenêtre de terminal
# Claude Code
claude mcp remove wink-rates
claude mcp add wink-rates https://api.wink.travel/mcp/extranet/rates --transport http

Pour 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