Tutoriel : Installer et configurer le MCP Babbar pour Claude Desktop

Tutoriel : Installer et configurer le MCP Babbar pour Claude Desktop

Tutoriel : Installer et configurer le MCP Babbar pour Claude Desktop

Le Model Context Protocol (MCP) permet à votre assistant IA (Claude Desktop, etc.) d’utiliser directement les outils de l’écosystème Babbar. En installant le MCP Babbar, vous pouvez poser des questions en langage naturel et récupérer des analyses SEO (profil de liens, duplication, voisinage sémantique, etc.) sans quitter votre interface habituelle.

Prérequis

  • Node.js (version ≥ 18)
  • npm (installé avec Node.js)
  • Une clé API Babbar (depuis votre compte Babbar)
  • Claude Desktop installé (version payante ou gratuite ; la version gratuite a des limites d'usage plus fortes. Téléchargement)
  • Accès au fichier claude_desktop_config.json selon votre OS : 
    • sur PC, généralement : C:\Users\{username}\AppData\Roaming\Claude\claude_desktop_config.json  (accessible via %APPDATA%\Claude\)
    • sur mac, généralement : ~/Library/Application Support/Claude/claude_desktop_config.json )
    • ou directement depuis l'app Claude Desktop : Paramètres >Développeur > Modifier la config)

Étapes d’installation et de configuration

  1. Cloner le dépôt GitHub

    git clone https://github.com/BabbarTech/BabbarMCP.git
  2. Se déplacer dans le dossier du projet

    cd BabbarMCP
  3. Installer les dépendances

    npm install
  4. Configurer la clé API Babbar dans Claude Desktop

    Ouvrez (ou créez) le fichier claude_desktop_config.json et ajoutez le bloc suivant :

    {
      "mcpServers": {
        "babbar": {
          "command": "node",
          "args": ["/absolute/path/to/babbar-mcp/dist/index.js"],
          "env": {
            "BABBAR_API_KEY": "your_api_key_here",
            "LOG_LEVEL": "info"
          }
        }
      }
    }

    🔧 Remplacez your_api_key_here par votre clé API Babbar.
    Vérifiez que le chemin vers dist/index.js est correct selon l’endroit où vous avez cloné le projet.

  5. Compiler le projet (TypeScript → JavaScript)

    npm run build
  6. Lancer le serveur MCP Babbar

    node dist/index.js

    Si tout est correct, le serveur doit afficher qu’il est en écoute et prêt à recevoir les requêtes de Claude.

Vérification & test

Redémarrez Claude Desktop pour que la nouvelle configuration soit prise en compte (minimiser ne suffit pas).
Envoyez une requête simple au MCP, par exemple :

« Analyse les métriques SEO de whisky.glass »

Si vous obtenez une réponse structurée, tout fonctionne correctement

Dépannage / erreurs fréquentes

ErreurSignificationSolution recommandée
401 UnauthorizedClé API invalide ou manquanteVérifiez que la clé est bien copiée et active
429 Too Many RequestsQuota d’API dépasséAttendez la réinitialisation ou contactez le support Babbar
spawn … ENOENTProblème d’installation Node / cheminVérifiez que Node est installé et que le chemin vers le script est correct
400 / 404Paramètres incorrectsConsultez les logs générés par le serveur MCP

Vous êtes maintenant prêt à utiliser le MCP Babbar dans Claude Desktop !