Passer au contenu principal

MCP - Connecter Wineriz à une IA

Wineriz peut être branché sur un assistant IA : Claude, ChatGPT, Vibe (Mistral) et la plupart des applications existantes.

Une fois la connexion établie, vous pouvez interroger votre boutique en langage courant : « Combien de bouteilles ai-je vendu cette année ? », « Que me doit ce client ? », « Prépare une commande à partir de ce bon ».

L'assistant lit vos données en direct et répond avec les mêmes chiffres que votre back-office.

➡️ La connexion repose sur le MCP (Model Context Protocol). Concrètement : vous renseignez une adresse dans votre assistant IA, vous autorisez l'accès sur un écran Wineriz, c'est terminé. Aucune clé, aucun identifiant, aucune installation.

Avant de commencer

  • Le compte propriétaire de la boutique est obligatoire. Collaborateurs, agents et clients ne peuvent pas brancher le connecteur.

  • L'adresse du connecteur est la même partout : https://api.wineriz.com/mcp. Conservez bien la fin /mcp.

  • Une autorisation vaut pour une seule boutique. Si vous en gérez plusieurs, il faut répéter l'opération pour chacune.

Quelle que soit l'application, le parcours se termine sur le même écran Wineriz :

  • Accès accordé. Non modifiable : créer des commandes en brouillon en votre nom, consulter vos commandes, consulter votre fichier clients, consulter votre catalogue produits.

  • Coordonnées des clients. Facultatif et désactivé par défaut. Tout fonctionne sans. À activer uniquement si vous prévoyez des relances ou des exports nominatifs.

  • Boutique à connecter. La première boutique est cochée d'office : vérifiez que c'est la bonne avant de valider.

  • Cliquez ensuite sur Autoriser l'accès. Le retour vers votre application est automatique, il n'y a aucun code à recopier. Ne fermez pas la fenêtre pendant la redirection : l'autorisation n'est valable qu'une minute.

💡 L'encadré orange « Application externe non vérifiée » est normal : il apparaît pour toute application qui s'enregistre elle-même.

Vérifiez simplement que l'adresse affichée en gras correspond bien à l'application que vous branchez.

Pour vérifier que tout est en place, posez la question à votre assistant : « Sur quelle boutique es-tu branché ? »

Installation sur votre application

Claude

Disponible sur toutes les offres, y compris gratuite (limitée à un connecteur).

  1. Ouvrez Paramètres > Personnaliser > Connecteurs.

  2. Cliquez sur Ajouter un connecteur personnalisé.

  3. Collez https://api.wineriz.com/mcp dans le champ URL, puis validez.

  4. Suivez l'écran d'autorisation Wineriz décrit plus haut.

Sur une offre Team ou Enterprise, le propriétaire de l'espace ajoute le connecteur via Paramètres de l'organisation > Connecteurs > Ajouter > Personnalisé > Web. Les membres cliquent ensuite sur Se connecter.

ChatGPT

Un compte payant et un ordinateur sont nécessaires : l'ajout n'est pas possible depuis le mobile. Le branchement passe par le mode développeur, mais malgré son nom, aucune compétence technique n'est requise.

  1. Dans les Réglages, activez le mode développeur. Selon votre offre, il se trouve dans Sécurité et connexion ou dans Applications > Paramètres avancés.

  2. Allez dans Plugins et cliquez sur +.

  3. Dans la fenêtre Nouveau plugin, renseignez le nom (Wineriz), laissez URL du serveur et saisissez https://api.wineriz.com/mcp, puis choisissez OAuth comme authentification.

    Ne modifiez pas les paramètres OAuth avancés, ils sont détectés automatiquement.

  4. Cochez "J'ai compris et je souhaite continuer" sous l'avertissement orange. Cette case est obligatoire : OpenAI signale qu'il n'a pas examiné le serveur, ce qui est normal pour un connecteur d'éditeur.

  5. Cliquez sur Créer. L'écran d'autorisation Wineriz s'ouvre.

Dans une conversation, sélectionnez ensuite Wineriz dans le menu des outils. Deux limites propres à ChatGPT : Wineriz n'apparaît ni dans Company knowledge ni dans la recherche approfondie, qui utilisent un format de connecteur différent, et le mode agent n'exploite pas les applications personnalisées. Sur les offres Business, Enterprise et Edu, l'ajout est réservé aux administrateurs de l'espace de travail.

