Lookout

lookout-mcp

これは Lookout 用の MCP サーバーです。Lookout を使うと、すべてのプロジェクトの Vercel Web Analytics を1つの画面で確認できます。

Claude、Cursor、または別の MCP クライアントを接続します。接続後、サイトの訪問者、流入元、キャンペーン、Core Web Vitals、サイト間のトラフィックについて質問できます。回答は実際の数値に基づいています。

「今週、最もパフォーマンスが落ちたランディングページはどれで、その直前に何がデプロイされましたか？」

このサーバーは Lookout REST API の薄いクライアントです。すべての回答は api.lookoutstats.com から取得されます。サーバーにデータは保存されません。

サーバーは次の2つの方法で実行できます。

• ホスト型、Streamable HTTP 経由：https://mcp.lookoutstats.com
• ローカル、stdio 経由：npx lookout-mcp

60秒でセットアップ

1. Lookout で Settings › API & MCP を開き、API キー（lk_live_…）を作成します。2つの書き込みツールを使う場合に限り、Allow notes and exports を選択してください。
2. 以下の設定のいずれかを使って、サーバーをクライアントに追加します。設定にキーを貼り付けてください。
3. クライアントを再起動します。

Claude Desktop

Settings → Developer → Edit config（claude_desktop_config.json）を開き、次のエントリーを追加します。

{
  "mcpServers": {
    "lookout": {
      "command": "npx",
      "args": ["-y", "lookout-mcp"],
      "env": { "LOOKOUT_API_KEY": "lk_live_…" }
    }
  }
}

claude.ai（コネクター）

claude.ai のカスタムコネクターはキーのヘッダーを送信しません。そのため、Lookout がコネクター向けの OAuth サインインに対応するまでは、ホスト型サーバーはコネクターから API キーを取得できません。Lookout が対応するまでは、Claude Desktop（上記）または Claude Code を使用してください。

Cursor

プロジェクト内の .cursor/mcp.json に次の設定を記述します。すべてのプロジェクトでサーバーを使用するには、~/.cursor/mcp.json に記述します。

{
  "mcpServers": {
    "lookout": {
      "url": "https://mcp.lookoutstats.com",
      "headers": { "Authorization": "Bearer lk_live_…" }
    }
  }
}

Claude Code

claude mcp add --transport http lookout https://mcp.lookoutstats.com \
  --header "Authorization: Bearer lk_live_…"

Windsurf

~/.codeium/windsurf/mcp_config.json に次の設定を記述します。

{
  "mcpServers": {
    "lookout": {
      "serverUrl": "https://mcp.lookoutstats.com",
      "headers": { "Authorization": "Bearer lk_live_…" }
    }
  }
}

その他のクライアント

• stdio：LOOKOUT_API_KEY=lk_live_… npx -y lookout-mcp
• Streamable HTTP：ヘッダー Authorization: Bearer lk_live_… を付けて POST https://mcp.lookoutstats.com を送信します。ゲートウェイが Authorization を独自に使用する場合（Smithery など）は、代わりに X-Lookout-Api-Key: lk_live_… を送信してください。

ツール

以下のルールはすべてのツールに適用されます。

• range は 24h、7d（デフォルト）、または 30d です。たとえば { "from": "2026-10-01", "to": "2026-10-14" } のように、カスタム期間を指定することもできます。カスタム期間は UTC で 30 日以内です。
• board はボードの ID または正確な名前です。
• 各ツールは最初に 1 行の概要を返します。その後にコンパクトな JSON が続きます。

ツール	引数	結果
list_boards	—	ワークスペース内のボードと、それぞれの ID およびサイト数
get_board	board、range	ボード上のすべてのサイト。各サイトについて、訪問者数、前の期間との変化、ページビュー数、訪問あたりのページ数、主な流入元と国、コンバージョンを表示します
get_site	site、range、board?	1 つのサイトの詳細。日別（または時間別）の訪問者数、主なリファラー、国とページ、本番環境へのデプロイ、Core Web Vitals を表示します。board を指定すると、メモも表示します。
compare_sites	sites[]（1～5）、range、mode、baseline?	サイトを横並びで比較します。absolute は訪問者数を表示します。indexed は最初の期間を 100 に設定します。baseline は各サイトを 1 つのサイトに対する割合で表示します。
get_campaigns	site、range	UTM キャンペーン、流入元、メディア別の訪問者数と目標コンバージョンを表示します。Vercel Web Analytics Plus が必要です。
get_flow	board、range	ボード上のサイト間のトラフィックを表示します。どのサイトがどのサイトに訪問者を送っているかを確認できます
get_speed	site、range、device	すべての訪問者、モバイル訪問者、またはデスクトップ訪問者の Core Web Vitals（LCP、INP、CLS、p75）と、最も遅いルートを表示します
list_fixes	board、range、status	ボードの Fix リスト。影響を受ける訪問者数に基づいて修正の優先順位を示し、その重要性と修正の確認方法を説明します
list_alerts	—	アラートルールと、過去 30 日間のアラート
add_annotation ✎	board、site?、date、text、scope	ボードのグラフ上の指定日に、1 つまたはすべてのサイトのメモを追加します
export_board ✎	board、fmt（pdf または csv）、range	ボードのダウンロードリンクを返します。リンクの有効期間は 5 分です。

