---
title: "INTÉGRATIONS - Connecter un assistant IA à Qargo via MCP - Guide pas à pas"
description: "Connecter Claude, ChatGPT ou un autre assistant IA à un tenant Qargo. Avec Qargo Intelligence, la configuration se fait en autonomie : un super admin définit l'accès MCP, puis l'utilisateur ajoute le connecteur."
url: https://help.qargo.com/fr/articles/799560-integrations-connecter-un-assistant-ia-a-qargo-via-mcp-guide-pas-a-pas
locale: fr
updated: 2026-09-28
---

# INTÉGRATIONS - Connecter un assistant IA à Qargo via MCP - Guide pas à pas

* * *

## Ce qu'un assistant peut faire {#h_5e80d166ed}

Un assistant accède aux mêmes données que l'API externe de Qargo, au nom d'un utilisateur précis et avec les autorisations propres à cet utilisateur. Consulter la [FAQ sur les options disponibles de l'API Qargo](https://help.qargo.com/fr/articles/320484-faq-qargo-api-available-options) pour connaître le périmètre complet : commandes, tournées, tâches, entreprises, ressources, documents et comptabilité.\
Non disponible via MCP :

-   **Configuration du tenant.** Les indicateurs de fonctionnalités, la configuration des intégrations et les paramètres de l'organisation restent hors de portée.

Un assistant ne voit jamais plus de choses que l'utilisateur pour lequel il agit. Un utilisateur sans accès aux données financières dans Qargo ne peut pas non plus les récupérer via un assistant.

## Avant de commencer {#h_b4f1c2a901}

-   **Qargo Intelligence sur le tenant.** MCP fait partie du module complémentaire Qargo Intelligence. Sans ce module, l'accès MCP n'est pas disponible. Contacter le responsable de compte pour l'ajouter.
-   **Un super admin dans l'organisation.** Seuls les super admins peuvent définir l'accès MCP d'un utilisateur.

:::callout{tone="note"}
**📚 Aucune demande à Qargo n'est nécessaire.** Si le tenant dispose de Qargo Intelligence, le super admin effectue toute la configuration en suivant les étapes ci-dessous.
:::

## Adresse du connecteur {#h_aacc0a5198}

Utiliser [https://mcp.qargo.com/mcp](https://mcp.qargo.com/mcp) dans chaque assistant.

## Étape 1 : définir l'accès MCP de l'utilisateur {#h_d8008c4eff}

L'accès MCP est un paramètre distinct pour chaque utilisateur. Il est réglé par défaut sur **Désactivé** pour tous les utilisateurs, et c'est un super admin qui le définit.

1.  **Accéder** à **Configuration > Paramètres de l'organisation > Utilisateurs**.
2.  **Cliquer** sur l'icône en forme de crayon à côté de l'utilisateur.
3.  **Sélectionner** un niveau sous **Accès MCP**.
4.  **Cliquer** sur **Enregistrer**.

![](https://help.qargo.com/media/7a80365da8ed-Screenshot-2026-08-19-at-16_21_15.png)

| **Niveau** | **Ce que l'assistant peut faire** |
| --- | --- |
| **Désactivé** | Rien. Aucun outil MCP. C'est la valeur par défaut. |
| **Lecture seule** | Toutes les opérations de lecture. Toute opération de création, de mise à jour ou de suppression est refusée. |
| **Lecture et écriture** | Les lectures, ainsi que la création, la mise à jour et la suppression. |

:::callout{tone="warning"}
**‼️ Prudence avec le niveau « Lecture et écriture ».** Un assistant disposant d'un accès en écriture peut modifier ou supprimer des données dans tout le tenant, et une seule mise à jour en masse erronée peut demander des heures de correction. Laisser les utilisateurs en **Lecture seule** par défaut. N'accorder **Lecture et écriture** qu'aux utilisateurs qui en comprennent les conséquences.
:::

## Étape 2 : ajouter le connecteur dans l'assistant {#h_2732958908}

Tout assistant IA compatible avec MCP peut être connecté. Les étapes rapides pour Claude et ChatGPT figurent ci-dessous.

:::details[Claude : étapes rapides]
**Free, Pro ou Max, dans Claude Desktop ou l'application web**

1.  **Accéder** à **Personnaliser > Connecteurs**.
2.  **Cliquer** sur **Ajouter** en haut à droite du panneau **Connecteurs**, puis sur **Ajouter un connecteur personnalisé**.
3.  **Saisir** Qargo comme nom et [https://mcp.qargo.com/mcp](https://mcp.qargo.com/mcp) comme URL du serveur MCP distant, puis cliquer sur **Continuer**.
4.  **Laisser** les champs **Authentification** et **Client OAuth** tels que Claude les remplit. Les paramètres détectés sont les bons pour Qargo.
5.  **Cliquer** sur **Ajouter**, puis sur **Connecter**, et se connecter avec les identifiants Qargo.

**Team ou Enterprise, dans Claude Desktop ou l'application web**

1.  **Ajouter** le connecteur une seule fois en tant que propriétaire (Owner), sous **Paramètres de l'organisation > Connecteurs > Ajouter > Personnalisé**, avec le nom et l'URL ci-dessus.
2.  **Connecter** son propre compte en tant que membre, sous **Personnaliser > Connecteurs**, puis se connecter avec les identifiants Qargo.

**Claude Code**

1.  **Vérifier** d'abord avec claude mcp list. Un connecteur déjà ajouté sur [claude.ai](http://claude.ai) se charge automatiquement pour le même compte.
2.  **Exécuter** claude mcp add --transport http qargo [https://mcp.qargo.com/mcp](https://mcp.qargo.com/mcp) dans le projet qui a besoin de l'accès, si Qargo n'y figure pas déjà.
3.  **Saisir** /mcp, sélectionner qargo, choisir **Authenticate**, puis se connecter lorsque le navigateur s'ouvre.

Étapes complètes et dépannage : INTÉGRATIONS - Claude : se connecter à Qargo via MCP.
:::

:::details[ChatGPT : étapes rapides]
**Business, Enterprise ou Education**

1.  **Publier** l'application une seule fois en tant qu'admin : activer le mode développeur sous **Paramètres > Applications > Paramètres avancés**, puis aller dans **Paramètres de l'espace de travail > Applications > Créer**, saisir le nom et le point de terminaison ci-dessus, sélectionner OAuth, cliquer sur **Scanner les outils**, puis sur **Créer**. Tester le brouillon, le publier depuis **Brouillons** et définir l'accès des utilisateurs.
2.  **Connecter** son propre compte en tant que membre : ouvrir l'application Qargo, se connecter avec les identifiants Qargo, puis sélectionner l'application pour le message.

**Plus ou Pro**

1.  **Ouvrir** les paramètres de ChatGPT, puis **Applications > Paramètres avancés**, et activer le mode développeur.
2.  **Créer** un connecteur personnalisé nommé Qargo, avec [https://mcp.qargo.com/mcp](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.
4.  **Scanner** les outils, se connecter avec les identifiants Qargo et approuver la demande d'accès.
5.  **Sélectionner** le connecteur pour le message.

**Avec Plus et Pro, la lecture fonctionne ; la modification des données, non.** La prise en charge complète de MCP, qui permet les modifications, est actuellement limitée aux offres Business, Enterprise et Education. Les offres Free ne permettent pas du tout d'ajouter des connecteurs personnalisés.\
Étapes complètes et dépannage : INTÉGRATIONS - ChatGPT : se connecter à Qargo via MCP.
:::

L'article propre à chaque assistant détaille la configuration complète, les offres requises et le dépannage spécifique.

| **Assistant** | **Qui le configure** | **Article** |
| --- | --- | --- |
| Claude Desktop, [claude.ai](http://claude.ai) et Claude Code | Un propriétaire (Owner) avec Team et Enterprise ; chaque utilisateur avec Free, Pro, Max et Claude Code | [INTÉGRATIONS - Claude : se connecter à Qargo via MCP](https://help.qargo.com/fr/articles/799799-integrations-claude-connect-to-qargo-over-mcp-walkthrough) |
| ChatGPT | Un admin avec Business, Enterprise et Education. Chaque utilisateur avec Plus et Pro, en accès lecture seule | [INTÉGRATIONS - ChatGPT : se connecter à Qargo via MCP](https://help.qargo.com/fr/articles/800127-integrations-chatgpt-connect-to-qargo-over-mcp-walkthrough) |

:::callout{tone="note"}
**📚 Les assistants déplacent leurs paramètres.** Les chemins de menu changent selon les versions et les offres. Si un chemin ci-dessus ne correspond pas à l'écran, rechercher _connecteurs_ ou _mode développeur_ dans les paramètres de l'assistant.
:::

* * *

## Approuver une modification des données de production {#h_a09f7aa185}

Les requêtes de lecture s'exécutent immédiatement. La première fois qu'un assistant tente de modifier des données dans un tenant de production, Qargo bloque l'opération et renvoie un lien d'approbation.

1.  **Ouvrir** le lien d'approbation dans un navigateur où la connexion à Qargo est déjà active.
2.  **Vérifier** le tenant indiqué sur la page d'approbation et s'assurer qu'il s'agit du bon.
3.  **Approuver** la session.
4.  **Revenir** à l'assistant et lui demander de relancer la modification.

L'approbation couvre uniquement cet utilisateur, ce tenant et cette session de l'assistant. Une nouvelle session nécessite une nouvelle approbation.

:::callout{tone="warning"}
‼️ **Approuver une session autorise toutes les modifications suivantes dans cette session, et pas seulement celle demandée.** Vérifier toute modification proposée par un assistant avant de l'approuver, en particulier les modifications portant sur plusieurs enregistrements.
:::

* * *

## Utilisation au quotidien {#h_db1bb1d2f9}

-   **Les sessions expirent.** Il peut être nécessaire de réauthentifier périodiquement le connecteur pour rester connecté, en pratique environ une fois par jour.
-   **Le reporting n'est pas pris en charge.** Adresser plutôt les demandes de totaux, de moyennes ou de tableaux de bord à BigQuery ou à l'API externe.
-   **Les limites de débit sont partagées** avec le reste du trafic API du tenant.

:::callout{tone="note"}
📚 **Les assistants IA peuvent se tromper.** Vérifier le résultat avant de s'y fier, et examiner toute modification proposée des données de production avant de l'approuver.
:::

* * *

## Dépannage {#h_0d3c38c58d}

| **Problème** | **Solution** |
| --- | --- |
| Le paramètre **Accès MCP** est absent lors de la modification d'un utilisateur | L'utilisateur connecté n'est pas super admin, ou le tenant ne dispose pas de Qargo Intelligence. Pour Qargo Intelligence, contacter le responsable de compte. |
| L'assistant indique que l'accès MCP n'est pas activé pour l'utilisateur | Cet utilisateur est toujours réglé sur **Désactivé**. Un super admin définit le niveau dans **Configuration > Paramètres de l'organisation > Utilisateurs**. |
| Une lecture fonctionne mais une modification est refusée | L'utilisateur est réglé sur **Lecture seule**. Un super admin peut modifier le niveau. Avec ChatGPT Plus et Pro, aucune modification n'est possible, quel que soit le niveau défini dans Qargo. |
| L'assistant indique que l'accès est refusé et mentionne Qargo Intelligence | Qargo Intelligence n'est pas activé sur le tenant. Contacter le responsable de compte. |
| L'assistant peut lister les tenants mais toutes les autres requêtes échouent | L'accès à l'API externe n'est pas activé sur le tenant. Contacter le responsable de compte. |
| L'assistant redemande une approbation dans la même conversation | Une nouvelle session a démarré. Ouvrir le nouveau lien d'approbation et approuver à nouveau. |
| L'assistant cesse de répondre après de nombreuses requêtes | La limite de débit du tenant est atteinte. Attendre le délai indiqué dans la réponse. |
| Problèmes de configuration propres à un assistant | Consulter la section de dépannage de l'article de configuration de cet assistant. |


## Articles connexes

- [Intégrations : API Qargo – quoi, pourquoi et comment](https://help.qargo.com/fr/articles/865547-integrations-api-qargo-quoi-pourquoi-et-comment.md)
- [Intégrations – configuration de WhatsApp](https://help.qargo.com/fr/articles/355075-integrations-configuration-de-whatsapp.md)
- [FAQ : se connecter à Qargo](https://help.qargo.com/fr/articles/374948-faq-se-connecter-a-qargo.md)
- [VIDÉO - Comment créer des tableaux de bord personnalisés ?](https://help.qargo.com/fr/articles/892715-video-comment-creer-des-tableaux-de-bord-personnalises.md)
- [ROLES UTILISATEUR, PERMISSIONS ET VISIBILITÉ](https://help.qargo.com/fr/articles/180518-roles-utilisateur-permissions-et-visibilite.md)
