Accessia
Sommaire de l'aide

Accessia dans votre éditeur de code (serveur MCP)

Le serveur MCP d'Accessia branche l'audit d'accessibilité dans votre assistant de code : il audite la page sur laquelle vous travaillez, lit le critère du RGAA en cause, puis re-teste chaque correctif avec le moteur d'Accessia avant que l'assistant ne l'applique.

Mis à jour le

Installer et relier votre compte

Il faut Node.js 18 ou plus récent, et un compte Accessia (gratuit).

  1. Dans un terminal, reliez ce poste à votre compte : npx accessia-mcp connexion
  2. Votre navigateur ouvre Accessia (connectez-vous si besoin). Vérifiez que la page affiche le même code que le terminal, puis cliquez sur « Autoriser ».
  3. Le terminal confirme « Relié au compte » : la clé du poste est enregistrée dans votre dossier personnel, jamais votre mot de passe.

Ajoutez ensuite le serveur à votre éditeur :

Claude Code

claude mcp add accessia -- npx -y accessia-mcp

Cursor

Dans ~/.cursor/mcp.json (ou .cursor/mcp.json à la racine du projet) :

{
  "mcpServers": {
    "accessia": { "command": "npx", "args": ["-y", "accessia-mcp"] }
  }
}

VS Code

Dans .vscode/mcp.json :

{
  "servers": {
    "accessia": { "type": "stdio", "command": "npx", "args": ["-y", "accessia-mcp"] }
  }
}

Vous pouvez aussi demander directement à l'assistant de « relier Accessia » : l'outil « connexion » affiche le lien et le code. Le paquet est publié sur npm (nouvelle fenêtre).

Ce que l'assistant peut faire

  • auditer_page : audite une page publique, ou une page locale (localhost, réseau privé, fichier .html) dont le code est lu sur votre poste. Il renvoie les non-conformités par gravité, avec le code fautif, la correction proposée par Accessia et le lien du rapport.
  • auditer_html : audite un fragment de HTML, par exemple le rendu d'un composant.
  • lire_critere : le critère du RGAA 4.1.2 et ses tests officiels, avec qui est gêné, les erreurs fréquentes et la méthode de test de nos fiches critères.
  • retester_correctif : avant d'appliquer un correctif, le moteur d'Accessia analyse le code d'origine et le code corrigé. Résultat : vérifié, insuffisant, régression (un autre défaut apparaît) ou non vérifiable ici.
  • problemes_rapport : relit les problèmes d'un rapport existant, audité dans l'application, l'extension ou l'éditeur.

Exemple de demande

« Audite http://localhost:3000/contact avec Accessia et corrige les étiquettes de champs, en re-testant chaque correctif. » L'assistant lance l'audit, lit le critère RGAA 11.1, écrit le correctif dans votre code, le fait vérifier par retester_correctif, puis relance l'audit pour constater le résultat.

Limites, en toute franchise

  • Un audit automatique ne couvre qu'une partie du RGAA : le taux renvoyé est provisoire, et l'assistant ne doit jamais conclure qu'une page est conforme.
  • Sur du code seul (page locale, fragment), le contraste réel, le focus visible et l'affichage à 320 px ne sont pas mesurés.
  • Le re-test juge du HTML : un composant JSX ou Vue est « non vérifiable ici » ; le prochain audit de la page rendue le vérifiera.

Déconnecter un poste

npx accessia-mcp deconnexion révoque la clé du poste. Vous pouvez aussi la désactiver dans « Mon compte » → Profil et outils, où elle apparaît comme « Serveur MCP (éditeur de code) ».

Pour exploiter un rapport ouvert depuis l'éditeur, voir Lire un rapport.

Questions fréquentes

Qu'est-ce qu'un serveur MCP ?

MCP (Model Context Protocol) est un protocole ouvert qui permet à un assistant de code de se servir d'outils extérieurs. Le serveur MCP d'Accessia donne à votre assistant (Claude Code, Cursor, VS Code…) quatre capacités : auditer une page, lire un critère du RGAA, re-tester un correctif avant de l'appliquer et relire les problèmes d'un rapport.

Que coûte-t-il ?

Le paquet est gratuit. Un audit lancé depuis l'éditeur est décompté comme dans l'application : audits gratuits du mois, puis 1 crédit par page. Lire un critère, relire un rapport et re-tester un correctif ne coûtent rien (re-tests limités à 100 par jour).

Mon code est-il envoyé à Accessia ?

Oui, uniquement ce que l'assistant demande d'auditer ou de re-tester : le code de la page (ou du fragment) et le correctif proposé. L'audit devient un rapport rangé dans votre compte, comme un audit lancé dans l'application. Rien n'est envoyé tant que l'assistant n'appelle pas un outil d'Accessia.

Une page locale (localhost) peut-elle être auditée ?

Oui : le serveur MCP lit la page sur votre poste et envoie son code à Accessia. C'est le code tel que le serveur de développement le renvoie, avant l'exécution des scripts : la structure est analysée, mais pas le contraste réel, le focus ni l'affichage. Pour ces points, utilisez l'extension Chrome dans votre navigateur.

Un correctif « vérifié » rend-il la page conforme ?

Non. « Vérifié » signifie que les contrôles automatiques d'Accessia ne détectent plus le défaut sur ce code, sans en créer d'autre. La pertinence d'un texte (une alternative d'image, un intitulé de lien) reste à juger par une personne, et une partie des critères du RGAA ne se vérifie qu'à la main.