Serveurs MCP

Wink expose deux serveurs MCP authentifiés. Les deux utilisent une connexion OAuth2 interactive (flux de code d’autorisation PKCE) — votre agent IA ouvre un onglet de navigateur pour que vous vous connectiez avec votre compte Wink. Aucun secret client à gérer.

Serveur	URL	Fonctionnalité
Inventory API	https://api.wink.travel/mcp	Inventaire, réservations, tarifs, canaux de vente, analyses et toutes les opérations de la plateforme
Integrations	https://integrations.wink.travel/mcp	Intégrations de gestionnaire de canaux — synchronisation des propriétés, tarifs et disponibilités avec les OTA

---

Comment fonctionne l’authentification

Les serveurs MCP de Wink utilisent le flux OAuth2 Authorization Code + PKCE et supportent l’enregistrement dynamique des clients (RFC 7591). Voici ce qui se passe lors de votre 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 d’accès MCP.
2. Le client s’auto-enregistre via l’enregistrement dynamique des clients — aucune configuration manuelle de l’application requise.
3. Le client ouvre un onglet de 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 des 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 d’authentification.

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

Claude Code

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

   npm install -g @anthropic-ai/claude-code

2. Ajoutez le serveur MCP Inventory de Wink :

   claude mcp add wink-inventory https://api.wink.travel/mcp --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.

Pour ajouter également le serveur Integrations :

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

Partagez avec votre équipe

Ajoutez --scope project à claude mcp add et Claude Code écrit l’URL du serveur dans .mcp.json à la racine du dépôt. Commitez ce fichier — chaque membre de l’équipe complète sa propre connexion via navigateur lors de la première connexion.

Claude Desktop

1. Modifiez 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

2. Ajoutez les entrées des serveurs MCP :

   claude_desktop_config.json

   {
     "mcpServers": {
       "wink-inventory": {
         "type": "http",
         "url": "https://api.wink.travel/mcp"
       },
       "wink-integrations": {
         "type": "http",
         "url": "https://integrations.wink.travel/mcp"
       }
     }
   }

3. Quittez complètement et redémarrez Claude Desktop (utilisez Quitter dans la barre de menu — fermer la fenêtre ne suffit pas).

4. Claude Desktop ouvre un onglet de navigateur pour chaque nouveau serveur. Connectez-vous à Wink et approuvez les permissions.

5. L’icône de prise dans la barre d’outils inférieure affiche les deux serveurs comme connectés.

OpenAI Codex

1. Assurez-vous que Codex CLI est installé :

   npm install -g @openai/codex

2. Ouvrez (ou créez) le fichier de configuration Codex :

   • macOS / Linux : ~/.codex/config.json
   • Windows : %USERPROFILE%\.codex\config.json

3. Ajoutez les entrées des serveurs MCP de Wink :

   ~/.codex/config.json

   {
     "mcpServers": {
       "wink-inventory": {
         "type": "http",
         "url": "https://api.wink.travel/mcp"
       },
       "wink-integrations": {
         "type": "http",
         "url": "https://integrations.wink.travel/mcp"
       }
     }
   }

4. Lancez Codex. Lors de la première utilisation, Codex ouvre un onglet de navigateur vers https://iam.wink.travel.

5. Connectez-vous à Wink et approuvez les permissions demandées.

6. Codex confirme la connexion. Exécutez codex et demandez la liste des outils disponibles pour vérifier que les serveurs Wink sont actifs.

Note

Le support MCP de Codex CLI nécessite la version 1.0 ou ultérieure. Exécutez codex --version pour vérifier, et npm install -g @openai/codex pour mettre à jour.

ChatGPT

Le support des serveurs MCP est disponible dans l’application de bureau ChatGPT pour les abonnés Plus, Pro, Team et Enterprise.

1. Téléchargez et installez l’application de bureau ChatGPT si ce n’est pas déjà fait.

2. Ouvrez l’application et cliquez sur votre icône de profil en haut à droite, puis choisissez Paramètres.

3. Allez dans Connecteurs (ou Serveurs MCP selon la version de votre application) et cliquez sur Ajouter.

4. Entrez l’URL du serveur Inventory de Wink :

   https://api.wink.travel/mcp

   Puis cliquez sur Connecter.

5. ChatGPT ouvre un onglet de navigateur vers https://iam.wink.travel. Connectez-vous à Wink et approuvez les permissions.

6. Répétez les étapes 4–5 pour le serveur Integrations :

   https://integrations.wink.travel/mcp

7. Les deux serveurs apparaissent dans votre liste de Connecteurs. Lancez une nouvelle conversation — les outils Wink sont disponibles automatiquement.

Limitation de l’application web

Les serveurs MCP ne sont configurables que dans l’application de bureau. L’interface web ChatGPT sur chatgpt.com ne supporte pas les serveurs MCP personnalisés.

Cursor

1. Ouvrez (ou créez) le fichier de configuration MCP de Cursor :

   • macOS / Linux : ~/.cursor/mcp.json
   • Windows : %USERPROFILE%\.cursor\mcp.json

