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 de code d’autorisation 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 de 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. La séparation 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 l’établissement 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’un établissement en activité : 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 d’établissements
/mcp/link-manager~28Collections de liens syndiqués, leur design, catégories et tags, plus URLs raccourcies
/mcp/reference~24Données de consultation 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 campagne
/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 de réservations et les reçus, lorsque la réservation et le paiement agentiques sont activés pour cet environnement. Voir Agentic Payments pour la configuration, 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’un établissement/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éveloppeur de la distribution/mcp/extranet/distribution + /mcp/analytics
Créateur de pages affiliées/mcp/studio/curation + /mcp/studio/embeds
Gestionnaire de pages link-in-bio/mcp/link-manager + /mcp/social
Réservant pour des voyageurs/mcp/travel-agent
Réconciliateur financier/mcp/payment
Réservant une chambre avec un agent IA/mcp/booking-engine + un portefeuille de paiement compatible — voir Agentic Payments
Créateur d’expérience de réservation/mcp/booking-engine ; optionnellement /mcp/reference pour des consultations supplé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 des tarifs, 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 consultations 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 établissements. Ce sont des ajouts optionnels au flux de réservation.

Commencez par un seul. Ajoutez-en un autre quand vous constatez qu’il ne peut pas faire ce dont vous avez besoin — chaque connexion est indépendante, et en ajouter une ne modifie jamais les 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 la première connexion :

  1. Votre client IA découvre le serveur d’autorisation à partir des 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 le 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.


  1. Assurez-vous que Claude Code est à jour :

    Fenêtre de terminal
    npm install -g @anthropic-ai/claude-code
  2. 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
  3. Claude Code contacte le serveur, découvre le serveur d’autorisation, et ouvre votre navigateur par défaut.

  4. Connectez-vous à Wink et approuvez la demande de permission sur l’écran de consentement.

  5. Claude Code confirme la connexion. Tapez /mcp pour 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 :

Fenêtre de terminal
claude mcp add wink-operations https://api.wink.travel/mcp/extranet/operations --transport http
claude mcp add wink-analytics https://api.wink.travel/mcp/analytics --transport http

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


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.

Deux points sont spécifiques au MCP :

  • Les scopes mcp.read, mcp.write et mcp.remove sont également requis pour ouvrir le transport MCP. Un client possédant 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 (ex. booking.read).
  • 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 nécessitant un scope refusé renverront une erreur à l’invocation.

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, 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’app

401 Unauthorized après connexion

Votre jeton en cache est peut-être périmé. Supprimez et réajoutez le serveur pour forcer 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’app, 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 réapparaîtra 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 fait — 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 quel ensemble d’outils le liste.

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’un établissement 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 absent

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’app et vérifiez votre plan dans Paramètres → Compte.

Le serveur Cursor affiche rouge / “Échec de connexion”

Vérifiez que votre ~/.cursor/mcp.json est un JSON valide et contient "type": "http". Puis allez dans Paramètres → Paramètres Cursor → MCP et cliquez sur Actualiser. 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 modifications de 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 “Ajouter un serveur” dans 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