Residual Audit MCP Server
Connectez Residual Audit à Claude, Cursor ou tout AI compatible MCP. Lancez des audits web en une phrase, récupérez des rapports structurés directement dans votre conversation IA.
Qu'est-ce que le MCP ?
Le Model Context Protocol (MCP) est un standard ouvert qui permet aux modèles de langage d'appeler des outils externes via JSON-RPC sur stdin/stdout. Le serveur MCP Residual Audit expose 3 tools que votre IA peut appeler nativement — sans code, sans intégration REST manuelle.
1. Installation
Téléchargez le serveur MCP
# Option 1 — Téléchargez uniquement le fichier serveur curl -O https://raw.githubusercontent.com/zyx77550/residual-labs-v2/main/mcp/server.js # Option 2 — Clonez le repo complet git clone https://github.com/zyx77550/residual-labs-v2.git
Récupérez votre clé API
Dans votre dashboard Residual Audit → Paramètres → API → copiez votre clé API. Elle sera passée en variable d'environnement AUDIT_API_KEY.
2. Configuration
Claude Code (recommandé)
Ajoutez dans ~/.claude/mcp.json :
{
"mcpServers": {
"audit": {
"command": "node",
"args": ["/chemin/vers/mcp/server.js"],
"env": {
"AUDIT_API_KEY": "votre_clé_api"
}
}
}
}Claude Desktop
Même configuration dans claude_desktop_config.json.
Cursor
Preferences → MCP → Add Server → stdio → node /chemin/vers/mcp/server.js avec AUDIT_API_KEY en variable d'env.
3. Référence des outils
audit_run10–20 créditsLance un audit sur une URL. Retourne un auditId à poller avec audit_get.
urlURL complète à auditer. Requis.
modefast (défaut) = 30s / 10 crédits · deep = 90s / 20 crédits
webhookUrlURL HTTPS optionnelle appelée quand l'audit termine.
audit_getGratuitRécupère statut et résultats complets. Pollez toutes les 5s jusqu'à status: "completed".
auditIdUUID retourné par audit_run. Requis.
Réponse (completed)
{
"status": "completed",
"score": 67,
"score_breakdown": { "security": 72, "seo": 58, "performance": 65, "branding": 73 },
"techStack": ["WordPress", "PHP 8.1", "Cloudflare"],
"ssl": { "grade": "A", "expiryDays": 234, "valid": true },
"pagespeed": { "desktop": 78, "mobile": 42 },
"contact": { "emailFound": true, "email": "contact@example.com" },
"shareUrl": "https://audit.residual-labs.fr/report/abc123"
}audit_creditsGratuitVérifie le solde de crédits et les détails du plan actuel. Retourne credits, plan, auditsRemaining.
4. Exemple d'utilisation
Une fois configuré, vous pouvez simplement écrire à Claude :
Vous
Lance un audit rapide sur https://dupont-plomberie.fr et dis-moi ce qui ne va pas.
Claude (via audit_run + audit_get)
Score global : 42/100. Points critiques : SSL expiré dans 8 jours (grade C), score mobile PageSpeed à 18/100, WordPress 5.9 non mis à jour (6 CVE connues), aucune balise meta description. Rapport complet → audit.residual-labs.fr/report/...
Rate limits & Crédits
Par défaut
- • 10 POST
/api/v1/audit/min - • 30 GET
/api/v1/audit/:id/min - • 30 requêtes /min par IP
Compte intégration
- • 60 POST /min
- • 200 GET /min
- • Contactez-nous pour activer
is_integration