✎ 書き込みツールです。書き込みツールには、メモとエクスポートを許可するキーが必要です。

リソース：

• lookout://boards：ボード。
• lookout://boards/{id}：過去 7 日間のボード上のサイト。

プロンプト：

• weekly_brief(board)：短いブリーフです。変化が最も大きかったサイトとその原因を示します。
• why_did_it_drop(site)：減少が始まった時期、変化した内容、考えられる原因を特定します。

質問の例

1. 「今週、最も大きく落ち込んだランディングページはどれですか？その直前に何がデプロイされましたか？」
2. 「過去 30 日間の 3 つの料金ページをインデックス化して比較してください。」
3. 「acme.com への訪問者はどこから来ていますか？最も多くの訪問者を獲得したキャンペーンはどれですか？」
4. 「モバイルで Core Web Vitals の基準を満たしていますか？最も遅いルートはどれですか？」
5. 「ランディングページからメインサイトに訪問者が送られていますか？行き止まりになっているページはどれですか？」

セキュリティ

• キーでアクセスできるのは、ご自身のデータだけです。 すべての呼び出しは、キーを使ってLookout APIに送信されます。キーから参照できるのは、そのキーに紐づくワークスペースだけです。サーバーはデータを保持せず、回答をログに記録しません。また、キーも保存しません。
• キーはデフォルトで読み取り専用です。 Allow notes and exports を有効にして作成しない限り、キーでできるのはデータの読み取りだけです。書き込み可能なキーでは、チャートのメモの追加やエクスポートリンクの作成ができます。ボード、メンバー、アラート、設定は変更できません。また、Vercelトークンも参照できません。
• 個人データはありません。 Vercel Web AnalyticsはCookieを使用しません。集計データを報告します。回答には、件数、ドメイン、パス、参照元、国が含まれます。回答から個人を特定することはできません。
• キーをリポジトリに含めないでください。 クライアントのローカル設定にキーを設定してください。例として、~/.cursor/mcp.json、Claudeの設定、環境変数があります。コミットするファイルにはキーを含めないでください。Settings › API & MCPから、いつでもキーを失効させることができます。失効したキーは、次のリクエストから使用できなくなります。
• 制限。 各キーのリクエスト数は1時間あたり600件です。REST APIとMCPサーバーで、この制限を共有します。compare_sites はサイトごとに1件のリクエストを送信します。それ以外の各ツールは1件のリクエストを送信します。制限を超えると、Retry-After ヘッダー付きの 429 レスポンスが返されます。ホスト型サーバーが受け付けるメッセージは、1バッチあたり5件までです。
• 外部からのデータ。 参照元、パス、UTM値、デプロイメッセージ、メモのテキストは、ウェブサイトやその訪問者に由来します。サーバーはモデルに対し、これらを指示ではなくデータとして扱うよう伝えます。書き込みツールが必要でない限り、キーは読み取り専用にしてください。

セキュリティ上の問題は、[email protected] までご連絡ください。

セルフホスティング

npm i -g lookout-mcp
PORT=3000 lookout-mcp-http        # Streamable HTTP on http://127.0.0.1:3000 (POST /, GET /health)

サーバーはデフォルトで 127.0.0.1 をリッスンします。コンテナ内では、HOST=0.0.0.0 を設定してください。

ハンドラーを独自のサーバーで使うこともできます。ハンドラーは、シンプルな (Request) => Promise<Response> 関数です。

import { createHttpHandler } from "lookout-mcp/http";
export const POST = createHttpHandler();

このリポジトリは、変更せずにVercelへデプロイできます（vercel.json、api/index.js）。どちらのエントリーポイントでも異なるAPIベースURLを使用するには、LOOKOUT_API_URL を設定してください。

リンク

• Lookout · APIとMCPのドキュメント · OpenAPI
• コントリビューション · 行動規範 · MITライセンス

LookoutはVercel Inc.と提携していません。