SagBot
Analyser

Analysez votre site et corrigez-le sans quitter votre éditeur

Le serveur MCP de SagBot permet à votre outil de code IA d’analyser un site en ligne, de lire chaque vérification échouée avec sa correction et de relancer l’analyse après le déploiement.

Fonctionne avec Claude Code, Cursor, OpenAI Codex CLI, Gemini CLI, VS Code (mode agent de Copilot) et Windsurf.

Commencer

Comment ça marche

  1. Connecter

    Créez un jeton et ajoutez le serveur à votre outil. Une commande ou une entrée de configuration.

  2. Demander une analyse

    Demandez à votre agent d’analyser votre site. Il reçoit les scores et une correction à copier-coller pour chaque vérification échouée.

  3. Corriger, déployer, ré-analyser

    Votre agent modifie le code, vous relisez et déployez, puis il relance l’analyse pour vérifier que le score a progressé.

Commencer

Créez un compte gratuit, générez un jeton et collez-le dans votre outil. Comptez environ deux minutes.

Configurer votre outil

Choisissez votre outil. Les extraits affichent un jeton factice tant que vous n’en avez pas créé.

Claude Code

Lancez ceci dans un terminal. SagBot est ajouté pour tous vos projets :

claude mcp add --transport http --scope user sagbot https://mcp.sagbot.app/mcp --header "Authorization: Bearer sgb_…"
Ne l’ajoutez pas avec --scope project : cela écrit le jeton dans .mcp.json, qui est souvent commité. La commande reste aussi dans l’historique du shell : effacez-la, ou commencez la ligne par une espace (bash HISTCONTROL=ignorespace, zsh setopt HIST_IGNORE_SPACE).

Vérifiez : claude mcp list doit afficher sagbot ✔ Connected. Dans Claude Code, /mcp l’affiche aussi.

Cursor

Ajoutez ceci à ~/.cursor/mcp.json (tous les projets). Si le fichier contient déjà mcpServers, placez sagbot dedans :

{
  "mcpServers": {
    "sagbot": {
      "url": "https://mcp.sagbot.app/mcp",
      "headers": {
        "Authorization": "Bearer sgb_…"
      }
    }
  }
}
Gardez-le dans le fichier de votre dossier personnel. Un .cursor/mcp.json de projet contenant le jeton doit aller dans .gitignore.

Vérifiez : sagbot apparaît, activé, dans les réglages MCP de Cursor. S’il ne se connecte pas, Output → MCP Logs indique pourquoi.

OpenAI Codex CLI

Ajoutez ceci à ~/.codex/config.toml :

[mcp_servers.sagbot]
url = "https://mcp.sagbot.app/mcp"
bearer_token_env_var = "SAGBOT_TOKEN"

Codex lit le jeton dans la variable d’environnement SAGBOT_TOKEN. Mettez cette ligne dans un fichier hors de tout dépôt, comme ~/.config/sagbot.env (chmod 600), ajoutez source ~/.config/sagbot.env à votre profil shell et ouvrez un nouveau terminal :

export SAGBOT_TOKEN="sgb_…"
Le jeton n’est pas dans config.toml. Gardez la ligne export hors de tout ce que vous commitez : dépôt de dotfiles, .envrc ou .env de projet.

Vérifiez : codex mcp list liste sagbot. Dans Codex, /mcp affiche ses outils.

Gemini CLI

Ajoutez ceci à ~/.gemini/settings.json. Si le fichier contient déjà mcpServers, placez sagbot dedans :

{
  "mcpServers": {
    "sagbot": {
      "httpUrl": "https://mcp.sagbot.app/mcp",
      "headers": {
        "Authorization": "Bearer sgb_…"
      }
    }
  }
}
Utilisez le fichier de votre dossier personnel, pas le .gemini/settings.json d’un projet, qui pourrait être commité.

Vérifiez : gemini mcp list affiche sagbot comme Connected. Dans Gemini CLI, /mcp liste ses outils.

VS Code (Copilot agent mode)

Ajoutez ceci à .vscode/mcp.json dans votre projet, ou à votre mcp.json utilisateur (palette de commandes → MCP: Open User Configuration) :

{
  "inputs": [
    {
      "type": "promptString",
      "id": "sagbot-token",
      "description": "SagBot token",
      "password": true
    }
  ],
  "servers": {
    "sagbot": {
      "type": "http",
      "url": "https://mcp.sagbot.app/mcp",
      "headers": {
        "Authorization": "Bearer ${input:sagbot-token}"
      }
    }
  }
}

