Qu'est-ce que le protocole MCP ?

Le Model Context Protocol (MCP) est un standard ouvert qui permet aux assistants IA comme Claude ou ChatGPT d'interagir avec des outils externes. Aidoo expose vos données et actions Odoo via MCP, directement dans la conversation.

Pré-requis

Avant de commencer, assurez-vous d'avoir :

Un compte Aidoo actif (essai gratuit de 14 jours disponible)
Une connexion Odoo configurée dans votre tableau de bord Aidoo

Aucune clé API à générer ni à copier. L'authentification se fait via OAuth 2.1 : vous vous connectez à Aidoo depuis Claude, puis vous autorisez l'accès en un clic.

Connecter Claude.ai

Dans Claude.ai, ouvrez Paramètres → Connecteurs → Ajouter un connecteur personnalisé
Remplissez :

Champ	Valeur
Nom	`Aidoo`
URL du MCP	`https://mcp.aidoo.ai/mcp`

Cliquez sur Connecter
Vous êtes redirigé vers la page de connexion Aidoo
Connectez-vous (si la double authentification est activée sur votre compte, saisissez le code de votre application), puis sélectionnez l'espace de travail à autoriser et cochez les droits du connecteur
Cliquez sur Autoriser : vous revenez sur Claude.ai, le connecteur est actif

Par défaut, seules les permissions de lecture sont cochées. Le détail des droits est dans Démarrage rapide.

Le connecteur est utilisable immédiatement, dans n'importe quelle conversation. Aucun redémarrage requis.

Ajouter le connecteur Aidoo dans Claude.ai et autoriser l'accès.

Éviter d'approuver chaque appel

Par défaut, Claude vous soumet chaque appel d'outil. Sur des consultations répétées, cela devient vite pesant.

Dans Paramètres → Connecteurs, Claude range les outils Aidoo en deux groupes, lecture seule et écriture ou suppression. Chaque groupe se règle d'un bloc sur Toujours autoriser, et vous pouvez aussi trancher outil par outil.

Réglages des connecteurs dans Claude : les outils Aidoo groupés en lecture seule et en écriture ou suppression, chaque groupe réglable sur Toujours autoriser. — Les autorisations d'outils dans Claude, groupe par groupe ou outil par outil.

Le bon réglage : lecture automatique, écriture surveillée

Les outils de lecture ne peuvent rien modifier : les autoriser d'office ne coûte rien. Le groupe écriture et suppression, lui, contient la création, la modification et la suppression d'enregistrements. Y mettre « Toujours autoriser » supprime le dernier moment où vous voyez les valeurs avant qu'elles n'atteignent votre Odoo.

Connecter plusieurs sociétés en même temps

Claude n'autorise qu'une seule URL par connecteur. Pour utiliser plusieurs connecteurs Aidoo simultanément dans la même conversation (une société par connecteur), ajoutez un connecteur pour chacune des URLs suivantes. Elles pointent toutes vers le même service Aidoo et fonctionnent à l'identique :

Connecteur	URL du MCP
Aidoo (1)	`https://mcp.aidoo.ai/mcp`
Aidoo (2)	`https://mcp.aidoo.ai/mcp-2`
Aidoo (3)	`https://mcp.aidoo.ai/mcp-3`
Aidoo (4)	`https://mcp.aidoo.ai/mcp-4`
Aidoo (5)	`https://mcp.aidoo.ai/mcp-5`

Pour chaque connecteur :

Donnez-lui un nom explicite (ex. Aidoo Société A, Aidoo Société B) pour les distinguer dans Claude
Renseignez l'une des URLs ci-dessus
Suivez le même flux OAuth : connexion Aidoo puis choix de l'espace de travail à autoriser

Chaque connecteur mène sa propre autorisation et reste lié à l'espace de travail que vous choisissez. Vous pouvez ainsi interroger plusieurs Odoo dans une même conversation.

Astuce : l'URL n'a aucune incidence sur les données. C'est l'espace de travail sélectionné lors de l'autorisation qui détermine à quel Odoo le connecteur accède. Utilisez simplement une URL différente par connecteur pour contourner la limite de Claude.

Vous utilisez ChatGPT ? La procédure a sa propre page : Se connecter avec ChatGPT.

Tester la connexion

Posez une question simple pour vérifier que tout fonctionne :

Quels sont mes 5 derniers bons de commande sur Odoo ?

Claude va :

Identifier qu'il doit utiliser les outils Aidoo
Vous demander d'approuver l'appel à l'outil
Interroger votre Odoo via Aidoo
Vous afficher les résultats

Exemples de prompts

Quelques exemples concrets pour découvrir les capacités du connecteur :

Quels sont mes 5 derniers bons de commande sur Odoo ?

Quel est mon chiffre d'affaires facturé par mois sur les 6 derniers mois ?

Crée un contact « Test Aidoo » avec l'email [email protected]

Génère le PDF de la facture INV/2026/00042

Confirme le devis S00021

Par défaut, Claude vous soumet chaque appel d'outil avant de l'exécuter, écritures comprises. Ce contrôle est réglable dans Claude : gardez-le actif sur les outils d'écriture.

Résolution des problèmes

Le connecteur n'apparaît pas dans les outils disponibles

Rafraîchissez la conversation ou ouvrez-en une nouvelle
Vérifiez dans Paramètres → Connecteurs que le statut est bien Connecté
Si le statut est À reconnecter, cliquez sur le connecteur puis Reconnecter

Erreur « Couldn't reach the MCP server »

Vérifiez que https://mcp.aidoo.ai/health est accessible depuis votre réseau
L'URL du connecteur est https://mcp.aidoo.ai/mcp

La redirection OAuth échoue

Désactivez temporairement les bloqueurs de pop-up et extensions de tracking
Assurez-vous d'être connecté à votre compte Aidoo dans le même navigateur
Vérifiez que votre abonnement Aidoo est actif (le bandeau d'essai expiré bloque OAuth)

Erreur de connexion à Odoo

Vérifiez que votre connexion Odoo est bien configurée dans le tableau de bord Aidoo
Testez la connexion depuis Aidoo → Connexion Odoo → Tester la connexion
Assurez-vous que les identifiants Odoo sont toujours valides
Vérifiez que votre propre token Odoo est configuré dans Équipe : sans lui, vos requêtes ne peuvent pas partir

Besoin d'aide ?

Si un problème persiste, contactez-nous via la page contact : nous répondons sous 24 h ouvrées.