Guide d'installation

Opquast MCP Server

Version 1.0.0 — 20/10/2026

1. Prérequis

Avant de commencer, assurez-vous de disposer des éléments suivants :

Un client IA compatible MCP — Claude Code, Claude Desktop, Codex CLI, ChatGPT… (voir la section 2 pour chacun)
Node.js 18+ — Pour l'outil d'inspection des pages utilisé lors des audits (Playwright ou Chrome DevTools). Recommandé : v20 ou v22.
https://nodejs.org
Système compatible — macOS 14+, Windows 11+, ou Linux (Debian 12+, Ubuntu 22.04+). Requis pour Playwright. Sur Linux, le script installe automatiquement les dépendances système.
Google Chrome — Uniquement si vous choisissez Chrome DevTools (optionnel avec Playwright)
https://www.google.com/chrome/

2. Installation

Choisissez la méthode correspondant à votre client IA. La connexion OAuth avec votre compte Opquast est recommandée partout.

Claude Code (OAuth — recommandé)

Connexion avec votre compte Opquast. Aucun token à gérer.

claude mcp add opquast https://mcp.opquast.com/mcp -t http

Note : Dans Claude Code, tapez /mcp, choisissez « opquast » puis « Authenticate » : votre navigateur s'ouvre sur la page de connexion Opquast. Autorisez l'accès puis revenez dans Claude Code. Après votre première connexion, votre accès doit être validé par l'équipe Opquast : vous recevez un email dès qu'il est activé.

