GTmetrix MCP

npx add-mcp 'https://gtmetrix.com/mcp'

GTmetrix MCP

Le serveur MCP officiel de GTmetrix connecte votre outil d’IA à GTmetrix pour lui permettre d’exécuter de véritables tests de performance de pages, de consulter des rapports, de suivre l’historique et de gérer la surveillance, le tout à partir d’une invite.

Aucun compte GTmetrix n’est nécessaire pour essayer. Connectez-vous en tant qu’invité et commencez immédiatement les tests. Connectez-vous à votre compte pour accéder à davantage de tests et de fonctionnalités.

• URL du serveur : https://gtmetrix.com/mcp
• Transport : HTTP avec flux (à distance, aucune installation nécessaire)
• Authentification : invité (sans connexion), OAuth ou clé API via l’en-tête Authorization: Bearer
• Compatible avec : Claude, ChatGPT, Codex, Cursor, GitHub Copilot CLI et tout client compatible avec MCP

---

Démarrage rapide

Option 1 : OAuth (recommandée)

1. Ajoutez un nouveau serveur MCP distant ou un connecteur personnalisé dans votre outil d’IA.
2. Nommez-le GTmetrix et définissez l’URL sur https://gtmetrix.com/mcp.
3. Cliquez sur Connecter / S’authentifier.

Aucune clé API n’est nécessaire. Vous pouvez également copier l’URL MCP depuis la section Configuration MCP de la page de votre compte GTmetrix.

Utilisation en tant qu’invité

Vous n’avez pas besoin d’un compte GTmetrix pour commencer. En tant qu’invité, vous pouvez exécuter des tests, consulter des rapports et rechercher des emplacements, des navigateurs et des appareils, dans la limite d’un nombre restreint de crédits invités.

Lorsque vous n’avez plus de crédits invités, ou si vous souhaitez accéder aux fonctionnalités liées à un compte (historique des pages, surveillance, alertes, étiquettes), demandez à votre IA de vous connecter. Elle appellera gtmetrix_reauthenticate, et vous obtiendrez une page de connexion où vous pourrez vous connecter ou créer un compte gratuit.

Option 2 : clé API

Générez une clé API sur la page de votre compte GTmetrix, puis ajoutez-la à la configuration de votre client.

Claude Code

claude mcp add gtmetrix https://gtmetrix.com/mcp --transport http --header "Authorization: Bearer YOUR_API_KEY"

Codex (config.toml)

[mcp_servers.gtmetrix]
url = "https://gtmetrix.com/mcp"

[mcp_servers.gtmetrix.http_headers]
Authorization = "Bearer YOUR_API_KEY"

Configuration JSON (Cursor et autres clients compatibles avec les serveurs HTTP distants)

