Quand utiliser ce guide ?

Certains clients MCP, principalement les IDEs, ne supportent pas l'authentification OAuth pour les connecteurs distants. Ils nécessitent une clé API Aidoo transmise via en-tête Authorization :

Cursor, Windsurf et autres IDEs compatibles MCP
Tout client MCP qui ne propose pas le flux OAuth

Pour Claude.ai, ChatGPT, Claude Desktop et Claude Code, utilisez plutôt le guide Se connecter avec Claude (OAuth, sans clé API).

Pré-requis

Un compte Aidoo actif avec une connexion Odoo configurée
Une clé API Aidoo (préfixée aid_live_). Suivez le guide Clés API pour en générer une.

Le serveur MCP est hébergé par Aidoo sur https://mcp.aidoo.fr. Aucune installation locale n'est requise.

Cursor

Ajoutez le serveur MCP dans le fichier ~/.cursor/mcp.json :

{
  "mcpServers": {
    "aidoo": {
      "url": "https://mcp.aidoo.fr/sse",
      "headers": {
        "Authorization": "Bearer aid_live_votre_cle_ici"
      }
    }
  }
}

Rechargez la fenêtre de l'IDE (Cmd/Ctrl+Shift+P → Reload Window) pour activer le connecteur.

Windsurf

Ajoutez le serveur MCP dans le fichier ~/.codeium/windsurf/mcp_config.json :

{
  "mcpServers": {
    "aidoo": {
      "url": "https://mcp.aidoo.fr/sse",
      "headers": {
        "Authorization": "Bearer aid_live_votre_cle_ici"
      }
    }
  }
}

Rechargez la fenêtre de Windsurf pour activer le connecteur.

Autres clients MCP

Pour tout autre IDE ou client compatible MCP, consultez sa documentation pour l'emplacement du fichier de configuration. Le bloc à ajouter reste le même : URL https://mcp.aidoo.fr/sse, transport SSE, en-tête Authorization: Bearer aid_live_….

Tester la connexion

Posez une question dans votre client :

Quels sont mes 5 derniers bons de commande sur Odoo ?

Vous devriez voir l'assistant proposer un appel à un outil aidoo_*. Approuvez-le pour exécuter la requête.

Sécurité

Ne partagez jamais votre clé API publiquement (dépôt Git, capture d'écran, etc.)
Une clé par utilisateur : ne mutualisez pas les clés au sein d'une équipe
En cas de doute, révoquez la clé depuis le tableau de bord Aidoo et générez-en une nouvelle
Limitez les permissions de chaque clé au strict nécessaire (voir Clés API)

Résolution des problèmes

L'icône MCP n'apparaît pas dans l'IDE

Vérifiez que le fichier mcp.json est un JSON valide (un outil comme jq ou un linter en ligne peut aider)
Rechargez complètement la fenêtre de l'IDE (Reload Window), un simple redémarrage du terminal ne suffit pas
Consultez les logs de l'IDE : Cursor (Output → MCP), Windsurf (View → Output → MCP)

Erreur 401 / « Unauthorized »

Vérifiez que votre clé API commence bien par aid_live_
Assurez-vous que la clé n'a pas été révoquée dans le tableau de bord
Vérifiez que la permission MCP correspondante est bien activée sur la clé

Le serveur MCP est inaccessible

Testez https://mcp.aidoo.fr/health depuis votre navigateur — vous devriez voir {"status":"ok"}
Vérifiez votre pare-feu / VPN d'entreprise (HTTPS sortant sur le port 443)