Claude Code (script d'installation)

Configure en une commande le serveur Opquast et un outil d'inspection des pages (Playwright ou Chrome DevTools) pour les audits. Sans argument, le script utilise OAuth ; avec un token, il l'ajoute à la configuration.

curl -sSL https://mcp.opquast.com/install.sh | bash
curl -sSL https://mcp.opquast.com/install.sh | bash -s -- oqs_mcp_VOTRE_TOKEN

Note : Ajoutez --local pour limiter l'installation au projet courant. Désinstallation : curl -sSL https://mcp.opquast.com/install.sh | bash -s -- --uninstall

Claude Code (token manuel)

Authentification par token personnel.

claude mcp add opquast https://mcp.opquast.com/mcp -t http -H "Authorization: Bearer oqs_mcp_VOTRE_TOKEN"

Note : Remplacez oqs_mcp_VOTRE_TOKEN par votre token personnel obtenu sur login.opquast.com/mcp/tokens/.

Claude Desktop (extension — recommandé)

Téléchargez l'extension Opquast puis ouvrez le fichier : Claude Desktop l'installe en un clic.

https://mcp.opquast.com/opquast.mcpb

Note : À la première utilisation d'un outil Opquast, votre navigateur ouvre une page Opquast : connectez-vous, vérifiez le code affiché puis autorisez l'extension, et revenez dans Claude. La connexion est ensuite conservée et renouvelée automatiquement. Après votre première connexion, votre accès doit être validé par l'équipe Opquast : vous recevez un email dès qu'il est activé.

Claude Desktop (configuration manuelle)

Ajoutez cette configuration dans Paramètres > Développeur > Modifier la configuration :

{
  "mcpServers": {
    "opquast": {
      "type": "http",
      "url": "https://mcp.opquast.com/mcp"
    }
  }
}

Note : Claude Desktop découvre automatiquement l'authentification OAuth. À la première utilisation, il ouvrira votre navigateur pour vous connecter. Après votre première connexion, votre accès doit être validé par l'équipe Opquast : vous recevez un email dès qu'il est activé.

OpenAI Codex CLI (OAuth)

Avec Codex CLI 0.163 ou plus récent (mise à jour : codex update).

codex mcp add opquast --url https://mcp.opquast.com/mcp
codex mcp login opquast

Note : codex mcp add lance directement la connexion : votre navigateur s'ouvre sur la page de connexion Opquast. codex mcp login opquast ne sert qu'à vous reconnecter. Après votre première connexion, votre accès doit être validé par l'équipe Opquast : vous recevez un email dès qu'il est activé.

ChatGPT (connecteur)

Disponible selon votre offre ChatGPT, via le mode développeur.

Paramètres → Apps → Paramètres avancés : activez le mode développeur.
Créez une app (connecteur) : nom « Opquast », URL du serveur MCP https://mcp.opquast.com/mcp, authentification OAuth.
Connectez-vous sur la page Opquast qui s'ouvre et autorisez l'accès.
Dans une conversation, activez le connecteur Opquast puis posez votre question.

Note : Après votre première connexion, votre accès doit être validé par l'équipe Opquast : vous recevez un email dès qu'il est activé.

3. Premiers pas

Lancer votre client

Ouvrez votre client IA et posez directement votre question : il appelle les outils Opquast si besoin. Avec Claude Code, lancez simplement dans votre terminal :

claude

Astuce : Pour les audits avec Claude Code, le navigateur est lancé automatiquement par l'outil d'inspection (Playwright ou Chrome DevTools) avec un profil isolé. Vous n'avez pas besoin de l'ouvrir manuellement.

Exemples de prompts

Voici quelques exemples de ce que vous pouvez demander :

« Audite https://example.com selon les règles Opquast »
« Quelles sont les règles Opquast sur les formulaires ? »
« Donne-moi la règle n°42 avec les instructions pour la vérifier »
« Audite cette page sur le thème Sécurité »
« Quels sont les thèmes du référentiel Opquast ? »

4. Outils disponibles

Le serveur MCP Opquast expose 7 outils :

Outil	Description
`get_rule`	Récupérer une règle par son numéro (1–245). Formats : résumé, détaillé ou actionnable.
`search_rules`	Rechercher des règles par mot-clé, avec filtrage optionnel par thème ou tag.
`get_rules_by_theme`	Obtenir toutes les règles d'un thème donné.
`list_themes`	Lister les 14 thèmes disponibles avec le nombre de règles par thème.
`list_versions`	Lister les versions du référentiel disponibles.
`get_audit_checklist`	Obtenir le protocole d'audit structuré pour une URL.
`generate_audit_report`	Générer un rapport d'audit HTML ou JSON avec synthèse et recommandations.

5. Lancer un audit

Workflow type

Lancez votre client (par exemple Claude Code dans votre terminal)
Demandez l'audit : « Audite https://example.com selon les règles Opquast »
Attendez — l'assistant évalue les 245 règles (environ 5 à 15 minutes)
Consultez le rapport — un lien vers le rapport HTML est fourni

Astuce : Pour un audit ciblé, précisez un thème : « Audite cette page sur le thème Formulaires »

6. Consommation de tokens

Chaque interaction avec votre client IA consomme des tokens (unités de traitement du modèle IA). Voici les ordres de grandeur selon le type d'utilisation :

Action	Estimation	Détail
Consulter une règle	~1 000 tokens	Requête simple, réponse courte.
Rechercher des règles par mot-clé	~2 000 tokens	Dépend du nombre de résultats.
Audit thématique (1 thème)	~30 000 tokens	Inspection de la page + évaluation de 10 à 30 règles.
Audit complet (245 règles)	~200 000 tokens	Inspection approfondie + évaluation de toutes les règles + génération du rapport.

7. Dépannage

« Votre accès au MCP Opquast est en attente de validation » (erreur 403)

Votre connexion a réussi mais votre compte n'a pas encore été validé par l'équipe Opquast. Vous recevez un email dès que l'accès est activé ; relancez ensuite votre demande, sans vous reconnecter.

La page de connexion Opquast affiche « Cette connexion n'est plus reconnue »

Votre outil utilise une ancienne inscription OAuth. Supprimez le serveur Opquast de votre outil puis ajoutez-le à nouveau (Claude Code : claude mcp remove opquast puis claude mcp add ; Codex : codex mcp remove opquast puis codex mcp add ; ChatGPT : supprimez puis recréez le connecteur).

Extension Claude Desktop : se reconnecter ou changer de compte

Quittez Claude Desktop, supprimez le fichier credentials.json du dossier « Opquast MCP » (macOS : ~/Library/Application Support/Opquast MCP/ ; Windows : %APPDATA%\Opquast MCP\), puis relancez Claude Desktop : la connexion vous sera redemandée au prochain appel d'un outil Opquast.

Erreur 401 — Invalid, expired, or inactive token (méthode par token)

Vérifiez que votre token commence par oqs_mcp_ et qu'il a été activé par l'équipe Opquast. Vous pouvez vérifier le statut de vos tokens sur login.opquast.com/mcp/tokens/. Relancez l'installation avec le bon token : curl -sSL https://mcp.opquast.com/install.sh | bash -s -- <VOTRE_TOKEN>

L'outil d'inspection ne se connecte pas

Si vous utilisez Playwright, relancez npx -y playwright install chromium. Si vous utilisez Chrome DevTools, vérifiez que Google Chrome est installé. Le serveur lance automatiquement un navigateur avec un profil isolé.

Les outils Opquast n'apparaissent pas

Vérifiez la configuration MCP de votre outil (Claude Code : claude mcp list ; Codex : codex mcp list) : le serveur 'opquast' doit apparaître et être connecté. Avec l'extension Claude Desktop, tant que vous n'êtes pas connecté, seul l'outil « opquast_connexion » est proposé : demandez simplement une règle Opquast pour lancer la connexion.

Timeout lors de l'audit

Certaines pages lourdes peuvent dépasser le timeout par défaut. Essayez d'auditer un thème spécifique plutôt que l'audit complet.

Le rapport ne s'affiche pas

Les rapports expirent après 1 heure. Si le lien ne fonctionne plus, relancez la génération du rapport.

Playwright : erreur de dépendances système (Linux)

Sur Linux, relancez l'installation avec : npx -y playwright install --with-deps chromium. Cela installe automatiquement les bibliothèques système nécessaires (libgbm, libatk, etc.).

Session perdue après mise à jour du serveur

C'est normal : lors d'un redéploiement, le serveur redémarre et les sessions en cours sont interrompues. Le client se reconnecte automatiquement avec une nouvelle session. Si ce n'est pas le cas, relancez simplement votre conversation.

8. Clients compatibles

Clients testés

Ces clients IA ont été testés par Opquast (connexion et outils) :

Client	Type	Installation
Claude Code	CLI	OAuth, token ou script d'installation
Claude Desktop	Application	Extension Opquast (.mcpb) ou configuration manuelle
OpenAI Codex CLI	CLI	OAuth (version 0.163 ou plus récente)
ChatGPT	Web / application	Connecteur en mode développeur

Autres clients

Le serveur Opquast MCP respecte les standards : protocole MCP (Model Context Protocol) en HTTP et authentification OAuth. En théorie, tout client compatible MCP et OAuth devrait donc fonctionner : indiquez-lui l'adresse https://mcp.opquast.com/mcp, puis connectez-vous avec votre compte Opquast. Si vous rencontrez un problème avec un autre client, écrivez-nous.

9. Contact et support

Email : support@opquast.com

Référentiel : checklists.opquast.com

Ce guide en ligne : https://mcp.opquast.com/guide

Ce guide en PDF : https://mcp.opquast.com/guide.pdf