MCP Yourtext Guru : le guide d'installation

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

ErreurSignificationSolution recommandée
401 UnauthorizedClé API invalide ou manquanteVérifiez que la clé est bien copiée depuis votre compte YourTextGuru
429 Too Many RequestsQuota d'API dépasséAttendez la réinitialisation ou vérifiez votre plan YourTextGuru
spawn … ENOENTProblème d'installation Node / cheminVérifiez que Node.js est installé et que le chemin vers le script est correct
400 / 404Paramètres incorrects ou ressource non trouvéeConsultez les logs générés par le serveur MCP ou vérifiez les ID de guide

Fonctionnalités principales et exemples d'utilisation

Gestion des guides SEO

Fonctions : ytg_create_guide, ytg_list_guides, ytg_get_guide, ytg_delete_guide

Exemple de prompt :

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

Analyse de contenu

Fonctions : ytg_check_text, ytg_check_url

Exemple de prompt :

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

Retourne les scores SOSEO (optimisation) et DSEO (sur-optimisation) avec les zones d'amélioration.

Recherche SERP

Fonctions : ytg_get_serp, ytg_get_paa, ytg_get_related

Exemple de prompt :

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

Brief SEO

Fonctions : ytg_create_brief, ytg_get_brief, ytg_analyze_brief

Exemple de prompt :

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

Génération de contenu (SEO TXL)

Fonctions : ytg_seotxl_auto, ytg_seotxl_outline, ytg_seotxl_questions, ytg_seotxl_rephrase

Exemples de prompts :

« 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] »

⚠️ Nécessite une clé API OpenAI configurée dans votre compte YourTextGuru.

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

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