← Toutes les questions

Serveur MCP (Claude et assistants IA)

Écran jetons MCP dans l’app.

Le protocole MCP (Model Context Protocol) permet à un assistant IA compatible d’utiliser votre compte VinoCellar pour lire et gérer votre cave : lister les bouteilles, rechercher, déplacer le stock, importer des vins, etc. L’accès passe par le point d’entrée MCP VinoCellar et un jeton d’accès personnel que vous créez dans l’application.

En quoi consiste le serveur MCP VinoCellar ?

C’est un pont sécurisé entre vos données de cave et un client compatible MCP. Après authentification, l’assistant peut appeler des outils VinoCellar en votre nom, dans le cadre de votre abonnement et des règles du compte.

Quelle URL indiquer dans mon client MCP ?

L’URL publique exacte est affichée dans l’app VinoCellar, écran MCP / jetons d’accès (route interne /app/mcp), bloc « Adresse du serveur MCP ». Copiez-la telle quelle.

  1. Ouvrez l’app → section MCP (ou Paramètres → VinoCellar MCP → gérer les jetons).
  2. Copiez l’URL du serveur dans le bloc prévu.
  3. Dans Claude Desktop (ou un autre client), ajoutez un serveur MCP et collez cette URL selon la documentation actuelle du client.
  4. Lors de la première connexion, suivez l’étape OAuth dans le navigateur ; collez le jeton personnel créé dans l’app lorsque le formulaire le demande.

Comment créer et utiliser un jeton d’accès personnel ?

Le jeton identifie votre compte auprès du serveur MCP :

  1. Dans l’app, ouvrez l’écran MCP puis créez un jeton.
  2. Donnez-lui un libellé clair (ex. « MacBook », « Cursor »).
  3. Copiez la valeur tout de suite : elle ne s’affiche qu’une fois.
  4. Révoquez un jeton sur le même écran si un appareil est perdu ou pour couper l’accès d’un client.

Considérez les jetons comme des mots de passe : toute personne disposant du jeton et de l’URL peut accéder à votre cave via MCP jusqu’à révocation.

Que permet le serveur MCP ?

Les outils disponibles incluent notamment (les noms peuvent apparaître côté client pour les développeurs) :

  • Profil / connexion — vérifier le compte lié.
  • Liste et recherche de vins — parcourir ou chercher dans l’inventaire.
  • Caves — lister les caves et consulter le détail (casiers / emplacements).
  • Déplacer une bouteille — changer de casier ou de cave.
  • Importer un vin — ajouter un vin à partir de données structurées (images d’étiquette en base64 en option).

Abonnement MCP et crédits : quelle différence ?

Les crédits servent surtout aux scans photo d’étiquettes dans l’app. L’abonnement MCP est distinct : tant qu’il est actif, les appels via le serveur MCP pour les opérations prises en charge ne sont pas plafonnés par votre solde de crédits scan de la même manière.

Crédits

  • Consommés pour les scans IA et flux associés dans l’application.
  • Achat par packs via Stripe (paiement ponctuel).

Abonnement MCP

  • Usage MCP illimité côté VinoCellar tant que l’abonnement est actif.
  • 2,99 €/mois sans engagement — adapté si vous pilotez la cave depuis Claude ou un IDE.

Quels assistants sont compatibles ?

Claude Desktop et les clients compatibles MCP avec le transport VinoCellar sont pris en charge aujourd’hui. La compatibilité ChatGPT et Gemini est prévue ; consultez les notes de version et cette FAQ pour les mises à jour.