turbometrics-mcp

turbometrics MCP サーバー

Claude やその他の AI ツールを、turbometrics.io アカウントに直接接続します。

できること

AI アシスタントに、次のような質問をできます。

スキャンとパフォーマンス

• 「turbopress.de のパフォーマンススコアは？」
• 「turbometrics.io にはどんな指摘事項がありますか？」
• 「今週、スコアは改善しましたか？」
• 「turbopress.de と turbometrics.io を比較して」
• 「https://new-client-site.com をスキャンして、結果を見せて」 (監視対象外の URL も含め、任意の URL に対応)
• 「ヘルシンキから example.com のスキャンを開始して」

リアルユーザーモニタリング

• 「turbopress.de の Core Web Vitals を見せて」
• 「過去 30 日間で、サイトの LCP はどのように推移しましたか？」
• 「turbopress.de で LCP が最も悪いページはどれですか？」
• 「今週と先週の INP を比較して」

アラートとアカウント

• 「未解決のアラートをすべて見せて」
• 「ステータスで絞り込んで、最近のスキャンを一覧表示して」
• 「アラート #123 の詳細を見せて」
• 「未読のスコアアラートを既読にして」
• 「利用中のプランと、今日残っている API リクエスト数を教えて」

要件

• turbometrics.io アカウント（Starter プラン以上）

以上です。ブラウザーでサインインするため、コピーするトークンはありません。

利用可能なツール

ツール	説明
list_domains	スケジュールとステータスを含む、監視対象 URL の一覧を取得します
get_latest_scan	最新のスキャン結果を取得します。スコア、指摘事項、TTFB、Core Web Vitals、レポートへのリンクが含まれます
get_scan_history	スコア履歴を取得します。監視対象ドメインと新規ドメインの両方に対応します
get_findings	特定のスキャンの指摘事項の詳細を取得します
list_alerts	未解決、未読、解決済み、またはすべてのアラートを一覧表示します
get_rum_summary	リアルユーザーモニタリングの概要を取得します。Core Web Vitals の p75 値が含まれます
get_rum_metric_history	RUM 指標（LCP、CLS、INP、FCP、TTFB）の日ごとの推移を取得します
get_rum_pages	指標別に遅いページを順位付けして取得します
compare_domains	2 つのドメインを並べて比較し、それぞれのレポートへのリンクを取得します
trigger_scan	新規または監視対象の任意の URL のスキャンを開始します。リージョン（de-fsn1、de-nbg1、fi-hel1）と強制実行に対応します。パスワードで保護されたサイトは turbometrics.io 上でスキャンされます
list_scans	スキャンを一覧表示します。ドメイン、ステータス、ページで絞り込み可能で、レポートへのリンクも含まれます
get_alert	特定のアラートの詳細を取得します
mark_alerts_read	指定したアラートを（ID で）既読にします
get_account_info	アカウントの詳細を取得します。プラン、API 制限、RUM のステータスが含まれます

すべてのツールには MCP アノテーション（title、readOnlyHint、destructiveHint、 idempotentHint、openWorldHint）が付いています。12 個のツールはアカウントの読み取りのみを行います。 mark_alerts_read は指定したアラートの既読状態を変更し、 trigger_scan はサードパーティーのウェブサイトにアクセスする唯一のツールです。

認証

PKCE を使用する OAuth 2.1 です。クライアントから turbometrics.io に移動し、一度承認すると、 以後はクライアントがトークンを保持します。アクセストークンの有効期間は 1 時間で、 バックグラウンドで更新されます。Profile → API & apps から、接続済みのアプリをいつでも取り消せます。

OAuth に対応していないクライアントでも、同じページで発行できる個人用 API トークンを Authorization: Bearer YOUR_API_TOKEN として送信すれば認証できます。

セットアップ

Claude（推奨）

Claude は UI からカスタムコネクターを直接サポートしているため、Node.js も npx も 設定ファイルの編集も不要です。

1. Claude で Settings → Connectors → "Add custom connector" を選択します
2. 次を入力します。
   • Name: turbometrics
   • URL: https://turbometrics.io/mcp
3. "Add" をクリックしてから、"Connect" をクリックします
4. 開いたブラウザーウィンドウでアクセスを承認します

.de ではなく .io を使用してください。サインインは turbometrics.io でのみ行われるため、 別のドメインを指定したコネクターは認証できません。

このコネクターは Claude アカウント全体に適用されます。claude.ai、デスクトップアプリ、 モバイルアプリのすべてで利用できます。

Claude Code

claude mcp add --transport http turbometrics https://turbometrics.io/mcp

初回の使用時にサインイン用のブラウザーが開きます。

ChatGPT

開発者モードはベータ版で、ChatGPT Plus または Pro が必要です。

1. Settings → Developer Mode を有効にします
2. Apps & Connectors → create a new connector を選択します
3. サーバー URL：https://turbometrics.io/mcp
4. 認証方法として OAuth を選択し、ブラウザーで承認します

その他の MCP クライアント（Cursor、Windsurf など）

設定	値
サーバー URL	https://turbometrics.io/mcp
トランスポート	Streamable HTTP
認証	OAuth 2.1（自動的に検出されます）、または Authorization: Bearer YOUR_API_TOKEN

フォールバック：mcp-remote を使ったローカルセットアップ

コネクター UI がないクライアントや、古いバージョンの Claude／ChatGPT デスクトップ版でのみ必要です。mcp-remote が OAuth フローを実行するため、設定ファイルにトークンを記述する必要はありません。Node.js が必要です（brew install node、または nodejs.org からインストーラーをダウンロード）。

Mac の場合は ~/Library/Application Support/Claude/claude_desktop_config.json、Windows の場合は %APPDATA%\Claude\claude_desktop_config.json：

{
  "mcpServers": {
    "turbometrics": {
      "command": "/opt/homebrew/bin/npx",
      "args": [
        "mcp-remote",
        "https://turbometrics.io/mcp"
      ]
    }
  }
}

npx のパスをお使いのシステムに合わせて調整し（Mac では which npx、Windows の CMD では where npx）、クライアントを再起動します。

各クライアントの手順については、turbometrics.io/docs/mcp をご覧ください。

プラン

API アクセスは Starter プラン以上で利用できます。

プラン	1 日あたりの API 上限
Starter	1,000 リクエスト
Pro	5,000 リクエスト
Agency	無制限