Tutoriel : Installer et configurer le MCP YourTextGuru pour Claude Desktop

Le Model Context Protocol (MCP) permet à votre assistant IA (Claude Desktop, etc.) d'utiliser directement les outils de YourTextGuru. En installant le MCP YourTextGuru, vous pouvez analyser et optimiser votre contenu SEO (guides QBST, scores SOSEO/DSEO, brief SEO, génération de contenu) sans quitter votre interface habituelle.

Prérequis

• Node.js (version ≥ 18)
• npm (installé avec Node.js)
• Une clé API YourTextGuru (obtenir une clé)
• 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/YourtextGuruMCP.git

2. Se déplacer dans le dossier du projet

   cd YourtextGuruMCP

3. Installer les dépendances

   npm install

4. Configurer la clé API YourTextGuru dans Claude Desktop

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

   {
     "mcpServers": {
       "yourtextguru": {
         "command": "node",
         "args": ["/absolute/path/to/ytgmcp/dist/index.js"],
         "env": {
           "YTG_API_KEY": "your_api_key_here"
         }
       }
     }
   }

   Remplacez your_api_key_here par votre clé API YourTextGuru.

   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 YourTextGuru

   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 :

  « Crée un guide SEO pour "recette de crêpes" en français (fr_FR) »

• Si vous obtenez une réponse avec un guide ID et des informations de création, tout fonctionne correctement.

Dépannage / erreurs fréquentes

Fonctionnalités principales et exemples d'utilisation

« Crée un guide SEO pour "meilleure recette tarte aux pommes" en français (fr_FR) »

« Analyse ce texte par rapport au guide 12345 : [votre texte] »
« Analyse l'URL https://example.com/article avec le guide 12345 »

« Montre-moi les questions PAA (People Also Ask) du guide 12345 »
« Quelles sont les recherches associées pour le guide 12345 ? »

« Génère un brief SEO pour le guide 12345 »
« Analyse mon texte par rapport au brief du guide 12345 : [texte] »

« Génère un plan de contenu optimisé pour le guide 12345 »
« Crée 20 questions FAQ pour le guide 12345 »
« Reformule ce texte en l'optimisant pour le guide 12345 : [texte] »

Pour plus d'informations, consultez le dépôt GitHub.