MCP Server for Odoo — AI assistant connector

Guide utilisateur — Serveur MCP pour Odoo (DYONYSOS)

Brancher Claude, ChatGPT, Cursor ou tout client Model Context Protocol sur votre Odoo, avec vos droits et un journal d'audit.

1. Activer le point de terminaison

Paramètres → Paramètres généraux → Serveur MCP :

Commencez écritures désactivées. Vous les ouvrirez quand la lecture vous aura convaincu.

2. Choisir ce qui est exposé — rien ne l'est par défaut

Paramètres → Technique → Modèles exposés au MCP → Nouveau.

Pour chaque modèle : cochez Lecture, Écriture, Création, Suppression séparément. Le domaine de restriction est optionnel et s'ajoute à vos règles Odoo : par exemple [('state', '=', 'sale')] sur les commandes pour ne jamais exposer les devis.

Commencez petit : res.partner en lecture seule suffit à valider le branchement.

Aucun modèle n'est exposé à l'installation, ni après une mise à jour. Un modèle absent de cette liste est invisible pour l'assistant, quels que soient les droits de l'utilisateur.

3. Créer une clé

Sur la fiche de l'utilisateur qui portera les appels, bouton Nouvelle clé MCP.

La clé s'affiche une seule fois : copiez-la immédiatement. Elle porte le scope odoo.mcp, peut recevoir une date d'expiration, et se révoque à tout moment. Seule une clé de ce scope ouvre /mcp : une clé API globale (RPC) est refusée (401), et un utilisateur sans le groupe MCP User est refusé (403) même avec une clé valide.

Le point /mcp est désactivé à l'installation (404) : allumez-le dans Paramètres → Généraux → MCP Server une fois les modèles choisis.

Mise à jour depuis la 1.0.0. Les anciennes clés API globales ne donnent plus accès à /mcp (401) et ne sont pas converties (elles ouvrent aussi XML-RPC) : chaque utilisateur MCP crée une nouvelle clé avec le bouton Nouvelle clé MCP. Les trois modèles exposés par défaut en 1.0.0 (contacts, utilisateurs, sociétés) sont archivés avec leurs réglages : réexaminez-les et réactivez ceux que vous voulez garder. Les champs one2many (lignes, contacts enfants…) ne s'écrivent pas par MCP : toute commande y crée, modifie ou supprime des enregistrements liés. Sur un many2many, seules les commandes de liaison (3, 4, 5, 6, 1 000 ids au plus) passent. Sur un modèle dont les champs exposés sont restreints, seules les méthodes listées explicitement dans sa configuration sont appelables.

Le point à comprendre : les appels s'exécutent avec les droits de cet utilisateur. Groupes, règles d'enregistrement, multi-société — tout s'applique. Créez donc un utilisateur dédié aux droits volontairement étroits plutôt que d'utiliser un compte administrateur.

4. Brancher le client

Pointez le client MCP sur https://votre-odoo/mcp, avec la clé en authentification.

Outils disponibles : odoo_list_models, odoo_model_fields, odoo_search, odoo_read, odoo_count, odoo_read_group, odoo_create, odoo_write, odoo_unlink, odoo_call_method (liste blanche de méthodes) et odoo_search_partners.

Le client découvre aussi le schéma de chaque modèle autorisé : il sait donc quels champs existent sans que vous ayez à le lui dire.

5. Relire le journal d'accès

Paramètres → Technique → Journal d'accès MCP.

Chaque appel : l'outil, le modèle, les enregistrements touchés, la durée, l'adresse IP, l'erreur éventuelle. C'est ce que vous relisez après la première journée pour voir ce que l'assistant a réellement fait — et ce qui justifie, ou non, d'ouvrir les écritures.

Ce que ce module ne fait pas

Il n'appelle aucun modèle de langage et ne consomme aucun crédit : c'est le client MCP qui porte l'IA et la facture. Il n'ouvre aucun accès anonyme. Et il n'élargit jamais les droits d'un utilisateur : il ne peut que les restreindre.