GTmetrix MCP

公式

公式GTmetrix MCP：AIツールから実際のページパフォーマンステストを実行し、レポートを確認し、履歴を追跡して、モニタリングを管理できます。ゲストアクセスを利用可能。すべての機能を利用するにはOAuthまたはAPIキーが必要です。

gtmetrix.com で表示

GTmetrix MCPで何ができますか？

  • パフォーマンステストを実行 — 場所、ブラウザー、デバイス、スロットリングのプリセットを選んでURLをテストするようアシスタントに依頼し、レポートを取得します。
  • レポートを分析 — GTmetrixのグレード、Core Web Vitals、Lighthouseの主な問題を確認し、HARとLighthouse JSONのダウンロードリンクを取得します。
  • 履歴とリグレッションを追跡 — 最新スコアとともにページを一覧表示し、ページのすべてのレポートを取得して、経時的な傾向を比較します。
  • モニタリングとアラートを管理 — モニタリングのオン・オフを切り替え、スコア、時間、ページサイズ、リクエスト数、CLSに関するアラート条件を設定します。
  • タグでページを整理 — 最大500ページに対して、タグの作成、名前変更、付与、削除を一括で行います。
  • アカウントとカタログを確認 — 残りのクレジットを確認し、利用可能な場所、ブラウザー、デバイス、スロットリングのプリセットを調べます。

ホスト型 MCP サーバー

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

Claude Code、Codex、Cursor などにインストールできます

ドキュメント

GTmetrix MCP

公式の GTmetrix MCP サーバーは、お使いの AI ツールを GTmetrix に接続します。プロンプトから実際のページパフォーマンステストを実行したり、レポートを読んだり、履歴を追跡したり、モニタリングを管理したりできます。

試すだけなら GTmetrix アカウントは不要です。 ゲストとして接続すれば、すぐにテストを開始できます。サインインすると、より多くのテストや機能を利用できます。

  • サーバー URL: https://gtmetrix.com/mcp
  • トランスポート: Streamable HTTP（リモート、インストール不要）
  • 認証: ゲスト（ログイン不要）、OAuth、または Authorization: Bearer ヘッダーを使った API キー
  • 対応ツール: Claude、ChatGPT、Codex、Cursor、GitHub Copilot CLI、および MCP 対応クライアント

クイックスタート

オプション 1: OAuth（推奨）

  1. お使いの AI ツールに、新しいリモート MCP サーバーまたはカスタムコネクターを追加します。
  2. 名前を GTmetrix にし、URL に https://gtmetrix.com/mcp を設定します。
  3. Connect / Authenticate をクリックします。

API キーは不要です。GTmetrix アカウントページの MCP Setup セクションから MCP URL をコピーすることもできます。

ゲストとして利用する

利用を開始するのに GTmetrix アカウントは不要です。ゲストとして、限られた数のゲストクレジットを使ってテストを実行したり、レポートを読んだり、ロケーション、ブラウザー、デバイスを調べたりできます。

ゲストクレジットを使い切った場合や、アカウントに紐づく機能（ページ履歴、モニタリング、アラート、タグ）を利用したい場合は、AI にサインインを依頼してください。AI が gtmetrix_reauthenticate を呼び出すと、サインインページが表示され、ログインまたは無料アカウントの作成ができます。

オプション 2: API キー

GTmetrix アカウントページで API キーを生成し、クライアントの設定に追加します。

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"

JSON 設定（Cursor およびリモート HTTP サーバーに対応するその他のクライアント）

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

GitHub Copilot CLI（OAuth のみ）

/mcp add GTmetrix

Server Type を HTTP、URL を https://gtmetrix.com/mcp、Tools を * に設定して保存し、ブラウザーで認証します。

手順ガイド: Claude · ChatGPT · Codex · Cursor · Copilot CLI

プロンプトの例

  • 「ロンドンとシドニーから、LTE 接続の iPhone で example.com をテストして、パフォーマンスに差があるか教えて。」
  • 「example.com の最新レポートを分析して、主な問題を3つ、わかりやすく説明して。」
  • 「'client' タグが付いたモニタリング中のページをすべてヘルスチェックして。B 評価未満、または LCP が 2 秒を超えるものを知らせて。」
  • 「今週のチェックアウトページのレポートを先月と比較して。何か悪化した？」
  • 「ホームページの日次モニタリングを設定して、LCP が 2.5 秒を超えたらアラートを出して。」
  • 「サイトのレンダリングを妨げている JavaScript を修正してから、GTmetrix を再実行し、改善を確認して。」

ツール

ゲストはテストツール（gtmetrix_get_report_har を除く）とアカウントおよび参照ツールを利用できます。それ以外のツールには GTmetrix アカウントが必要です。

