Guide d'installation

Opquast MCP Server

Version 1.0.0 — 09/04/2026

1. Prérequis

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

Claude Code CLI — npm install -g @anthropic-ai/claude-code
https://docs.anthropic.com/en/docs/claude-code
Node.js 18+ — Pour l'outil d'inspection des pages (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

Claude Code (OAuth — recommandé)

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

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

Note : À la première utilisation, Claude Code ouvrira votre navigateur pour vous connecter à votre compte Opquast. En version bêta, votre accès doit être validé manuellement par l'équipe Opquast après votre première connexion.

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"

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

Claude Desktop

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. En version bêta, votre accès doit être validé manuellement par l'équipe Opquast après votre première connexion.

Installation automatique (script)

Vous pouvez aussi utiliser le script d'installation avec un token :

curl -sSL https://mcp.opquast.com/install.sh | bash -s -- <TOKEN>

Désinstallation

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

3. Premiers pas

Lancer Claude Code

Ouvrez votre terminal et lancez Claude Code :

claude

Astuce : 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 Claude Code dans votre terminal
Demandez l'audit : « Audite https://example.com selon les règles Opquast »
Attendez — Claude é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 Claude Code 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

Erreur 401 — Invalid, expired, or inactive 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é.

Claude ne trouve pas les outils Opquast

Vérifiez la configuration MCP : claude mcp list. Le serveur 'opquast' doit apparaître dans la liste.

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. Compatibilité avec d'autres clients IA

Le serveur Opquast MCP utilise le protocole standard MCP (Model Context Protocol) via transport HTTP. Il est donc compatible avec tout client supportant MCP, pas uniquement Claude Code.

Clients testés ou compatibles

Client	Type	Notes
Claude Code	CLI	Client testé
Claude Desktop	App	Support natif MCP + extension .mcpb
Claude.ai	Web	Via les intégrations MCP (settings)
VS Code + Copilot	IDE	Agent mode avec serveurs MCP
Cursor	IDE	Support MCP via Composer
Windsurf	IDE	Support Streamable HTTP
Cline	Extension VS Code	Support Streamable HTTP
ChatGPT	Web/App	Support MCP (OpenAI)
JetBrains AI	IDE	Plugin AI Assistant ou Junie
Gemini CLI	CLI	Google, support MCP
OpenAI Codex CLI	CLI	Via `~/.codex/config.toml`

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