Vibe (Mistral)

Vibe est l'assistant de la société française Mistral AI, accessible sur chat.mistral.ai. Il s'agit de l'ancien « Le Chat ». Le connecteur fonctionne dès l'offre gratuite.

  1. En haut de la barre latérale, placez-vous sur l'onglet Work, puis ouvrez Connecteurs.

  2. Cliquez sur Ajouter un connecteur personnalisé.

  3. Sous 1 Détails, saisissez le nom (Wineriz) et le serveur https://api.wineriz.com/mcp. La description est facultative.

  4. Sous 2 Authentification, choisissez OAuth2.1. Ne modifiez pas les paramètres avancés.

  5. Sous 3 Disponibilité, choisissez Personnel (recommandé) pour un usage individuel, ou Espace de travail pour l'ouvrir à votre équipe.

  6. Cliquez sur Ajouter un connecteur. L'écran d'autorisation Wineriz s'ouvre.

À la première utilisation de chaque fonction, Vibe demande une confirmation. L'option Always allow évite la question, pour la session en cours uniquement.

Autres applications

Wineriz n'est lié à aucun fournisseur. Le connecteur suit le MCP, un standard ouvert que de nombreuses applications savent lire : beaucoup d'autres outils peuvent donc s'y brancher, avec toujours la même adresse https://api.wineriz.com/mcp.

Deux conditions techniques doivent être réunies : l'application doit accepter les serveurs MCP distants, et non uniquement ceux installés sur votre ordinateur, et savoir se connecter par autorisation OAuth.

Wineriz n'accepte pas les clés fixes, c'est précisément ce qui vous permet de couper l'accès quand vous le souhaitez. Reportez-vous à la documentation de l'application concernée pour savoir où coller l'adresse.

Nous ne documentons pas ces applications une par une, elles évoluent vite et nous ne les testons pas toutes. En cas de doute, contactez le support.

Ce que l'assistant peut faire dans votre boutique

L'assistant travaille sur les données réelles de la boutique connectée, en lecture, avec une seule exception en écriture : la création de commandes en brouillon. Voici le périmètre complet.

🧑‍🤝‍🧑 Vos clients

