Skip to main content
Qargo

INTÉGRATIONS - ChatGPT : se connecter à Qargo via MCP - Guide pas à pas

Connecter un compte Qargo à ChatGPT, puis interroger ChatGPT sur les données en temps réel. Sur les forfaits Business, Enterprise et Education, un propriétaire de l'espace de travail publie d'abord l'application Qargo. Sur Plus et Pro, l'utilisateur l'ajoute directement.

Table des matières
  1. Prérequis
  2. Business, Enterprise et Education : publier l’application
  3. Connecter le compte Qargo
  4. Plus et Pro : ajouter le connecteur soi-même
  5. Modification des données
  6. Dépannage

Prérequis

  • Qargo Intelligence sur le tenant. MCP fait partie du module complémentaire Qargo Intelligence. À défaut, contacter le responsable de compte.
  • Accès MCP défini pour l’utilisateur. Un super admin de l’organisation le définit dans Configuration > Paramètres de l’organisation > Utilisateurs. Aucune demande à Qargo n’est nécessaire. Voir INTÉGRATIONS - Connecter un assistant IA à Qargo via MCP pour la procédure.
  • Les identifiants Qargo habituels. Aucune clé ni aucun jeton distincts ne sont nécessaires.
  • ChatGPT sur le web. Les applications MCP personnalisées ne fonctionnent pas dans les applications mobiles ChatGPT.
Forfait Qui ajoute l’application Qargo Possibilités
Business, Enterprise ou Education Un admin ou un propriétaire, une seule fois pour l’espace de travail Lire et modifier les données, selon le niveau d’accès MCP Qargo de l’utilisateur
Plus ou Pro L’utilisateur, pour son propre compte Lecture des données uniquement. OpenAI limite les connecteurs personnalisés des forfaits individuels à la lecture et à la récupération
Free Personne. Les connecteurs personnalisés nécessitent un forfait payant. Aucune

Business, Enterprise et Education : publier l’application

Un admin ou un propriétaire ajoute l’application Qargo une seule fois. Les membres s’authentifient ensuite individuellement.

Conditions requises

  • Droits d’admin ou de propriétaire. Seuls les admins et les propriétaires peuvent activer le mode développeur et publier une application. Un admin ne peut pas activer le mode développeur à la place d’un membre.
  • Accès MCP défini dans Qargo pour les utilisateurs qui en ont besoin. Un super admin le définit pour chaque utilisateur dans Configuration > Paramètres de l’organisation > Utilisateurs. Effectuer ce réglage avant la publication, pour que les membres puissent s’authentifier immédiatement.

Activer le mode développeur

Les applications MCP personnalisées sont accessibles uniquement en mode développeur, et chaque admin l’active pour son propre compte.

  • Business. Ouvrir Paramètres > Applications > Paramètres avancés et activer le mode développeur. Il est aussi possible de l’activer lors de la création de l’application.
  • Enterprise et Education. Un admin accorde d’abord l’accès dans Paramètres de l’espace de travail > Autorisations et rôles > Données connectées. Chaque personne autorisée l’active ensuite dans Paramètres > Applications > Paramètres avancés.

Ajouter et publier l’application Qargo

  1. Accéder à Paramètres de l’espace de travail > Applications, puis cliquer sur Créer.
  2. Saisir Qargo comme nom et https://mcp.qargo.com/mcp comme point de terminaison.
  3. Sélectionner OAuth comme méthode d’authentification. Laisser l’ID client et le secret vides : Qargo ne fournit ni l’un ni l’autre.
  4. Cliquer sur Scanner les outils, se connecter lorsque la fenêtre de connexion s’affiche, puis attendre la fin du scan.
  5. Cliquer sur Créer. L’application apparaît dans Paramètres de l’espace de travail > Applications > Brouillons.
  6. Tester le brouillon dans une nouvelle conversation avant de le publier.
  7. Publier l’application depuis Brouillons, puis définir qui peut y accéder.

Contrôler qui peut l’utiliser

La publication rend l’application disponible. Elle ne donne accès aux données Qargo à personne.

  • Définir l’accès des utilisateurs pour que seules les personnes prévues puissent utiliser l’application. Sur Enterprise et Education, il est aussi possible de choisir les actions autorisées pour l’application avant la publication.
  • Définir la confirmation des actions pour décider quand ChatGPT demande une confirmation avant d’appeler un outil.
  • Laisser Qargo gérer les autorisations Qargo. Chaque membre s’authentifie séparément et ne reçoit que ses propres autorisations Qargo.

Indiquer aux membres de suivre la section suivante.


Connecter le compte Qargo

