Connecter vos statistiques Clyo à Claude ou ChatGPT (MCP) – Clyo Systems

À quoi ça sert ?

Le connecteur Clyo MCP permet à un assistant d'intelligence artificielle (Claude ou ChatGPT) de lire les statistiques de votre caisse Clyo et de répondre à vos questions en langage naturel :

« Fais-moi le rapport du mois d'octobre : CA HT, TTC, marge, évolution par rapport à septembre et à octobre de l'an dernier. »
« Où en est mon chiffre d'affaires depuis le 1er janvier par rapport à l'an dernier ? »
« Quelles familles progressent et lesquelles reculent ce trimestre ? »
« Quels sont mes 10 meilleurs clients, et quels bons clients ne sont pas revenus depuis 2 mois ? »
« Qu'a consommé M. Dupont cette année par rapport à l'an dernier ? »

Le connecteur est en lecture seule : il ne modifie jamais les données de caisse.

Informations disponibles

Domaine	Contenu
Rapports de pilotage	Hebdomadaire, mensuel, trimestriel, annuel. Chaque indicateur est comparé à la période précédente, à la même période N-1 et en cumul depuis le 1er janvier (Year To Date) par rapport à N-1.
Indicateurs de vente	CA HT, CA TTC, TVA, remises, quantités, prix d'achat HT et TTC, marge HT et taux de marge, nombre de tickets, couverts, panier moyen.
Détail	Par jour, semaine, mois, trimestre, année, jour de la semaine, heure, zone de vente, famille, article, vendeur, mode de règlement.
Comparaisons	Deux périodes au choix (par exemple octobre 2026 / octobre 2025), en global ou par famille, article, client, zone, vendeur ou règlement.
Clients et fidélité	Top clients, commandes et panier moyen par client, clients inactifs depuis N jours, fiche fidélité, produits consommés par un client comparés à N-1.
Journée en cours	CA et meilleures ventes de la journée non clôturée.

À savoir :

Les rapports portent sur les journées clôturées. La journée en cours est disponible séparément.
La marge utilise le prix d'achat renseigné dans la fiche article. Un article sans prix d'achat est compté avec un achat à 0, ce qui surestime la marge. Pensez à renseigner vos prix d'achat.
Les statistiques clients ne concernent que les tickets rattachés à un compte client (fidélité, compte client, commande nominative).

Deux façons de se connecter

	Claude Desktop (sur un poste Clyo)	ChatGPT, Claude sur le web ou mobile
Où l'utiliser	Sur un poste Windows de l'établissement où Clyo est installé	Partout : navigateur, smartphone
Mise en place	Vous-même, en 2 commandes	Par le support Clyo Systems (accès sécurisé à votre serveur de caisse)

Option 1 : Claude Desktop sur un poste Clyo

Prérequis

Un poste Windows 10 ou 11 (64 bits) sur lequel Clyo est installé (caisse ou poste de gestion) et qui a accès au serveur de caisse.
Le connecteur mcp-clyo.exe dans le dossier C:\Clyo\mcp-clyo\. Il est fourni avec Clyo ; s'il est absent, demandez-le au support Clyo Systems.
Un compte Claude et l'application Claude Desktop pour Windows (téléchargeable sur claude.ai/download), installée sur ce même poste.

Aucun paramétrage n'est nécessaire : le connecteur utilise automatiquement la base et le serveur définis dans la configuration de Clyo (C:\Clyo\configuration.xml).

Installation

Installez Claude Desktop et connectez-vous à votre compte Claude.
Ouvrez une invite de commandes (touche Windows, tapez cmd, Entrée).
Vérifiez la connexion à la base en tapant :
C:\Clyo\mcp-clyo\mcp-clyo.exe --verifier
Le message doit se terminer par Connexion OK.
Déclarez le connecteur dans Claude Desktop :
C:\Clyo\mcp-clyo\mcp-clyo.exe --installer-claude
Quittez complètement Claude Desktop (clic droit sur son icône dans la barre des tâches, Quitter), puis relancez-le.
Ouvrez une nouvelle conversation et posez une question, par exemple : « Quel est mon CA TTC du mois dernier ? ». Claude vous demande l'autorisation d'utiliser le connecteur la première fois.