Rechercher un client par nom, prénom, raison sociale, e-mail ou téléphone, y compris avec une orthographe approximative. Ouvrir sa fiche (pays, raison sociale, et selon l'autorisation ses coordonnées et adresses). Consulter son chiffre d'affaires, son encours et ses avoirs, ainsi que l'historique de ses commandes.

🏭 Votre catalogue

Rechercher un produit par nom, SKU ou code, avec le détail de ses millésimes et de ses formats. Retrouver le dernier prix unitaire HT réellement appliqué à un client donné pour un produit, un millésime et un format précis, ce qui permet de contrôler la cohérence d'un tarif figurant sur un bon de commande.

🧮 Votre stock

Répondre à « il me reste combien de tel vin ? », soit sur l'ensemble du stock en équivalent 75 cl, soit produit par produit avec le détail par millésime et par format en unités réelles. L'assistant distingue le disponible, ce qui reste réellement vendable, de l'en stock, qui inclut ce qui est déjà alloué, commandé ou vendu en primeur. Les capsules (CRD), les accessoires et les matières sèches sont également couverts. Cette fonction suppose le module Stocks activé.

📋 Vos commandes

Rechercher une commande par numéro de document, par client, par produit, par référence produit, par date, par statut ou par type (vente, réservation, primeur, achat).

Afficher le détail d'une commande : lignes, remises, paiements, logistique, documents rattachés et statuts douaniers.

Retrouver un document par son numéro exact, qu'il s'agisse d'un bon de commande, d'une facture, d'un bon de livraison, d'un avoir, d'un DAE, DSA ou MVV, ou d'une commande issue de Shopify ou WooCommerce.

Lister les dernières commandes, ou seulement les brouillons en attente.

📈 Vos statistiques et vos rapports

L'assistant reprend la donnée chiffrée de votre compte Wineriz :

  • le chiffre d'affaires HT du mois et de l'année, identique au tableau de bord ;

  • la ventilation de ce chiffre d'affaires par statut de commande ou par type, utile pour expliquer un écart ;

  • vos impayés (factures échues) et votre encours global (échu et non échu), avec le classement des débiteurs ;

  • le top produits et le top clients, avec comparaison N-1 ;

  • et surtout l'équivalent complet de l'écran Statistiques personnalisées : regroupement selon une quarantaine d'axes (produit, gamme, appellation, millésime, couleur, cépage, SKU, client, typologie, famille, tags, pays, zone, département, agent, point de vente, entrepôt, fournisseur, type de paiement, statut, mois, année, et d'autres), croisement de deux ou trois axes, plus de trente métriques disponibles (quantités, équivalent 75 cl, volume, CA HT et TTC, panier moyen, prix unitaire moyen, remises, marge brute et nette, commissions, frais de port, droits d'accise, encaissé, restant dû), filtres identiques à ceux de l'écran et comparaison jusqu'à trois années antérieures.

L'assistant sait également retrouver vos modèles de rapports enregistrés et les rejouer si vous les appelez par leur nom.

💡 Centre d'aide Wineriz

L'assistant répond à vos questions de fonctionnement du logiciel en s'appuyant sur la documentation officielle, en citant le lien de l'article.

📦 La préparation de commandes

À partir d'un bon de commande que vous lui transmettez (PDF, photo, e-mail), l'assistant identifie le client, retrouve chaque ligne dans votre catalogue, vérifie les prix au regard de l'historique et crée la commande.

Il peut renseigner les quantités, les remises en pourcentage, le délai de paiement et une note (dans la limite de 200 lignes par commande).

⚠️ La commande est toujours créée en brouillon : jamais validée, jamais envoyée au client. L'assistant vous donne un lien, vous ouvrez la commande, vous vérifiez, vous validez. Ces commandes portent la source « Assistant IA » dans votre liste de commandes.
​

Ce que l'assistant ne peut pas faire

Le périmètre est volontairement fermé par mesure de sécurité.

L'assistant ne peut pas :

  • valider, facturer, expédier ou envoyer une commande à un client ;

  • modifier ou supprimer une commande existante, y compris un brouillon qu'il a lui-même créé ;

  • créer, modifier ou supprimer un produit, un millésime, un format, un tarif ou une grille tarifaire ;

  • créer ou modifier une fiche client ;

  • saisir un mouvement de stock, un inventaire ou une entrée en cave ;

  • produire une déclaration douanière ou un document d'accompagnement (DRM, DAE) ; il lit les numéros et statuts existants, il ne déclare rien ;

  • générer des écritures comptables ou un export de pré-comptabilité ;

  • envoyer un e-mail, déclencher une campagne ou une relance ;

  • modifier les réglages de votre boutique, vos intégrations ou les droits de vos collaborateurs ;

  • accéder à une autre boutique que celle sélectionnée lors de l'autorisation.

Autrement dit, l'assistant lit et prépare, vous décidez et validez.

⚠️ Les coordonnées de vos clients

Par défaut, l'assistant voit les noms et les raisons sociales, mais les e-mails, les téléphones et les adresses lui restent inaccessibles.

Il peut toujours retrouver un client à partir de son e-mail : seul l'affichage est bloqué.

➡️ Si vous avez besoin de ces informations, par exemple pour préparer des relances ou un export nominatif, activez l'option Coordonnées des clients sur l'écran d'autorisation.

Attention, cette option ne s'ajoute pas après coup : il faut révoquer la connexion et la refaire.

Gérer ou révoquer un accès

Rendez-vous dans Paramètres > Assistant IA, section Connexions IA : app.wineriz.com/dashboard/settings?link=ai

Révoquer coupe une connexion, Tout révoquer les coupe toutes.

En cas de doute, privilégiez Tout révoquer : cette action agit également sur les connexions qui n'apparaissent pas dans la liste. La coupure est immédiate et l'application ne peut pas se reconnecter d'elle-même : vous devrez repasser par les réglages de votre assistant pour rebrancher le connecteur.

Une connexion se renouvelle automatiquement tant que vous vous en servez, et devient caduque après 30 jours sans usage. Toute modification des permissions prend effet immédiatement.

Articles connexes
Avez-vous trouvé la réponse à votre question ?