FEATURE ／ MCP

Claude に「今週直す記事は？」と聞くと、画面と同じ数字が返る。

認証の設定、50,000行の上限、順位の重み付け、期間のズレ。AI に Search Console を渡すとき躓く場所は、全部こちらで済ませてあります。Claude Code と claude.ai のどちらからでも、蓄積データを分類済み・欠落リスク付きで引けます。

MCP とは

MCP（Model Context Protocol）は、Claude などの AI がツールやデータに接続するための共通規格です。MCP サーバーを1つ登録すると、AI はそのサーバーが公開する「ツール」を、会話の中で必要に応じて呼び出せるようになります。このダッシュボードは Search Console の蓄積データを MCP サーバーとして公開しており、Claude は「惜しい順位を出して」という日本語から適切なツールを選んで実行し、結果を根拠にして答えます。

Claude Code での聞き方

gsc MCP サーバーを登録すると、次のように聞けます。サイトは matome.response.jp のようにホスト名で指定でき、ツール名を覚える必要はありません。

こう聞く	使われるツール	返るもの
「matome.response.jp の惜しい順位を出して」	`gsc_striking`	11〜20位・表示100以上のクエリを狙い目スコア順に。受けているページURL付き
「この記事URLのブリーフを出して」	`gsc_page_brief`	流入クエリを主戦場・伸ばす・惜しい・参考に分類。期待CTRとの差、前回比バッジ
「今週直す記事は？」	`gsc_action_queue`	惜しい・低CTR・下落・上昇の候補を全サイト横断で。サイト指定も可
「表示が多いのにクリックされていないページは？」	`gsc_low_ctr`	表示1,000以上・CTR 1%未満のページを増分クリック見込み順に
「「結婚相談所料金」の順位推移を見せて」	`gsc_query_trend`	週次スナップショットごとの順位・表示・クリック。各回の欠落リスク付き

続けて「この結果を元に title 案を3つ」「上位3件をクライアント報告の文面にして」と頼めば、蓄積データを根拠にした下書きになります。数字を引用するときは、Claude は meta の期間と欠落リスクを併記します。

ツール一覧（17個）

役割	ツール
候補を出す	`gsc_action_queue` `gsc_striking` `gsc_low_ctr` `gsc_page_brief`
蓄積データを読む	`gsc_sites` `gsc_top_queries` `gsc_top_pages` `gsc_page_queries` `gsc_search_queries` `gsc_compare_queries` `gsc_query_trend` `gsc_sql`
Search Console を直接読む（蓄積前の確認用）	`gsc_live_sites` `gsc_live_totals` `gsc_live_queries` `gsc_live_pages` `gsc_live_page_queries`

判定ルール（惜しい・伸ばす・期待CTR・下落の閾値）は画面と MCP で同じ正本を参照しており、版番号（rule_version）が応答に付きます。定義は指標の定義、登録手順はドキュメントにあります。

claude.ai からの接続

claude.ai（ブラウザ・デスクトップアプリ）では、Supabase のホスト型 MCP をカスタムコネクタとして登録します。ローカルにサーバーを立てる必要はありません。

コネクタを追加

claude.ai の設定 → コネクタ → カスタムコネクタに、案内する URL を登録。読み取り専用のトークンで接続します。

ビューを読む

蓄積データは v_gsc_* という名前のビューにまとまっています。Claude が SQL を書いて問い合わせます。

日本語で聞く

「bizfun.co.jp で先月より順位が落ちたクエリは？」で、ビューを読んで答えます。順位の重み付けはビュー側で済んでいます。

Claude Code の gsc サーバーは分類・スコアまで済ませたツールを返し、claude.ai の経路は SQL でビューを読みます。判定ルールは同じですが、claude.ai では「惜しい」などの分類を Claude がビューの列から組み立てるので、細かな数値の扱いはドキュメントの SQL 例に従ってください。

応答に付く meta

すべてのツールの応答に、数字の解釈に必要な情報が付きます。AI の分析に「いつの・どれだけ信用できる数字か」の根拠が残ります。

項目	内容
データ期間	集計に含まれる日付の範囲（開始日〜終了日）。鮮度はこの終了日で判断する
取得日	そのスナップショットを取得した日時（JST）
欠落リスク	なし／上限に近い／上限到達。「近い」「到達」のとき、下位の増減を論じない
行数	取得した行数と、上限で切れているか（is_partial）
集計方法	順位は表示回数で重み付け、期間分割の有無、ルール版（rule_version）
警告	欠落・匿名化・期間の重複など、解釈に注意が要る点の文章

meta の例

"meta": {
  "site": "example.com",
  "period": { "start": "2026-08-01", "end": "2026-08-28" },
  "fetched_at": "2026-09-01T07:04:00+09:00",
  "truncation_risk": "near",
  "row_count": 41200,
  "is_partial": false,
  "aggregation": "position weighted by impressions; split=1",
  "rule_version": "2026-09-03.1",
  "warnings": ["取得行数が上限の80%を超えています。下位クエリの増減を論じないでください"]
}

例。項目名と値は説明用で、サイト名・数値は実データではありません。

MCP サーバーの説明文にも「truncation_risk が near / hit のときは『クエリが減った』という結論を出さない」と書いてあるので、Claude はツールを呼ぶ前からこの制約を知っています（データの正しさ）。

生データを渡す汎用 MCP との違い

Search Console API をそのまま MCP にしたサーバーは、他にもあります。違いは「AI に何を渡すか」です。

	API をそのまま渡す汎用 MCP	このダッシュボードの MCP
渡すもの	API の生の行（クエリ・クリック・表示・CTR・順位）	分類済みの候補（主戦場・惜しい・低CTR・下落）とスコア
期間	呼び出し時に API から取る。16ヶ月より前は取れない	週次の蓄積から。無期限、過去との比較ができる
50,000行上限	切れても気づかない。AI は「減った」と答える	検知・分割済み。欠落リスクを meta で渡す
順位の合算	AI が単純平均することがある	表示回数で重み付け済み。AI に計算させない
複数サイト	1回の呼び出しで1サイト	全サイト横断の候補を1回で
認証	利用者ごとに OAuth かサービスアカウントを設定	ダッシュボードのアカウントで完結
再現性	呼ぶたびに API の値が変わりうる	スナップショットなので、画面と AI で同じ数字