Le fichier ne contient pas le jeton : VS Code le demande au premier démarrage du serveur et le stocke de façon sécurisée. Collez ceci quand il le demande :

sgb_…
Vous pouvez commiter le fichier : il ne contient aucun jeton.

Vérifiez : palette de commandes → MCP: List Servers affiche sagbot en cours d’exécution. Dans le chat, le mode agent liste ses outils.

Windsurf

Ajoutez ceci à ~/.config/devin/mcp_config.json (anciennes versions de Windsurf : ~/.codeium/windsurf/mcp_config.json). Pour ouvrir à coup sûr le bon fichier, passez par le menu MCP de Cascade → Open MCP config file. Si le fichier contient déjà mcpServers, placez sagbot dedans :

{
  "mcpServers": {
    "sagbot": {
      "serverUrl": "https://mcp.sagbot.app/mcp",
      "headers": {
        "Authorization": "Bearer sgb_…"
      }
    }
  }
}
Le fichier est dans votre dossier personnel, hors de vos projets. Ne le copiez pas dans un dépôt.

Vérifiez : après l’enregistrement, cliquez sur actualiser dans les réglages MCP de Cascade. sagbot apparaît avec 2 outils.

Les connecteurs de Claude Desktop, claude.ai et ChatGPT ne sont pas encore pris en charge : ils demandent une connexion dans le navigateur (OAuth), que SagBot ne propose pas encore.

Deux outils

scan_site

Analyse un site en ligne et renvoie les scores Agent-ready et Answer-ready, ainsi que chaque vérification échouée ou partielle avec des instructions de correction écrites pour un agent de code.

  • domain: le site à analyser, par exemple example.com.
  • siteType: content (par défaut), app ou shop.
  • rescan: true lance une nouvelle analyse au lieu de réutiliser un résultat de moins d’une heure.

get_latest_scan

Lit la dernière analyse enregistrée d’un site sans analyser et sans entamer votre limite. Utilisez-le pour relire les corrections, ou quand un appel à scan_site a expiré : l’analyse se termine quand même.

  • domain, siteType: comme pour scan_site.

Prompts à essayer

Collez-en un dans votre agent une fois connecté.

  • Analyse example.com avec SagBot et corrige dans ce dépôt ce que tu peux.
  • Je viens de déployer. Relance l’analyse de example.com avec SagBot et dis-moi ce qui échoue encore.
  • Que dit SagBot du llms.txt de example.com ?

Limites

  • 3 analyses par minute et par compte, quel que soit le nombre de jetons.
  • Un site peut être ré-analysé une fois toutes les 2 minutes.
  • URL publiques uniquement. SagBot récupère votre site depuis internet : déployez d’abord ou utilisez une URL de prévisualisation publique.
  • Les résultats sont publics, comme pour toute analyse SagBot : toute personne connaissant le domaine peut ouvrir sa page de résultats.

Questions

Le serveur MCP est-il gratuit ?

Oui. Il faut un compte SagBot gratuit pour créer un jeton. Il n’y a pas de plafond quotidien, seulement la limite de 3 analyses par minute.

Quels outils d’IA fonctionnent ?

Claude Code, Cursor, OpenAI Codex CLI, Gemini CLI, VS Code avec le mode agent de Copilot et Windsurf. Un client capable d’envoyer un en-tête Authorization à un serveur MCP distant peut aussi se connecter, mais nous documentons ces six-là.

Pourquoi pas Claude Desktop, claude.ai ou ChatGPT ?

Leurs connecteurs se connectent par le navigateur avec OAuth, que SagBot ne propose pas encore. Les jetons fonctionnent dans les outils où vous définissez vous-même l’en-tête.

Mon jeton est-il en sécurité ?

SagBot affiche le jeton une seule fois et ne peut plus le réafficher. Gardez-le hors de git : utilisez la configuration de votre utilisateur, pas un fichier du dépôt. Quiconque détient le jeton peut lancer des analyses en votre nom.

Comment révoquer un jeton ?

Ouvrez Compte, puis Identifiants, et supprimez le jeton. L’outil qui l’utilisait perd l’accès.

Peut-il analyser localhost ?

Non. SagBot récupère votre site depuis internet, il faut donc une URL publique. Déployez d’abord ou utilisez une URL de prévisualisation publique.

SagBot modifie-t-il mon code ?

Non. SagBot analyse et rapporte seulement. Votre agent modifie le code d’après les corrections, et vous relisez et déployez.

Les analyses MCP apparaissent-elles dans mon tableau de bord ?

Oui. Elles apparaissent dans votre Tableau de bord, marquées comme lancées via MCP.