Pour retirer le connecteur : C:\Clyo\mcp-clyo\mcp-clyo.exe --desinstaller-claude, puis redémarrez Claude Desktop.

Option 2 : ChatGPT ou Claude sur le web et mobile

ChatGPT et Claude (navigateur, smartphone) se connectent depuis Internet. L'equipe de dev de Clyo Systems met en place pour votre établissement un accès sécurisé à votre serveur de caisse : connexion chiffrée (HTTPS), sans ouverture de port sur votre box. Il vous communique l'adresse du connecteur, de la forme https://…/mcp.

Pour autoriser un assistant, vous saisissez votre numéro de licence Clyo (XXXXXX-XXXXXX-XXXXXX-XXXXXX-XXXXXX, avec ou sans tirets). Si le support vous a fourni un code d'accès personnalisé, saisissez ce code à la place.

Le serveur de caisse doit rester allumé pour que l'assistant puisse lire vos statistiques.

Ajouter le connecteur dans ChatGPT

Dans ChatGPT, ouvrez Paramètres > Applications et connecteurs et activez le mode développeur dans les paramètres avancés (selon votre abonnement ChatGPT).
Créez un connecteur : nom Clyo, URL du serveur MCP = l'adresse fournie par le support, authentification OAuth.
Une page « Connexion à vos statistiques Clyo » s'ouvre : saisissez votre numéro de licence et cliquez sur Autoriser.
Dans une conversation, activez le connecteur Clyo et posez votre question.

Ajouter le connecteur dans Claude (web et mobile)

Sur claude.ai, ouvrez Paramètres > Connecteurs, puis Ajouter un connecteur personnalisé.
Nom Clyo, URL = l'adresse fournie par le support, puis Ajouter et Se connecter.
Sur la page « Connexion à vos statistiques Clyo », saisissez votre numéro de licence et cliquez sur Autoriser.
Le connecteur est ensuite disponible dans vos conversations, y compris sur l'application mobile.

Votre licence a été communiquée à une personne qui ne devrait plus avoir accès à vos statistiques (ancien salarié, prestataire) ? Contactez le support : il remplace la licence par un code d'accès personnalisé et révoque immédiatement tous les assistants déjà autorisés. Vous réautorisez ensuite vos assistants avec ce nouveau code.

Ne saisissez votre licence que sur la page « Connexion à vos statistiques Clyo » ouverte depuis votre assistant, jamais dans une conversation.

Confidentialité

Votre base de données reste chez vous. Seuls les résultats demandés (chiffres, listes d'articles, etc.) sont transmis à l'assistant IA pour qu'il puisse vous répondre.
Pour les clients, seuls le nom, le prénom, la raison sociale et la ville sont transmis : jamais l'e-mail, le téléphone ni l'adresse.
Le connecteur utilise un compte en lecture seule : aucune modification de la caisse n'est possible.
En accès distant, seuls les assistants que vous avez autorisés avec votre licence (ou votre code d'accès) peuvent interroger vos statistiques.

En cas de problème

La vérification affiche « ERREUR de connexion » : vérifiez que le serveur de caisse est allumé et que Clyo fonctionne sur ce poste. Le message indique la base et le serveur utilisés.
Claude Desktop ne propose pas le connecteur : vérifiez que Claude Desktop a bien été quitté et relancé après l'installation.
ChatGPT ou claude.ai n'arrive pas à se connecter : vérifiez que le serveur de caisse est allumé, puis contactez le support.
« Code d'accès incorrect » : vérifiez votre numéro de licence. Si le support vous a donné un code personnalisé, c'est ce code qu'il faut saisir.
« Trop de tentatives » sur la page de connexion : attendez 15 minutes avant de réessayer.
Les chiffres d'aujourd'hui n'apparaissent pas dans un rapport : c'est normal tant que la journée n'est pas clôturée. Demandez « les ventes de la journée en cours ».