L’application Qargo doit déjà figurer dans la liste des applications. Sinon, contacter l’admin de l’espace de travail. Les membres ne peuvent pas l’ajouter eux-mêmes.

  1. Ouvrir l’application Qargo dans ChatGPT.
  2. Se connecter avec les identifiants Qargo habituels lorsque le navigateur s’ouvre.
  3. Approuver la demande d’accès. Le navigateur revient à ChatGPT.
  4. Sélectionner l’application Qargo pour le message, puis demander à ChatGPT de lister les tenants Qargo. Une réponse qui mentionne le tenant confirme que la connexion fonctionne.

Plus et Pro : ajouter le connecteur soi-même

Sur un forfait payant individuel, il n’est pas nécessaire d’attendre un admin, mais les données Qargo sont uniquement consultables, pas modifiables. Les connecteurs personnalisés ne sont accessibles qu’en mode développeur, dans l’application web.

  1. Ouvrir les paramètres de ChatGPT, puis Applications > Paramètres avancés, et activer le mode développeur.
  2. Cliquer sur Créer pour ajouter un connecteur personnalisé.
  3. Saisir Qargo comme nom et https://mcp.qargo.com/mcp comme point de terminaison.
  4. Sélectionner OAuth comme méthode d’authentification. Laisser l’ID client et le secret vides.
  5. Scanner les outils, puis se connecter avec les identifiants Qargo habituels et approuver la demande d’accès.
  6. Sélectionner le connecteur pour le message, puis demander à ChatGPT de lister les tenants Qargo.

Modification des données

Cette section concerne les espaces de travail Business, Enterprise et Education. Sur Plus et Pro, ChatGPT peut lire les données Qargo mais pas les modifier.
La première modification de données de production au cours d’une session est bloquée, et ChatGPT renvoie un lien d’approbation. Ouvrir ce lien, approuver, puis demander à ChatGPT de réessayer. La procédure complète figure dans INTÉGRATIONS - Connecter un assistant IA à Qargo via MCP.


Dépannage

Problème Solution
L’application Qargo ne figure pas dans la liste des applications Elle n’a pas été publiée dans l’espace de travail. Contacter l’admin de l’espace de travail. Sur Plus ou Pro, l’ajouter soi-même en suivant les étapes ci-dessus.
Le toggle du mode développeur est absent Soit le forfait ne l’inclut pas, soit il n’a pas été accordé au niveau de l’espace de travail. Sur Enterprise et Education, un admin accorde d’abord l’accès, dans Autorisations et rôles > Données connectées. Il s’agit d’une règle, pas d’une panne.
Les connecteurs personnalisés sont introuvables sur le téléphone Les applications MCP personnalisées fonctionnent uniquement sur le web. Utiliser ChatGPT dans un navigateur.
Le scan des outils ne renvoie rien Vérifier que le point de terminaison est exactement https://mcp.qargo.com/mcp. Une barre oblique finale ou un chemin manquant empêche la détection.
L’application est publiée, mais les membres ne voient aucun outil Qargo Les membres ne se sont pas encore authentifiés, ou leur accès MCP est toujours sur Désactivé dans Configuration > Paramètres de l’organisation > Utilisateurs. Vérifier les deux points.
Les appels d’outils échouent depuis une mise à jour de Qargo ChatGPT utilise la liste d’outils enregistrée lors de la publication de l’application. Demander à l’admin d’actualiser les actions de l’application dans Paramètres de l’espace de travail > Applications. Sur les forfaits Business, l’application doit être recréée et republiée.
ChatGPT indique que l’accès MCP n’est pas activé pour l’utilisateur L’accès est toujours défini sur Désactivé. Demander à un super admin de le définir dans Configuration > Paramètres de l’organisation > Utilisateurs.
Qargo demande de se connecter à répétition Les sessions expirent, en pratique environ une fois par jour ; une nouvelle authentification occasionnelle est donc normale. Si cela se produit beaucoup plus souvent, contacter l’assistance Qargo.
Le navigateur affiche une erreur de client inconnu lors de la connexion Demander à l’admin de l’espace de travail de retirer puis de republier l’application. Cela peut se produire après une mise à jour de la plateforme Qargo.
ChatGPT ignore Qargo et répond à partir de connaissances générales Sélectionner l’application Qargo pour ce message et mentionner Qargo dans la question.
Une lecture fonctionne, mais une modification est refusée Soit l’utilisateur est en Lecture seule dans Qargo (un super admin peut modifier ce réglage dans Configuration > Paramètres de l’organisation > Utilisateurs), soit l’utilisateur dispose de ChatGPT Plus ou Pro, où les connecteurs personnalisés sont limités à la lecture.