Aller au contenu principal

Serveur MCP d'un staging

L'onglet MCP installe un serveur MCP (Model Context Protocol) dans l'instance Odoo d'un staging. Des outils d'IA peuvent alors interroger et manipuler vos données Odoo, avec des clés d'API dont les droits sont limités à ceux de l'utilisateur Odoo auquel elles sont liées. Un staging permet de tester ces usages sans toucher à la production.

Accès

Onglet MCP d'une branche de staging uniquement. Réservé aux Super Admins du projet : pour tout autre rôle, les actions sont refusées avec le message This service is reserved for the project's super admins.

Le gestionnaire MCP d'un staging
Le gestionnaire MCP d'un staging

L'en-tête MCP Connection Manager rappelle l'instance visée (Target Node), la base de données et l'état du serveur : Active (Staging Free) ou Inactive.

Activer le serveur MCP​

  1. Ouvrez le staging, puis l'onglet MCP. Tant que le serveur n'est pas installé, l'écran Deploy MCP Server Engine s'affiche.
  2. Cliquez sur Activate for Free. Le bouton affiche Installing Module... pendant l'installation du module mcp_server_odoo dans la base du staging.
  3. Le message MCP Server Engine deployed successfully confirme l'activation. Le serveur répond à l'adresse <adresse du staging>/mcp.
Odoo 20

Odoo 20 fournit son propre serveur MCP, qui utilise la même adresse /mcp. L'activation le désinstalle pour libérer cette adresse, et le message de confirmation le précise. Si un avertissement orange indique que les deux serveurs sont encore installés, relancez l'activation.

Les sous-onglets​

Sous-ongletContenu
GeneralL'adresse du serveur (MCP Server URL, avec Copy) et la désactivation du module.
API KeysLes clés d'API qui permettent aux outils d'IA de se connecter.
Audit LogsLe journal des appels reçus par le serveur, filtrable par outil, par état et par modèle Odoo (par exemple res.partner).
Bulk JobsLe suivi des traitements de masse asynchrones (exports, modifications, suppressions).
SettingsLes réglages du serveur : activation, limite de requêtes par minute (Global Rate Limiter (RPM)), taille maximale des données (Max Payload Buffer (KB)), durée de conservation du journal (Audit Processing Lifespan (Days), 0 pour conserver indéfiniment), enregistrement du contenu des appels et masquage des erreurs.

Créer une clé d'API​

  1. Dans API Keys, cliquez sur Create API Key.
  2. Renseignez :
    • Key Name : un nom qui identifie l'usage (par exemple l'outil qui l'utilisera) ;
    • Assign to User : l'utilisateur Odoo dont la clé reprend les droits ;
    • Expiration Date (Optional) : une date d'expiration ;
    • Key Status : active ou non.
  3. Cliquez sur Save Key.

Les droits d'une clé ne dépassent jamais ceux de l'utilisateur Odoo choisi. Pour afficher le jeton à copier dans votre outil d'IA, utilisez See Token sur la ligne de la clé.

Gérer une clé d'API​

Ouvrez une clé depuis la liste pour afficher sa page de détail (Manage: <nom de la clé>). Elle comporte trois onglets :

OngletCe que vous pouvez faire
API Key ConfigurationModifier le nom, l'utilisateur, l'expiration et l'état de la clé, puis Save Configurations. La zone Danger Zone permet de supprimer la clé (Delete API Key) : les outils qui l'utilisent cessent immédiatement de fonctionner.
Key Access ConfigurationDéfinir, modèle par modèle, les droits de la clé : lecture (Read), écriture (Write), création (Create) et suppression (Delete). Add Model Access ajoute un modèle ; Sync Permissions et Reset Permissions resynchronisent ou réinitialisent les droits.
Token ConfigurationGérer les jetons de la clé. Generate New Version crée un nouveau jeton, avec une période de transition pendant laquelle l'ancien reste valable (de 0 à 30 jours ; 7 jours recommandés). Un jeton peut aussi être révoqué immédiatement.
Renouveler un jeton sans coupure

Choisissez une période de transition de quelques jours lors de Generate New Version : vous avez ainsi le temps de mettre à jour vos outils avant que l'ancien jeton cesse de fonctionner.

Désactiver le serveur MCP​

Dans General, section Instance Teardown Control, cliquez sur Deactivate Module. Le module est désinstallé de la base du staging, avec sa configuration ; le message MCP Server Engine uninstalled successfully le confirme.

Voir aussi​