GTmetrix MCP

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

GTmetrix MCP

O servidor oficial GTmetrix MCP conecta sua ferramenta de IA ao GTmetrix para que ela possa executar testes reais de desempenho de páginas, ler relatórios, acompanhar o histórico e gerenciar o monitoramento, tudo a partir de um prompt.

Não é necessário ter uma conta GTmetrix para experimentar. Conecte-se como visitante e comece a testar imediatamente. Faça login para desbloquear mais testes e recursos.

• URL do servidor: https://gtmetrix.com/mcp
• Transporte: HTTP com streaming (remoto, sem necessidade de instalação)
• Autenticação: Visitante (sem login), OAuth ou chave de API pelo cabeçalho Authorization: Bearer
• Compatível com: Claude, ChatGPT, Codex, Cursor, GitHub Copilot CLI e qualquer cliente compatível com MCP

---

Início rápido

Opção 1: OAuth (recomendado)

1. Adicione um novo servidor MCP remoto / conector personalizado à sua ferramenta de IA.
2. Dê a ele o nome GTmetrix e defina a URL como https://gtmetrix.com/mcp.
3. Clique em Conectar / Autenticar.

Não é necessária uma chave de API. Você também pode copiar a URL do MCP na seção MCP Setup da página da sua conta GTmetrix.

Usar como visitante

Você não precisa de uma conta GTmetrix para começar. Como visitante, você pode executar testes, ler relatórios e consultar locais, navegadores e dispositivos, usando um número limitado de créditos de visitante.

Quando seus créditos de visitante acabarem, ou se quiser usar recursos vinculados a uma conta (histórico de páginas, monitoramento, alertas, tags), peça à sua IA para fazer seu login. Ela chamará gtmetrix_reauthenticate, e você receberá uma página de login onde poderá entrar ou criar uma conta gratuita.

Opção 2: chave de API

Gere uma chave de API na página da sua conta GTmetrix e adicione-a à configuração do cliente.

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"

Configuração JSON (Cursor e outros clientes compatíveis com servidores HTTP remotos)

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

GitHub Copilot CLI (somente OAuth)

/mcp add GTmetrix

Defina Server Type como HTTP, URL como https://gtmetrix.com/mcp, Tools como *, salve e autentique-se no navegador.

Guias passo a passo: Claude · ChatGPT · Codex · Cursor · Copilot CLI

---

Exemplos de prompts

• "Teste example.com em Londres e Sydney em um iPhone com LTE e me diga se o desempenho é comparável."
• "Analise meu relatório mais recente de example.com e explique os 3 principais problemas em termos simples."
• "Faça uma verificação de integridade de todas as minhas páginas monitoradas com a tag 'client'. Sinalize qualquer página abaixo da nota B ou com LCP acima de 2s."
• "Compare os relatórios desta semana da minha página de checkout com os do mês passado. Houve alguma regressão?"
• "Configure o monitoramento diário da minha página inicial e me avise se o LCP ultrapassar 2.5 segundos."
• "Corrija o JavaScript que bloqueia a renderização no meu site, depois execute novamente o GTmetrix e confirme a melhoria."

---

Ferramentas

Visitantes podem usar as ferramentas de teste (exceto gtmetrix_get_report_har) e as ferramentas de conta e referência. As demais exigem uma conta GTmetrix.

Testes

Ferramenta	O que faz
gtmetrix_start_test	Inicia um teste em uma URL. Oferece suporte a local, navegador, dispositivo simulado, limitação de conexão, AdBlock, vídeo, cookies, autenticação HTTP, listas de URLs permitidas/bloqueadas, tamanho da janela de visualização e retenção do relatório (1, 6, 12 ou 24 meses).
gtmetrix_get_test	Verifica um teste em andamento. Aguarda no servidor (até 30s por chamada) e retorna o ID do relatório quando o teste termina.
gtmetrix_get_report	Obtém um relatório concluído: nota GTmetrix, pontuações de Performance e Structure, Core Web Vitals (LCP, TBT, CLS), os 5 principais problemas do Lighthouse classificados por impacto, um resumo dos recursos e links para baixar o HAR e o JSON completo do Lighthouse.
gtmetrix_get_report_har	Retorna o waterfall do HAR em linha, para clientes que não conseguem baixar diretamente a URL do HAR. O tamanho é limitado por padrão.