2. Ajoutez les entrées des serveurs MCP de Wink :

   ~/.cursor/mcp.json

   {
     "mcpServers": {
       "wink-inventory": {
         "type": "http",
         "url": "https://api.wink.travel/mcp"
       },
       "wink-integrations": {
         "type": "http",
         "url": "https://integrations.wink.travel/mcp"
       }
     }
   }

3. Ouvrez Cursor. Allez dans Paramètres → Paramètres Cursor → MCP et vérifiez que les deux serveurs apparaissent avec un indicateur de statut vert. S’ils sont rouges, cliquez sur Actualiser.

4. Cursor ouvre un onglet de navigateur vers https://iam.wink.travel. Connectez-vous à Wink et approuvez les permissions.

5. Ouvrez une conversation (Ctrl+L / Cmd+L) et demandez à Cursor de lister les outils Wink disponibles pour confirmer la connexion.

Configuration au niveau projet

Vous pouvez aussi placer un fichier mcp.json à la racine de votre projet au lieu de ~/.cursor/. La configuration au niveau projet a la priorité et rend les serveurs disponibles à chaque membre de l’équipe qui ouvre le projet dans Cursor.

Windsurf

1. Ouvrez (ou créez) le fichier de configuration MCP de Windsurf :

   • macOS / Linux : ~/.codeium/windsurf/mcp_config.json
   • Windows : %USERPROFILE%\.codeium\windsurf\mcp_config.json

2. Ajoutez les entrées des serveurs MCP de Wink :

   ~/.codeium/windsurf/mcp_config.json

   {
     "mcpServers": {
       "wink-inventory": {
         "type": "http",
         "url": "https://api.wink.travel/mcp"
       },
       "wink-integrations": {
         "type": "http",
         "url": "https://integrations.wink.travel/mcp"
       }
     }
   }

3. Redémarrez complètement Windsurf (Fichier → Quitter, puis rouvrez).

4. Allez dans Paramètres → Serveurs MCP et vérifiez que les deux serveurs sont affichés comme connectés. Windsurf ouvre un onglet de navigateur vers https://iam.wink.travel lors de la première utilisation.

5. Connectez-vous à Wink et approuvez les permissions. Les serveurs deviennent verts dans le panneau des paramètres une fois authentifiés.

Note

Le support MCP de Windsurf nécessite la version 1.4 ou ultérieure. Vérifiez via Aide → À propos de Windsurf et mettez à jour depuis le site Windsurf si nécessaire.

Cline (VS Code)

Cline est une extension VS Code avec un gestionnaire de serveurs MCP intégré. Aucune édition manuelle de JSON n’est requise.

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

2. Cliquez sur l’icône Cline dans la barre d’activité (barre latérale gauche) pour ouvrir le panneau Cline.

3. Cliquez sur l’icône Serveurs MCP (icône de prise) dans la barre d’outils Cline, puis choisissez Modifier les paramètres MCP.

4. VS Code ouvre cline_mcp_settings.json. Ajoutez les entrées Wink :

   cline_mcp_settings.json

   {
     "mcpServers": {
       "wink-inventory": {
         "type": "http",
         "url": "https://api.wink.travel/mcp"
       },
       "wink-integrations": {
         "type": "http",
         "url": "https://integrations.wink.travel/mcp"
       }
     }
   }

5. Enregistrez le fichier. Cline recharge automatiquement et ouvre un onglet de navigateur vers https://iam.wink.travel.

6. Connectez-vous à Wink et approuvez les permissions. Les deux serveurs apparaissent comme actifs dans le panneau Serveurs MCP.

Alternative : ajout via URL

Dans le panneau Serveurs MCP, cliquez sur Ajouter un serveur et collez directement https://api.wink.travel/mcp. Cline remplit automatiquement la configuration et gère l’authentification sans édition manuelle du JSON.

---

Scopes

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 — consultez la référence complète des scopes sur la page Authentification.

Deux points sont spécifiques à 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 à /mcp, mais chaque outil qu’il invoque applique toujours le scope de section du point d’accès qu’il enveloppe (par exemple 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é retourneront une erreur lors de leur invocation.

---

Dépannage

L’onglet du 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 Code
claude mcp remove wink-inventory
claude mcp add wink-inventory https://api.wink.travel/mcp --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. Reconnectez le serveur — l’écran de consentement réapparaîtra et vous pourrez approuver la permission manquante.

Le serveur apparaît mais les appels d’outil retournent “compte introuvable”

Vous êtes connecté à un compte Wink sans entité gestionnaire. Rendez-vous 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é, envoyez 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 nécessite un transport HTTP pour les serveurs distants ; le transport stdio est réservé aux binaires locaux uniquement.

Le menu “Connectors” de ChatGPT est manquant

Le support MCP nécessite la version 1.2024.352 ou ultérieure de l’application de bureau 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 / “Échec de connexion”

Vérifiez que votre ~/.cursor/mcp.json est un JSON valide et contient "type": "http". Ensuite, allez dans Paramètres → Paramètres Cursor → MCP et cliquez sur Actualiser. Si l’erreur persiste, redémarrez complètement Cursor — les modifications de configuration ne sont pas toujours prises 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