Connecter QrX à votre assistant IA (MCP)

Vous pouvez connecter QrX à un assistant IA comme Claude, ChatGPT ou Cursor. Ensuite, vous posez vos questions en langage courant, par exemple "Quels produits sont en stock faible ?", "Combien de commandes attendent d'être emballées ?", "Quel est le statut de paiement de la commande 10452 ?" ou "Qu'est-ce qui demande mon attention aujourd'hui ?". L'assistant lit la réponse directement dans votre compte QrX. Si vous l'autorisez, l'assistant peut aussi effectuer quelques modifications d'entrepôt, toujours après votre confirmation.

La connexion utilise MCP (Model Context Protocol), le standard ouvert qui permet aux assistants IA de communiquer avec d'autres logiciels. QrX exploite un serveur MCP ; votre assistant s'y connecte comme connecteur personnalisé.

Qui peut l'utiliser

Le connecteur IA est inclus dans les formules payantes de QrX. Il n'y a pas de prix séparé.
Vous vous connectez avec votre propre compte du portail QrX. L'assistant reçoit les mêmes droits que vous dans QrX, jamais plus.
Les questions sur le stock et l'entrepôt ainsi que les modifications d'entrepôt nécessitent le module QrX Warehouse (WMS). Les questions sur les retours nécessitent l'autorisation de gérer les retours dans votre rôle QrX. Les outils d'un module que vous n'utilisez pas ne sont pas proposés à l'assistant.
Les comptes administrateur QrX ne peuvent pas se connecter. Si vous consultez PortalX en tant qu'un autre utilisateur, arrêtez d'abord et connectez-vous avec votre propre compte.
Les questions CRM nécessitent les autorisations CRM de votre rôle QrX (chaque compte QrX dispose du plan CRM gratuit). Les modifications CRM nécessitent aussi l'autorisation de modifier le CRM.

Ce dont vous avez besoin

Un assistant IA qui prend en charge les connecteurs MCP personnalisés (aussi appelés serveurs MCP distants ou applications personnalisées).
L'URL du serveur MCP de QrX : https://api.qr-x.net/mcp
Votre compte du portail QrX (celui que vous utilisez sur portal.qr-x.app).

Comment se connecter (tous les assistants)

Dans votre assistant IA, ouvrez l'endroit où vous ajoutez des connecteurs et choisissez d'ajouter un connecteur personnalisé (ou un serveur MCP personnalisé).
Donnez-lui un nom, par exemple "QrX", et saisissez l'URL du serveur https://api.qr-x.net/mcp. Vous n'avez besoin ni de clé API, ni d'identifiant client, ni de secret.
Lancez la connexion. Le portail QrX s'ouvre. Connectez-vous avec votre compte du portail QrX si ce n'est pas déjà fait.
La page QrX "Connecter [assistant] à QrX" indique l'application, l'adresse vers laquelle vous êtes renvoyé et la liste de ce que l'assistant peut lire. Cochez uniquement ce que vous voulez partager. La signification de chaque option est expliquée dans "Ce que le connecteur IA de QrX peut et ne peut pas faire".
Facultatif : cochez Modifications d'entrepôt si l'assistant peut aussi effectuer des modifications d'entrepôt. Cette option est désactivée par défaut et nécessite Stock et entrepôt.
Facultatif : cochez Modifications CRM si l'assistant peut créer ou modifier des personnes, entreprises, affaires, notes et tâches CRM, déplacer des affaires et lancer un appel. Désactivé par défaut ; nécessite CRM.
Facultatif : cochez Réponses du Centre de messages, Traitement des retours, Étiquettes de commande ou Modifications de produits si l'assistant peut aussi répondre dans les conversations, traiter les retours, modifier les étiquettes de commande ou retirer un produit de la vente et définir son stock. Chaque option est désactivée par défaut et nécessite son option de lecture (Texte des messages, Retours, Commandes, Produits). Voir « Utiliser le connecteur IA QrX pour les conversations, les retours, les commandes et les produits ».
Cliquez sur Autoriser. Vous revenez à votre assistant et la connexion est prête. Cliquez sur Refuser pour annuler sans vous connecter.

La nouvelle connexion apparaît désormais dans QrX sous Paramètres > Avancé > Applications connectées.

Étapes selon l'assistant

