Connecter Odoo à Claude

Ce qu'il vous faut

• Odoo 15 et versions suivantes, sur Odoo.sh, auto-hébergé, ou sur Odoo Online avec un forfait qui inclut l'API externe.
• Un compte Speak To Your Database gratuit (20 prompts gratuits, sans carte bancaire).

Étapes

1. Créez une clé d'API Odoo. Dans Odoo, cliquez sur votre avatar, ouvrez votre profil, puis Sécurité du compte → Nouvelle clé API (activez le mode développeur si vous ne la voyez pas ; si Odoo demande une portée, choisissez RPC). Créez la clé avec l'utilisateur Odoo dont STYD doit lire les données. Un utilisateur dédié en lecture seule est idéal : tous les membres de votre espace voient ce que cet utilisateur voit. Copiez la clé tout de suite : Odoo ne l'affiche qu'une fois.
2. Ajoutez la clé dans Speak To Your Database. Connectez-vous à STYD et ouvrez Connecter Odoo. Saisissez l'adresse de votre Odoo et collez la clé. D'Odoo 15 à 18, STYD demande aussi l'identifiant Odoo et le nom de la base de données. Testez, puis enregistrez.
3. Ajoutez Speak To Your Database dans Claude. Ouvrez la fiche de STYD dans l'annuaire de Claude et ajoutez-le depuis cette page, ou ouvrez Paramètres → Connecteurs, choisissez Ajouter un connecteur personnalisé, donnez-lui un nom (par exemple « STYD ») et collez l'adresse https://speaktoyourdatabase.com/mcp. Choisissez ensuite Se connecter. Pas à pas : Utiliser STYD depuis Claude.
4. Connectez-vous et cliquez sur Autoriser. Une page Speak To Your Database s'ouvre : continuez avec Google, ou saisissez votre adresse e-mail et ouvrez le lien de connexion que STYD vous envoie. Utilisez la même adresse e-mail que pour votre compte STYD. STYD indique ce que Claude pourra faire : lire les données auxquelles vous avez déjà accès, en lecture seule. Vérifiez le compte, puis cliquez sur Autoriser.
5. Posez une première question. De retour dans Claude, dans une conversation où le connecteur STYD est activé, demandez par exemple « Quel a été notre chiffre d’affaires le mois dernier ? » ou « Quels clients ont des factures en retard, et combien nous doivent-ils ? ». Les réponses arrivent dans la langue de la question.

Si ça ne fonctionne pas

• Pas de « Nouvelle clé API » dans Odoo : activez le mode développeur. Sur Odoo 15 et 16, l'entrée du menu s'appelle Préférences. Si Odoo demande une portée, choisissez RPC.
• STYD ne joint pas votre Odoo : si votre serveur n'accepte que des adresses connues (un pare-feu ou Cloudflare), autorisez les adresses de STYD : 109.123.235.222 (IPv4) et 2407:3640:2324:5796::1 (IPv6). STYD ne peut pas joindre un serveur qui n'a qu'une adresse locale (localhost) ou de réseau privé : utilisez son adresse publique.
• Odoo Online refuse la connexion : si Odoo bloque l'accès externe sur votre forfait, STYD vous le dit clairement.
• Claude dit que rien n'est connecté : votre compte STYD n'a pas encore de données à lui. Connectez Odoo dans STYD (étape 2) et connectez-vous à Claude avec la même adresse e-mail.
• Connecté avec le mauvais compte : déconnectez-vous de STYD, connectez-vous avec le bon compte, puis relancez la connexion depuis Claude.

Toutes les étapes et la suite : Connecter vos données.

Questions fréquentes

Faut-il installer un module dans Odoo ?

Non. Speak To Your Database se connecte avec une clé d'API Odoo : il n'y a rien à installer dans Odoo.

Peut-il modifier mes données Odoo ?

Non. Il est en lecture seule : il ne peut rien créer, modifier ni supprimer dans Odoo, et il lit avec les droits de l'utilisateur Odoo de la clé d'API. Mots de passe, jetons, clés et numéros de carte ou de compte bancaire restent toujours masqués.

Combien ça coûte ?

Chaque réponse utilise un prompt de l'espace de travail interrogé. Un nouveau compte reçoit 20 prompts gratuits, sans carte bancaire. Lister les espaces et les connexions et décrire les données est gratuit. Voir les tarifs.

En quoi est-ce différent du serveur MCP intégré à Odoo ?

Le serveur MCP d'Odoo, à partir d'Odoo 20, transforme en outils les actions serveur choisies par un administrateur Odoo et peut lire et écrire. Speak To Your Database fonctionne en dehors d'Odoo, se contente de lire, fonctionne avec Odoo 15 et versions suivantes et répond aux questions métier en indiquant la définition, la période et les filtres. Comparer les serveurs MCP Odoo.

Puis-je connecter plusieurs sociétés ?

Oui. Chaque société reste dans son propre espace de travail Speak To Your Database. Claude peut interroger tous les espaces dont vous faites partie, et chaque réponse utilise un prompt de l'espace concerné.

Quelles versions d'Odoo sont prises en charge ?

Odoo 15 et versions suivantes, sur Odoo Online, Odoo.sh ou votre propre serveur. Sur Odoo Online, votre forfait doit inclure l'API externe : si Odoo la bloque, STYD vous le dit clairement.