{
  "mcpServers": {
    "gtmetrix": {
      "url": "https://gtmetrix.com/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

GitHub Copilot CLI (OAuth uniquement)

/mcp add GTmetrix

Définissez le type de serveur sur HTTP, l’URL sur https://gtmetrix.com/mcp, les outils sur *, enregistrez, puis authentifiez-vous dans le navigateur.

Guides détaillés : Claude · ChatGPT · Codex · Cursor · Copilot CLI

---

Exemples d’invites

• « Teste example.com depuis Londres et Sydney sur un iPhone en LTE et dis-moi si les performances sont comparables. »
• « Analyse mon dernier rapport pour example.com et explique les 3 principaux problèmes en termes simples. »
• « Fais un bilan de santé de toutes mes pages surveillées portant l’étiquette 'client'. Signale tout résultat inférieur à la note B ou dont le LCP dépasse 2 s. »
• « Compare les rapports de cette semaine pour ma page de paiement à ceux du mois dernier. Y a-t-il eu une régression ? »
• « Configure une surveillance quotidienne de ma page d’accueil et alerte-moi si le LCP dépasse 2,5 secondes. »
• « Corrige le JavaScript qui bloque le rendu sur mon site, puis relance GTmetrix et confirme l’amélioration. »

---

Outils

Les invités peuvent utiliser les outils de test (à l’exception de gtmetrix_get_report_har) ainsi que les outils de compte et de référence. Les autres nécessitent un compte GTmetrix.

Tests

Outil	Fonction
gtmetrix_start_test	Lance un test sur une URL. Prend en charge l’emplacement, le navigateur, l’appareil simulé, la limitation de la connexion, AdBlock, la vidéo, les cookies, l’authentification HTTP, les listes d’autorisation et de blocage d’URL, la taille de la fenêtre d’affichage et la conservation des rapports (1, 6, 12 ou 24 mois).
gtmetrix_get_test	Vérifie un test en cours. Effectue une interrogation longue côté serveur (jusqu’à 30 s par appel) et renvoie l’ID du rapport une fois le test terminé.
gtmetrix_get_report	Récupère un rapport terminé : note GTmetrix, scores de performance et de structure, Core Web Vitals (LCP, TBT, CLS), les 5 principaux problèmes Lighthouse classés par impact, un résumé des ressources et des liens de téléchargement pour le fichier HAR et le JSON Lighthouse complet.
gtmetrix_get_report_har	Renvoie le diagramme en cascade HAR directement dans la réponse, pour les clients qui ne peuvent pas télécharger directement l’URL HAR. La taille est limitée par défaut.

Historique et pages

Outil	Fonction
gtmetrix_list_pages	Répertorie vos pages (URL + paramètres de test) avec les derniers scores, les Web Vitals, l’état de surveillance et les étiquettes. Filtre par URL, emplacement, navigateur, appareil, limitation, fréquence de surveillance, étiquettes et plus encore.
gtmetrix_get_report_history	Récupère tous les rapports d’une page, du plus récent au plus ancien, pour analyser les tendances et les régressions.

Surveillance et alertes

Outil	Fonction
gtmetrix_set_page_monitoring	Active la surveillance (toutes les heures, tous les jours, toutes les semaines, tous les mois) ou la désactive pour une page.
gtmetrix_get_page_alert_conditions	Consulte les conditions d’alerte d’une page.
gtmetrix_set_page_alert_conditions	Définit des conditions d’alerte sur les scores, les temps (LCP, TTFB, TBT, etc.), la taille de la page, le nombre de requêtes ou le CLS.
gtmetrix_get_page_alert_events	Répertorie les alertes déclenchées par une page, avec des liens vers les rapports correspondants.

Étiquettes

Outil	Fonction
gtmetrix_list_page_tags	Répertorie vos étiquettes et indique le nombre de pages associées à chacune.
gtmetrix_save_page_tag	Crée une étiquette ou renomme/recolore une étiquette existante.
gtmetrix_update_page_tags	Associe ou dissocie une étiquette sur un maximum de 500 pages à la fois.
gtmetrix_delete_page_tag	Supprime définitivement une étiquette.

Compte et référence

Outil	Fonction
gtmetrix_get_account_status	Affiche votre forfait, le nombre de crédits API restants et la date du prochain réapprovisionnement (les invités voient le nombre de crédits invités restants).
gtmetrix_get_catalog	Recherche les navigateurs, emplacements, appareils simulés, profils de limitation et audits Lighthouse disponibles.
gtmetrix_get_guide	Consulte les guides intégrés sur les options de test, l’analyse des rapports, l’analyse HAR et les erreurs de test.
gtmetrix_reauthenticate	Se connecte depuis une connexion invitée ou bascule vers un autre compte GTmetrix.

---

Ressources

Le serveur expose également ses guides et catalogues sous forme de ressources MCP :

• gtmetrix://docs/test-options-guide
• gtmetrix://docs/report-analysis-guide
• gtmetrix://docs/har-analysis-guide
• gtmetrix://docs/general-test-error-guide
• gtmetrix://docs/lighthouse-error-guide
• gtmetrix://catalog/browsers
• gtmetrix://catalog/locations
• gtmetrix://catalog/simulated-devices
• gtmetrix://catalog/throttle-connections
• gtmetrix://catalog/lighthouse-audits

---

Crédits et limites

• Tout le monde peut utiliser le MCP. Les invités disposent d’un nombre limité de crédits ; un compte GTmetrix vous en donne davantage.
• Les tests et les autres actions consomment des crédits API au même tarif que l’API GTmetrix. L’enregistrement vidéo ajoute 0,9 crédit par test.
• Les allocations de crédits dépendent de votre forfait. Certains forfaits PRO bénéficient d’un réapprovisionnement quotidien en crédits. Demandez à votre IA d’exécuter gtmetrix_get_account_status pour consulter votre solde.
• Tests simultanés : 2 avec Basic, 8 avec PRO.
• Certaines fonctionnalités (davantage d’emplacements, surveillance horaire, vidéo dans les alertes) dépendent de votre forfait.

Voir les forfaits GTmetrix PRO

---

FAQ

Est-ce un chatbot ? Non. C’est une couche de connexion qui permet à l’outil d’IA que vous utilisez déjà d’accéder à GTmetrix.

Ai-je besoin d’un compte GTmetrix ? Non. Vous pouvez vous connecter en tant qu’invité et exécuter des tests immédiatement. Connectez-vous à votre compte pour accéder à davantage de tests et de fonctionnalités.

Ai-je besoin d’une clé API ? Uniquement pour une configuration manuelle. Les connexions OAuth n’en nécessitent pas.

Pourquoi mes résultats ne s’affichent-ils pas sous forme de graphiques ? Le rendu dépend de votre outil d’IA. Après avoir obtenu un rapport, demandez-lui de « visualiser ces données ».

Peut-il corriger les problèmes à ma place ? GTmetrix fournit les données et les diagnostics. Si votre outil d’IA peut également modifier votre code ou votre CMS, il peut appliquer des corrections et relancer un test pour en confirmer le résultat.

---

Liens

• Présentation du GTmetrix MCP
• Guide de configuration
• Documentation de l’API GTmetrix
• Assistance