Aidoo
Odoo et Claude Code

Connecter Odoo à Claude Code par MCP

Claude Code, l'assistant de développement d'Anthropic qui travaille dans votre terminal, peut lire votre Odoo pendant que vous codez : structure des modèles, champs, données réelles. Une commande suffit pour l'ajouter, et l'autorisation se fait par OAuth. Ce guide s'adresse aux développeurs et intégrateurs Odoo, de la version 16 à la version 20.

Esteban ANTONIO-MOTA · Procédure vérifiée le 10 novembre 2026

📌 À retenir

  • Une commande ajoute le serveur : claude mcp add --transport http aidoo https://mcp.aidoo.ai/mcp.
  • Tapez ensuite /mcp dans Claude Code pour vous authentifier dans le navigateur.
  • Portée user pour l'avoir dans tous vos projets, project pour partager la configuration dans le dépôt (fichier .mcp.json, sans secret).
  • Lecture seule par défaut : vous explorez une base sans risque de la modifier.

Pourquoi brancher Claude Code sur Odoo

Quand vous développez pour Odoo, une bonne part du temps passe à vérifier : quel est le nom exact de ce champ, quel module l'ajoute, combien d'enregistrements sont concernés. Branché sur votre base, Claude Code répond à ces questions lui-même.

Imaginez que vous écrivez un rapport sur les commandes de vente d'un client. Au lieu d'activer le mode développeur d'Odoo pour lister les champs, vous demandez à Claude Code : « Quels champs de sale.order concernent la livraison dans cette base ? ». Il lit la structure du modèle, modules personnalisés compris, et écrit le code avec les bons noms.

  • Écrire un module avec les vrais champs : types, relations et champs ajoutés par les modules installés.
  • Vérifier une donnée sans quitter le terminal : combien de commandes ont tel statut, quels produits n'ont pas de catégorie.
  • Préparer un import ou une migration : repérer les champs vides, comparer des valeurs, compter les doublons.
  • Écrire un domaine de recherche Odoo et le tester aussitôt sur les données réelles.

Ce qu'il vous faut

Trois prérequis :

Ajouter Aidoo à Claude Code

Quatre commandes, dans le terminal puis dans Claude Code.

  1. Étape 1. Ajoutez le serveur

    Dans votre terminal, depuis le dossier du projet :

    Terminal
    claude mcp add --transport http aidoo https://mcp.aidoo.ai/mcp

  2. Étape 2. Choisissez la portée

    Sans option, le serveur n'est disponible que dans le projet courant, pour vous seul. Ajoutez --scope user pour l'avoir dans tous vos projets, ou --scope project pour l'inscrire dans le fichier .mcp.json du dépôt et le partager avec l'équipe. Ce fichier ne contient aucun secret : chaque développeur s'authentifie avec son propre compte.

    Terminal
    claude mcp add --transport http aidoo --scope user https://mcp.aidoo.ai/mcp

  3. Étape 3. Authentifiez-vous

    Lancez Claude Code, tapez /mcp, choisissez aidoo et suivez la connexion dans le navigateur : connexion à Aidoo, choix de l'espace de travail, droits du connecteur, autorisation. Seule la lecture est cochée par défaut.

    Claude Code
    /mcp

  4. Étape 4. Vérifiez

    La commande suivante liste vos serveurs MCP et leur état. Posez ensuite une première question, par exemple : « Liste les modèles Odoo dont le nom contient invoice ».

    Terminal
    claude mcp list

Exemples de demandes

Quelques demandes qui font gagner du temps à un développeur Odoo :

  • « Décris le modèle res.partner de cette base, champs personnalisés compris. »
  • « Combien de produits n'ont pas de catégorie ? Donne-moi les 10 premiers. »
  • « Écris le domaine Odoo qui sélectionne les devis envoyés il y a plus de 15 jours, puis teste-le. »
  • « Compare la répartition des statuts de stock.picking sur les trois derniers mois. »

D'autres demandes, classées par service, sont dans les recettes par métier.

Bonnes pratiques

Claude Code enchaîne facilement des dizaines d'appels. Quelques règles simples gardent la base en sécurité :

  • Pour développer, branchez de préférence un espace Aidoo relié à une base de test plutôt qu'à la production.
  • Gardez la lecture seule, et n'ajoutez l'écriture que pour une tâche précise.
  • Partagez la configuration avec --scope project plutôt que de faire circuler des identifiants : le fichier .mcp.json ne contient que l'adresse.
  • Pour Cursor ou Windsurf, qui n'utilisent pas OAuth, suivez le guide des clients locaux avec une clé API Aidoo.

Aller plus loin : créer des modules Odoo

Vous voulez aussi générer, tester et déployer des modules Odoo depuis Claude ? C'est le rôle d'Aidoo Modules : le code est écrit pour votre version d'Odoo, testé dans un bac à sable, puis poussé sur votre dépôt Git. Une question sur votre projet ? Écrivez-nous.

Les autres guides

Questions fréquentes

Faut-il une clé API pour Claude Code ?

Non. Claude Code gère OAuth : vous vous authentifiez par /mcp. La clé API Aidoo ne sert qu'aux clients sans OAuth, comme Cursor ou Windsurf.

Les modèles de mes modules personnalisés sont-ils visibles ?

Oui, dès qu'ils sont exposés dans Aidoo. L'introspection de votre base détecte les modèles et les champs ajoutés par vos modules.

Puis-je partager la configuration avec mon équipe ?

Oui, avec --scope project : le serveur est inscrit dans le fichier .mcp.json du dépôt. Chaque développeur s'authentifie ensuite avec son propre compte Aidoo.

Claude Code peut-il écrire dans Odoo ?

Seulement si vous cochez les droits d'écriture lors de l'autorisation, et dans la limite des droits de votre utilisateur Odoo.

Quelles versions d'Odoo sont compatibles ?

Odoo 16, 17, 18, 19 et 20, en Community comme en Enterprise, sur Odoo Online, Odoo.sh ou votre propre serveur.

Vous avez un projet Odoo ou souhaitez exploiter votre ERP avec l'IA ?

Intégrateur ou équipe technique, parlons de vos développements Odoo et de la place de l'IA dans votre façon de travailler.

ÉchangeonsVoir une démo