Utiliser le MCP WineSitting

Le MCP WineSitting permet de connecter votre compte WineSitting à un agent IA compatible avec le Model Context Protocol, afin qu'il puisse consulter certaines informations de votre compte selon vos droits d'accès.

Le serveur MCP WineSitting est disponible à l'adresse :

https://app.winesitting.com/_mcp

Il utilise une authentification par clé Bearer, comme l'API WineSitting.

À quoi sert le MCP WineSitting ?

Une fois connecté, votre agent peut utiliser les outils WineSitting disponibles pour interroger vos données WineSitting.

Selon les droits associés à votre clé, il peut notamment :

• consulter les informations du compte WineSitting ;
• rechercher des commandes ;
• consulter le détail d'une commande ;
• rechercher des éléments de cave ;
• consulter le détail d'un élément de cave ;
• lire certaines valeurs de référence utiles, comme les statuts de commande.

Les droits restent ceux de votre compte WineSitting : une clé client ne donne pas accès à des données qui ne sont pas visibles depuis votre compte.

1. Créer une clé API dédiée au MCP

Le MCP WineSitting nécessite une clé API Bearer.

Si vous avez déjà une clé API utilisée pour un autre usage, par exemple une connexion e-commerce ou une intégration API existante, nous vous conseillons de créer une nouvelle clé dédiée au MCP. Cela permet de l'identifier plus facilement et de la révoquer séparément si nécessaire.

Pour créer une clé API, suivez la procédure : https://help.winesitting.com/fr/article/obtenir-des-cles-dapi-8u9ph2/

Lors de la création, donnez un nom explicite à la clé, par exemple :

MCP Claude
MCP Cursor
MCP Codex

2. Configurer votre agent IA

Dans les exemples ci-dessous, remplacez VOTRE_CLE_API par la clé Bearer générée depuis WineSitting.

L'URL du serveur MCP est toujours :

https://app.winesitting.com/_mcp

Claude Code

Dans un terminal, ajoutez le serveur MCP HTTP :

claude mcp add --transport http winesitting https://app.winesitting.com/_mcp \
  --header "Authorization: Bearer VOTRE_CLE_API"

Vous pouvez ensuite vérifier la connexion avec :

claude mcp list

Dans Claude Code, la commande suivante permet aussi de voir l'état des serveurs MCP connectés :

/mcp

Claude avec configuration JSON

Si votre installation Claude utilise un fichier de configuration MCP JSON, ajoutez une entrée de ce type :

{
  "mcpServers": {
    "winesitting": {
      "type": "http",
      "url": "https://app.winesitting.com/_mcp",
      "headers": {
        "Authorization": "Bearer VOTRE_CLE_API"
      }
    }
  }
}

Redémarrez ensuite Claude pour que le serveur soit chargé.

OpenAI Codex

Dans le fichier de configuration Codex, ajoutez le serveur MCP en utilisant une variable d'environnement pour éviter d'écrire la clé en clair dans le fichier :

[mcp_servers.winesitting]
url = "https://app.winesitting.com/_mcp"
bearer_token_env_var = "WINESITTING_MCP_TOKEN"

Puis définissez la variable d'environnement avant de lancer Codex :

export WINESITTING_MCP_TOKEN="VOTRE_CLE_API"

Redémarrez Codex après modification de la configuration.

Cursor

Dans Cursor, ouvrez ou créez le fichier de configuration MCP, généralement :

.cursor/mcp.json

Ajoutez la configuration suivante :

{
  "mcpServers": {
    "winesitting": {
      "type": "http",
      "url": "https://app.winesitting.com/_mcp",
      "headers": {
        "Authorization": "Bearer VOTRE_CLE_API"
      }
    }
  }
}

Redémarrez Cursor ou rechargez les serveurs MCP depuis l'interface MCP de Cursor.

Autres agents compatibles MCP

Si votre agent supporte les serveurs MCP distants en HTTP, les paramètres à renseigner sont généralement :

Nom : winesitting
Type / transport : http
URL : https://app.winesitting.com/_mcp
Header : Authorization: Bearer VOTRE_CLE_API

Si l'agent demande une configuration JSON, adaptez ce modèle :

{
  "winesitting": {
    "type": "http",
    "url": "https://app.winesitting.com/_mcp",
    "headers": {
      "Authorization": "Bearer VOTRE_CLE_API"
    }
  }
}

3. Tester la connexion

Après configuration, demandez à votre agent une action simple, par exemple :

Peux-tu consulter mon compte WineSitting via le MCP ?

ou :

Liste mes dernières commandes WineSitting.

Si la connexion fonctionne, l'agent doit indiquer qu'il utilise les outils WineSitting disponibles.

4. Bonnes pratiques de sécurité

• Utilisez une clé API dédiée au MCP.
• Ne mettez pas la clé dans un dépôt Git.
• Préférez les variables d'environnement ou les champs secrets proposés par votre agent.
• Supprimez la clé depuis WineSitting si vous n'utilisez plus l'agent associé.
• Créez une clé différente pour chaque agent ou chaque prestataire.

5. Dépannage

L'agent indique une erreur 401 ou 403

La clé est absente, invalide ou mal transmise.

Vérifiez que l'en-tête envoyé est exactement :

Authorization: Bearer VOTRE_CLE_API

Vérifiez aussi que la clé n'a pas été copiée avec un espace au début ou à la fin.

Le serveur MCP ne se connecte pas

Vérifiez l'URL configurée :

https://app.winesitting.com/_mcp

L'ancien endpoint API REST n'est pas utilisé pour le MCP. Le MCP utilise bien /_mcp.

L'agent ne voit aucun outil WineSitting

Redémarrez l'agent après avoir modifié la configuration MCP.

Selon l'agent utilisé, il peut aussi être nécessaire de relancer manuellement le serveur MCP ou de vider la liste des outils MCP en cache.

L'agent ne trouve pas certaines données

Les droits du MCP sont liés au compte associé à la clé API. Si votre compte ne peut pas consulter une donnée dans WineSitting, l'agent ne pourra pas non plus y accéder via le MCP.

Pour les comptes rattachés à une famille de comptes, seules les données visibles dans ce périmètre peuvent être retournées.

Besoin d'aide ?

Si vous êtes accompagné par un prestataire informatique, transmettez-lui uniquement la documentation et la clé API par un canal sécurisé.

En cas de difficulté, contactez WineSitting en précisant :

• l'agent utilisé ;
• l'URL configurée ;
• le message d'erreur affiché ;
• si possible, une capture de l'écran de configuration sans afficher la clé API.

Mis à jour le : 10/07/2026