Histórico e páginas

Ferramenta	O que faz
gtmetrix_list_pages	Lista suas páginas (URL + configurações de teste) com as pontuações mais recentes, Web Vitals, status de monitoramento e tags. Filtre por URL, local, navegador, dispositivo, limitação, frequência de monitoramento, tags e muito mais.
gtmetrix_get_report_history	Obtém todos os relatórios de uma página, do mais recente ao mais antigo, para análise de tendências e regressões.

Monitoramento e alertas

Ferramenta	O que faz
gtmetrix_set_page_monitoring	Ativa o monitoramento (de hora em hora, diário, semanal, mensal) ou o desativa para uma página.
gtmetrix_get_page_alert_conditions	Lê as condições de alerta de uma página.
gtmetrix_set_page_alert_conditions	Define condições de alerta para pontuações, tempos (LCP, TTFB, TBT etc.), tamanho da página, solicitações ou CLS.
gtmetrix_get_page_alert_events	Lista os alertas acionados por uma página, com links para os relatórios relacionados.

Tags

Ferramenta	O que faz
gtmetrix_list_page_tags	Lista suas tags e quantas páginas usam cada uma.
gtmetrix_save_page_tag	Cria uma tag ou renomeia/altera a cor de uma tag existente.
gtmetrix_update_page_tags	Adiciona ou remove uma tag de até 500 páginas de uma só vez.
gtmetrix_delete_page_tag	Exclui uma tag permanentemente.

Conta e referência

Ferramenta	O que faz
gtmetrix_get_account_status	Mostra seu plano, os créditos de API restantes e a data da próxima recarga (visitantes veem os créditos de visitante restantes).
gtmetrix_get_catalog	Consulta os navegadores, locais, dispositivos simulados, predefinições de limitação e auditorias do Lighthouse disponíveis.
gtmetrix_get_guide	Lê os guias integrados sobre opções de teste, análise de relatórios, análise de HAR e erros de teste.
gtmetrix_reauthenticate	Faz login a partir de uma conexão de visitante ou troca para outra conta GTmetrix.

---

Recursos

O servidor também disponibiliza seus guias e catálogos como recursos 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éditos e limites

• Qualquer pessoa pode usar o MCP. Visitantes recebem um número limitado de créditos; uma conta GTmetrix oferece mais.
• Testes e outras ações usam créditos de API na mesma proporção que a API do GTmetrix. A gravação de vídeo adiciona 0.9 créditos por teste.
• Os limites de créditos dependem do seu plano. Alguns planos PRO recebem recargas diárias de créditos. Peça à sua IA para executar gtmetrix_get_account_status e consultar seu saldo.
• Testes simultâneos: 2 no Basic, 8 no PRO.
• Alguns recursos (mais locais, monitoramento de hora em hora, vídeo em alertas) dependem do seu plano.

Veja os planos GTmetrix PRO

---

Perguntas frequentes

Isto é um chatbot? Não. É uma camada de conexão que dá à ferramenta de IA que você já usa acesso ao GTmetrix.

Preciso de uma conta GTmetrix? Não. Você pode se conectar como visitante e executar testes imediatamente. Faça login para desbloquear mais testes e recursos.

Preciso de uma chave de API? Somente para configuração manual. Conexões OAuth não precisam de uma.

Por que meus resultados não são exibidos como gráficos? A renderização depende da sua ferramenta de IA. Depois de receber um relatório, peça a ela para "visualizar estes dados".

Ele pode corrigir problemas para mim? O GTmetrix fornece dados e diagnósticos. Se sua ferramenta de IA também puder editar seu código ou CMS, ela poderá aplicar correções e executar novamente um teste para confirmar o resultado.

---

Links

• Apresentação do GTmetrix MCP
• Guia de configuração
• Documentação da API do GTmetrix
• Suporte