テスト

ツール機能
gtmetrix_start_testURL のテストを開始します。ロケーション、ブラウザー、シミュレートされたデバイス、接続速度の制限、AdBlock、動画、Cookie、HTTP 認証、URL の許可／ブロックリスト、ビューポートサイズ、レポートの保持期間（1、6、12、24 か月）に対応しています。
gtmetrix_get_test実行中のテストを確認します。サーバー側で最大30秒間ロングポーリングし、完了するとレポート ID を返します。
gtmetrix_get_report完了したレポートを取得します。GTmetrix 評価、Performance と Structure のスコア、Core Web Vitals（LCP、TBT、CLS）、影響度順の Lighthouse の主な問題5件、リソースの概要、HAR と Lighthouse の完全な JSON のダウンロードリンクを返します。
gtmetrix_get_report_harHAR URL を直接ダウンロードできないクライアント向けに、HAR ウォーターフォールをインラインで返します。デフォルトではサイズ制限があります。

履歴とページ

ツール機能
gtmetrix_list_pagesページ（URL とテスト設定）を、最新のスコア、Web Vitals、モニタリング状況、タグとともに一覧表示します。URL、ロケーション、ブラウザー、デバイス、スロットリング、モニタリング頻度、タグなどで絞り込めます。
gtmetrix_get_report_historyトレンドやリグレッションの分析用に、ページのすべてのレポートを新しい順に取得します。

モニタリングとアラート

ツール機能
gtmetrix_set_page_monitoringページのモニタリングを有効化（毎時、毎日、毎週、毎月）または無効化します。
gtmetrix_get_page_alert_conditionsページのアラート条件を読み取ります。
gtmetrix_set_page_alert_conditionsスコア、時間（LCP、TTFB、TBT など）、ページサイズ、リクエスト数、CLS に関するアラート条件を設定します。
gtmetrix_get_page_alert_eventsページで発生したアラートを、関連レポートへのリンクとともに一覧表示します。

タグ

ツール機能
gtmetrix_list_page_tagsタグと、それぞれのタグを使用しているページ数を一覧表示します。
gtmetrix_save_page_tagタグを作成するか、既存のタグの名前または色を変更します。
gtmetrix_update_page_tags最大500ページに対して、一度にタグを追加または削除します。
gtmetrix_delete_page_tagタグを完全に削除します。

アカウントと参照

ツール機能
gtmetrix_get_account_statusプラン、残りの API クレジット、次回の補充日を表示します（ゲストには残りのゲストクレジットが表示されます）。
gtmetrix_get_catalog利用可能なブラウザー、ロケーション、シミュレートされたデバイス、スロットリングのプリセット、Lighthouse の監査項目を調べます。
gtmetrix_get_guideテストオプション、レポート分析、HAR 分析、テストエラーに関する組み込みガイドを読み取ります。
gtmetrix_reauthenticateゲスト接続からサインインするか、別の GTmetrix アカウントに切り替えます。

リソース

サーバーはガイドとカタログも 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

クレジットと制限

  • 誰でも MCP を利用できます。ゲストには限られた数のクレジットが付与され、GTmetrix アカウントがあれば、より多くのクレジットを利用できます。
  • テストやその他の操作では、GTmetrix API と同じレートで API クレジットを消費します。動画録画では、テストごとに 0.9 クレジットが追加で必要です。
  • クレジットの上限はプランによって異なります。PRO プランの一部では、毎日クレジットが補充されます。AI に gtmetrix_get_account_status を実行するよう依頼すると、残高を確認できます。
  • 同時実行できるテスト数: Basic は2件、PRO は8件。
  • 一部の機能（追加のロケーション、毎時のモニタリング、アラート時の動画）は、プランによって利用可否が異なります。

GTmetrix PRO プランを見る

FAQ

これはチャットボットですか？ いいえ。これは、お使いの AI ツールから GTmetrix にアクセスできるようにする接続レイヤーです。

GTmetrix アカウントは必要ですか？ いいえ。ゲストとして接続すれば、すぐにテストを実行できます。サインインすると、より多くのテストや機能を利用できます。

API キーは必要ですか？ 手動で設定する場合のみ必要です。OAuth 接続では不要です。

結果がグラフで表示されないのはなぜですか？ 表示方法はお使いの AI ツールによって異なります。レポートを取得した後、「このデータを可視化して」と依頼してください。

問題を修正してもらえますか？ GTmetrix はデータと診断結果を提供します。お使いの AI ツールがコードや CMS も編集できる場合は、修正を適用してテストを再実行し、結果を確認できます。

リンク