Les noms des menus des assistants IA changent souvent. Si une étape ci-dessous ne correspond pas à ce que vous voyez, suivez les étapes générales ci-dessus et les pages d'aide de votre assistant. Les noms des menus sont indiqués en anglais, comme dans l'assistant.

Claude (Free, Pro et Max) : allez dans Customize > Connectors, cliquez sur + puis sur Add custom connector, saisissez le nom et l'URL https://api.qr-x.net/mcp, continuez puis connectez-vous avec QrX. Activez le connecteur dans une conversation avec le bouton +, Connectors. Avec la formule Claude Free, vous pouvez ajouter un connecteur personnalisé.
Claude (Team et Enterprise) : un Owner ajoute le connecteur une fois sous Organization settings > Connectors, Add, Custom, Web, avec la même URL. Chaque membre va ensuite dans Customize > Connectors, trouve QrX et clique sur Connect pour se connecter avec son propre compte QrX.
ChatGPT (Business, Enterprise et Edu) : les applications MCP personnalisées nécessitent le developer mode, activé par un administrateur de l'espace de travail. Allez ensuite dans Settings > Apps > Create (les administrateurs peuvent aussi utiliser Workspace settings), saisissez l'URL https://api.qr-x.net/mcp, choisissez OAuth, cliquez sur Scan Tools, connectez-vous avec QrX et cliquez sur Create.
Cursor : ajoutez QrX comme serveur MCP distant avec l'URL https://api.qr-x.net/mcp (dans les paramètres MCP ou dans mcp.json), puis connectez-vous avec QrX lorsque Cursor le demande.

Chaque personne se connecte avec son propre compte QrX, même lorsqu'un connecteur est partagé dans un espace de travail d'équipe. L'assistant ne voit alors que ce que cette personne peut voir dans QrX.

Bon à savoir

"Non vérifiée" sur la page de connexion signifie que QrX n'a pas vérifié l'application et que l'application a choisi son propre nom. Continuez uniquement si vous avez lancé la connexion vous-même depuis un assistant de confiance. La page indique où vont vos données.
Ce que l'assistant lit est envoyé à l'entreprise qui exploite votre assistant IA, afin qu'il puisse vous répondre. Ne partagez que le nécessaire. Le texte des messages n'est jamais partagé, sauf si vous cochez Texte des messages.
Vous pouvez vous déconnecter à tout moment dans Paramètres > Avancé > Applications connectées. Voir "Déconnecter (révoquer) une application IA connectée".
En savoir plus sur le connecteur IA de QrX : qrx.eu/mcp.

Problèmes fréquents

"Ce lien de connexion n'est pas valide" : le lien a expiré ou a déjà été utilisé. Relancez la connexion depuis votre assistant IA.
"Connectez-vous pour continuer" : votre session QrX a expiré. Reconnectez-vous et la connexion reprend.
"Votre compte ne peut pas connecter d'applications" : votre compte n'a pas accès au portail QrX. Demandez l'accès à un administrateur de votre entreprise.
"Les comptes administrateur QrX ne peuvent pas se connecter" : connectez-vous plutôt avec un compte marchand.
Une option de la page de connexion est grisée : "Ce module n'est pas actif sur votre compte" signifie que vous n'utilisez pas ce module QrX. "Votre rôle ne le permet pas" signifie que votre rôle QrX n'a pas le droit ; adressez-vous à un administrateur de votre compte.
L'assistant indique qu'il n'a pas accès ou vous demande de vous reconnecter : la connexion a été coupée, par exemple dans Applications connectées, parce que vous vous êtes déconnecté sur tous les appareils, ou après une réinitialisation du mot de passe. Connectez-vous à nouveau.
L'assistant indique qu'une limite est atteinte : attendez une minute et réessayez. Les limites sont décrites dans "Ce que le connecteur IA de QrX peut et ne peut pas faire".

Quand contacter notre équipe support

Contactez le support QrX si la connexion échoue malgré les étapes, si vous voyez dans Applications connectées une connexion que personne dans votre entreprise ne reconnaît, ou si l'assistant affiche des données qu'il ne devrait pas voir selon vous. Indiquez l'assistant utilisé, l'heure de la tentative et le message exact affiché. N'envoyez jamais de mots de passe ni de jetons.