Connecter Claude à Odoo tient en quatre étapes : installer un module MCP dans Odoo, activer le serveur MCP dans les Paramètres, ajouter l’URL obtenue comme connecteur personnalisé dans Claude, puis s’authentifier avec une clé API Odoo ou via OAuth. L’ensemble prend moins de quinze minutes sur une instance On-Premise ou Odoo.sh. Ce guide détaille chaque étape et ce à quoi s’attendre concrètement.
Avant de commencer : votre hébergement Odoo le permet-il ?
Un serveur MCP Odoo s’installe comme un module, ce qui suppose une base où vous pouvez installer des applications personnalisées : On-Premise ou Odoo.sh. Odoo Online (l’offre SaaS standard) n’autorise pas l’installation de modules hors de la liste contrôlée de l’Apps Store, ce qui exclut cette configuration sur ce palier d’hébergement. Vérifiez votre hébergement avant d’aller plus loin — c’est le blocage le plus fréquent.
Étape 1 : installer le module MCP dans Odoo
Les applications Odoo s’installent normalement depuis l’Apps Store : ouvrez l’application Apps depuis votre tableau de bord, cherchez le module, puis cliquez sur Activer sur sa fiche. S’il n’apparaît pas encore, activez le mode développeur, allez dans Apps ‣ Mettre à jour la liste des applications, puis cliquez sur Mettre à jour — cela rafraîchit ce que votre instance peut voir.
Si vous installez un module téléchargé plutôt que récupéré depuis le store — par exemple un fichier zip — la méthode dépend de son contenu. Un module composé uniquement de fichiers XML/données peut parfois s’importer directement depuis l’interface Apps. Un module contenant du code Python (ce qui est le cas d’un module serveur MCP) doit être décompressé dans le dossier addons de votre instance, suivi d’un redémarrage du serveur, puis d’une Mise à jour de la liste des applications, puis d’une Installation depuis l’écran Apps. Sur Odoo.sh, cette étape du dossier addons passe par votre dépôt (le module vit dans votre code et se déploie avec votre branche) ; sur un serveur On-Premise auto-hébergé, c’est une copie de fichiers suivie d’un redémarrage du service Odoo.
Cledoo MCP en particulier est référencé sur l’Odoo Apps Store — il s’installe comme n’importe quelle autre application, sans copie manuelle de fichiers si vous passez par le store.
Étape 2 : activer le serveur MCP dans les Paramètres
Une fois installé, le module ajoute un menu sous Paramètres. Activer le MCP à
cet endroit est ce qui met en service le point de terminaison /mcp sur votre
instance — avant ce basculement, le module est présent mais le serveur n’écoute
pas. C’est aussi là que vous trouverez l’URL de votre instance, généralement
l’URL de base de votre Odoo suivie de /mcp (par exemple
https://votreentreprise.odoo.com/mcp). Copiez cette URL, vous en aurez besoin
dans Claude.
Étape 3 : choisir une méthode d’authentification — clé API ou OAuth
Deux méthodes permettent d’authentifier Claude auprès de votre point de
terminaison Odoo /mcp.
Clé API. Les clés API Odoo se génèrent depuis votre propre compte utilisateur, pas depuis un panneau d’administration : allez dans Préférences (votre profil), ouvrez l’onglet Sécurité du compte, cliquez sur Nouvelle clé API, donnez-lui une description claire, puis cliquez sur Générer une clé. Odoo affiche la clé une seule fois — copiez-la immédiatement, car elle ne pourra plus être récupérée ensuite (seulement régénérée). Sous Odoo 19, les clés nécessitent aussi une durée de validité et ne peuvent pas dépasser trois mois, donc prévoyez de les faire tourner. Une clé API agit comme votre mot de passe pour les appels API : tout ce que votre utilisateur peut voir et faire dans Odoo, les appels effectués avec cette clé le peuvent aussi.
OAuth 2.1. Si le module le prend en charge (c’est le cas de Cledoo MCP, en plus des clés API), se connecter via OAuth signifie que Claude vous redirige vers un écran de consentement Odoo où vous vous connectez et approuvez la connexion — aucune clé à copier ni à stocker. C’est la meilleure option quand plusieurs personnes vont chacune connecter leur propre compte Claude à la même instance Odoo, puisque chaque personne s’authentifie en son nom propre plutôt que de partager une clé unique.
Dans les deux cas, la session qui en résulte s’exécute sous votre propre utilisateur Odoo et ses droits d’accès existants — règles d’enregistrement, permissions au niveau des champs, tout. Claude ne peut voir ni toucher rien de plus que ce que votre compte Odoo autorise déjà.
Étape 4 : ajouter le connecteur dans Claude
Sur claude.ai, allez dans Personnaliser > Connecteurs, cliquez sur le bouton
+, puis sélectionnez Ajouter un connecteur personnalisé. Collez votre URL
Odoo /mcp obtenue à l’étape 2. Si vous utilisez OAuth, Claude vous guidera à
travers le flux de connexion/consentement Odoo lors de la première connexion. Si
vous utilisez une clé API, ouvrez Paramètres avancés et ajoutez-la comme
en-tête de requête (généralement Authorization: Bearer <votre-clé>) — les
en-têtes de requête sont le bon choix quand l’identifiant est une clé fixe plutôt
qu’une connexion personnelle. Cliquez sur Ajouter pour terminer.
Si votre organisation utilise Claude for Enterprise ou Team, un administrateur configure généralement le connecteur une seule fois depuis Paramètres de l’organisation > Connecteurs (en sélectionnant « Personnalisé » puis « Web », et en saisissant l’URL), après quoi chaque membre connecte son propre compte depuis Personnaliser > Connecteurs en cliquant sur Connecter à côté du connecteur ajouté par son administrateur.
Pour Claude Desktop, la configuration est équivalente : les serveurs MCP distants
s’ajoutent de la même façon via les paramètres de connecteurs, et Claude se
connecte à l’URL publique de votre serveur — ce qui signifie que cette URL doit
être joignable depuis internet, pas derrière un VPN ni liée uniquement à
localhost.
Étape 5 : faire un premier test
Une fois connecté, posez à Claude une question simple et vérifiable, comme
« liste mes 5 derniers clients dans Odoo » ou « combien j’ai de commandes de
vente ouvertes ». Si la réponse contient de vraies données, toute la chaîne —
point de terminaison, authentification et système de permissions d’Odoo —
fonctionne de bout en bout. Si Claude signale qu’il ne trouve aucun outil,
vérifiez d’abord : le MCP est-il bien activé dans les Paramètres Odoo, l’URL
est-elle exacte (avec le /mcp), et le serveur est-il joignable depuis
internet.
Ce que « connecté » donne réellement à Claude
Une fois la connexion établie, Claude découvre les outils exposés par votre serveur MCP Odoo — lecture d’enregistrements, recherche dans les modèles, et selon le palier du module, création ou modification. Le palier Classic gratuit de Cledoo MCP fournit 17 outils par défaut ; le palier Pro payant ajoute des contrôles de gouvernance (journal d’audit, masquage de champs, workflows d’approbation pour les écritures) sur la même connexion. Rien de tout cela ne change les étapes ci-dessus — le parcours installation-et-connexion est identique quel que soit le palier.
À retenir
Quatre conditions doivent être réunies pour que Claude parle à Odoo : l’hébergement permet les modules personnalisés (On-Premise/Odoo.sh), le module MCP est installé et activé, Claude dispose d’un identifiant valide (clé API ou OAuth), et l’URL du connecteur est correcte et joignable. Une fois ces quatre points réglés, la connexion fonctionne sous vos propres permissions Odoo dès la première requête.