Guide Utilisateur – Serveur MCP Thot

Ce guide explique comment utiliser le serveur MCP (Model Context Protocol) Thot. Il vous permet d’intégrer de puissants outils SEO directement dans vos clients LLM préférés comme Claude Desktop ou Gemini CLI.

Fonctionnalités

Le serveur MCP Thot fournit une suite d’outils pour les professionnels du SEO et les créateurs de contenu :

1. Analyse de la SERP : Déclenche un crawl et une analyse en temps réel des résultats de recherche Google pour n’importe quel mot-clé.
2. Récupération de données SEO : Accède aux données sémantiques approfondies, incluant les intentions de recherche, les mots-clés sémantiques (N-grams), la structure des concurrents et les questions « People Also Ask ».
3. Scoring de contenu : Évaluez instantanément vos brouillons par rapport aux exigences SEO pour voir votre score d’optimisation et les mots-clés manquants.
4. Web Scraping : Extrayez le contenu propre et la structure (H1-H6) de n’importe quelle URL.
5. Gestion de l’historique : Parcourez vos analyses SEO précédentes pour réutiliser les données.
6. Suggestions de maillage interne : Obtenez des suggestions intelligentes de liens internes au sein de votre domaine.

Configuration (Clé API)

Le serveur nécessite une clé API Thot pour fonctionner.

• Nom de la variable : THOT_API_KEY

Vous pouvez fournir cette clé de deux manières :

1. Variable d’environnement (Recommandé pour l’usage local).
2. Paramètre d’URL (Recommandé pour l’usage distant).

---

Utilisation distante (Cloud)

Vous pouvez utiliser la version managée du serveur MCP Thot sans rien installer.

URL Distante : https://api.thot-seo.fr/mcp

Configuration pour Claude Code CLI

Taper claude mcp add --transport http thot https://api.thot-seo.fr/mcp?apikey=votreClef dans votre terminal.
Utiliser ensuite /mcp dans Claude Code pour vérifier l’installation et les tools disponibles. Vous pouvez ensuite demander directement à Claude d’extraire vos analyses, etc.

Configuration pour Claude Desktop

Accédez aux paramètres Admin > Connectors.

Cliquez sur « Add custom connector » en bas de la section.

Ajoutez l’URL de notre serveur MCP distant : https://api.thot-seo.fr/mcp?apikey=VOTRE_CLE.

Terminez la configuration de votre connecteur en cliquant sur « Add ».

Configuration pour Gemini CLI

Ajoutez ce qui suit à votre .gemini/settings.json :

{
  "mcpServers": {
    "thot-seo-remote": {
      "url": "https://api.thot-seo.fr/mcp?apikey=VOTRE_CLE"
    }
  }
}

Exemples de prompts

Une fois configuré, vous pouvez poser des questions à votre assistant IA comme :

• « Analyse le mot-clé ‘meilleures chaussures de trail’ et donne-moi les principales intentions de recherche. »
• « Je rédige un article sur l’automatisation du SEO. Peux-tu récupérer les mots-clés obligatoires de ma dernière analyse pour cette requête ? »
• « Voici mon brouillon [texte]. Score-le par rapport à l’analyse ID 12345 et dis-moi quels mots-clés j’ai manqués. »
• « Extrait la structure des titres (H1-H4) de https://exemple.com/article-de-blog. »
• « Liste mes analyses SEO récentes pour que je puisse trouver celle sur le ‘marketing digital’. »