MCP Server

MCP Server RGAA 4.1 — Guide d'installation

Auditez l'accessibilité RGAA directement depuis votre IDE favori

Qu'est-ce que le MCP Server RGAAudit ?

Le MCP (Model Context Protocol) Server RGAAudit permet d'exécuter des audits d'accessibilité RGAA 4.1 directement depuis votre environnement de développement : Claude Code, Cursor, GitHub Copilot, ou tout client compatible MCP.

C'est le premier MCP RGAA au monde. En une seule commande, vous obtenez un audit complet conforme au référentiel français, avec les scores, les violations détaillées et les suggestions de correction.

Prérequis

Avant de configurer le MCP Server, vous devez disposer d'une clé API RGAAudit. Suivez ces étapes :

Créer un compte sur rgaaudit.fr/signup
Souscrire au plan Freelance ou supérieur depuis la page Tarifs — le plan Découverte (gratuit) ne permet pas d'utiliser l'API
Aller dans Paramètres > API
Cliquer sur Générer une clé API — la clé commence par le préfixe rga_
Copier et conserver la clé immédiatement — elle ne sera plus affichée après fermeture de la modale

Installation

Aucune installation permanente requise. Lancez le serveur MCP avec npx :

npx @rgaaudit/mcp-server

Le package sera téléchargé et exécuté automatiquement. Requiert Node.js 18+.

Configuration

Option 1 — Commande rapide (Claude Code)

claude mcp add rgaaudit -- npx -y @rgaaudit/mcp-server

Puis définissez la variable d'environnement dans votre shell :

export RGAA_API_KEY=rga_votre_cle_ici

Option 2 — Fichier de configuration

Ajoutez cette configuration dans votre fichier .claude/settings.json ou dans les paramètres globaux de Claude Code :

{
  "mcpServers": {
    "rgaaudit": {
      "command": "npx",
      "args": ["-y", "@rgaaudit/mcp-server"],
      "env": {
        "RGAA_API_KEY": "rga_votre_cle_ici"
      }
    }
  }
}

Pour Cursor ou Copilot, consultez la documentation de votre éditeur pour la configuration des serveurs MCP.

Outils disponibles

Outils d'audit — consomment le quota mensuel

Outil	Description	Paramètres
`rgaa_audit`	Audit complet RGAA 4.1 avec violations, patterns et suggestions. Option `authenticated` pour les pages protégées, `diagnostics` pour les liens cassés et erreurs, `seedUrls` pour cibler des pages spécifiques.	`url`, `authenticated`, `diagnostics`, `seedUrls`
`rgaa_score`	Score de conformité RGAA rapide pour une URL. Retourne le score (0-100%), le nombre de violations, et le niveau de conformité.	`url`
`rgaa_check`	Vérifier un critère RGAA spécifique sur une URL. Par exemple : critère 1.1 (images), 3.1 (couleurs), 8.1 (langue).	`url`, `criteria`
`rgaa_report`	Génère un rapport d'audit RGAA structuré en JSON pour intégration CI/CD (Continuous Integration / Continuous Deployment) ou export. Inclut les diagnostics par défaut (liens cassés, erreurs, zones partagées, corrections).	`url`, `threshold`
`rgaa_recheck`	Re-check rapide : re-scanne les mêmes pages d'un audit existant sans redécouvrir le site. Retourne le delta (score avant/après, violations résolues/nouvelles). Consomme 1 audit du quota.	`auditId`
`rgaa_diagnostics`	Diagnostics de santé du site : liens cassés (404), pages en erreur (Cloudflare, captcha, timeout), détail des zones partagées (header/nav/footer avec critères RGAA), et état des corrections.	`url`

Outils de correction — ne consomment pas de quota (sauf re-audit dans le plan de remédiation)

Outil	Description	Paramètres
`rgaa_fix`	Retourne le code correctif pour une violation RGAA. Fournit des exemples avant/après en HTML, Vue et React.	`ruleId`, `framework`
`rgaa_remediate`	Plan de remédiation autonome : audite, priorise les violations corrigeables, et retourne un plan d'action structuré avec le code correctif pour chaque violation.	`url`, `framework`, `targetScore`, `maxFixes`

Outils locaux — gratuits et illimités, aucun appel API

Outil	Description	Paramètres
`rgaa_explain`	Explique un critère RGAA 4.1 avec sa description, son niveau WCAG (Web Content Accessibility Guidelines), et des exemples de code.	`criteria`
`rgaa_visual_check`	Génère une checklist de vérification visuelle pour l'agent AI. Chaque étape indique quoi faire avec Browser MCP et quoi vérifier. Couvre les critères que axe-core ne peut pas détecter automatiquement.	`url`, `checks`

Exemples d'utilisation

Une fois le MCP configuré, demandez simplement en langage naturel :

Audit complet

"Audite l'accessibilité RGAA de https://monsite.fr"

Score rapide

"Quel est le score RGAA de vercel.com ?"

Explication d'un critère

"Explique-moi le critère RGAA 3.2"

Vérification ciblée

"Vérifie le critère 1.1 (images alternatives) sur ma page d'accueil"

Rapport exportable

"Génère un rapport RGAA complet de mon site en JSON"

Correction de code

"Corrige les violations de contraste sur mon composant Header.vue"

Re-audit après corrections

"Re-audite mon site pour vérifier les corrections"

Diagnostics du site

"Montre-moi les liens cassés et pages en erreur de https://monsite.fr"

Limites par plan

Plan Découverte (gratuit)

L'API et le MCP Server ne sont pas disponibles sur le plan Découverte. Utilisez l'interface web pour vos 3 audits mensuels gratuits. Pour accéder au MCP, souscrivez au plan Freelance ou supérieur.

Quotas mensuels par plan (API et MCP) :

Découverte (gratuit) — API non disponible (interface web uniquement : 3 audits / mois)
Freelance — 20 audits / mois
Agence — 100 audits / mois
Organisation — Illimité

Les outils rgaa_explain, rgaa_fix et rgaa_visual_check sont gratuits et illimités pour tous les plans : ils fonctionnent en local sans appel API.

Chaque appel à un outil d'audit (MCP, API REST ou interface web) décompte 1 audit de votre quota. Consultez votre consommation depuis Paramètres > Abonnement.

Package npm

Le serveur MCP RGAAudit est distribué via npm sous le nom @rgaaudit/mcp-server. Aucune installation permanente n'est requise :

npx @rgaaudit/mcp-server

Le package est téléchargé et exécuté automatiquement. Requiert Node.js 18+ et une clé API valide (plan Freelance ou supérieur).