DOCS — CLAUDE.AI

claude.ai から使う

claude.ai のカスタムコネクタに Supabase のホスト型 MCP（読み取り専用）を登録すると、ブラウザの Claude から蓄積データに SQL で問い合わせられます。Claude Code の環境がない人向けの経路です。

カスタムコネクタを登録する

claude.ai の設定 → コネクタ → カスタムコネクタを追加を開きます。
名前（例: gsc）と、次の URL を入力します。
https://mcp.supabase.com/mcp?project_ref=<自分のプロジェクト>&read_only=true
<自分のプロジェクト> は運営（BizFun）からお渡しする Supabase の project_ref に置き換えます。read_only=true は外さないでください。
「追加」を押すと Supabase の OAuth 認可画面が開きます。対象の組織・プロジェクトを選んで許可します。
チャット画面のツール一覧に gsc が出ていれば完了です。会話ごとに有効／無効を切り替えられます。

この経路は Supabase が提供するホスト型の MCP サーバーを使います。GSC ダッシュボード側で新たにサーバーを立てる必要はなく、認証は Supabase のアカウントで行います。

蓄積 DB には v_gsc_* の7つのビューがあります。生テーブルではなく必ずビューを使ってください。掲載順位の重み付けがビューに固定されているためです。

ビュー	内容	列
`v_gsc_query`	スナップショットごとのクエリ別の値（28日集計）	site, period_start, period_end, truncation_risk, warnings, query, clicks, impressions, ctr, position
`v_gsc_page`	スナップショットごとのページ別の値（28日集計）	site, period_start, period_end, truncation_risk, warnings, page, clicks, impressions, ctr, position
`v_gsc_query_trend`	クエリの全期間合算。順位は表示回数で重み付け済み	site, query, first_period, last_period, snapshots, clicks, impressions, ctr, position, truncation_in_range
`v_gsc_page_trend`	ページの全期間合算。順位は表示回数で重み付け済み	site, page, first_period, last_period, snapshots, clicks, impressions, ctr, position, truncation_in_range
`v_gsc_striking`	惜しい順位（11〜20位・表示100以上）のクエリ。v_gsc_query の絞り込み	v_gsc_query と同じ
`v_gsc_low_ctr`	高表示・低CTR（表示1,000以上・CTR1%未満）のページ。v_gsc_page の絞り込み	v_gsc_page と同じ
`v_gsc_latest_snapshot`	サイトごとの最新スナップショット1行（概況と欠落リスク）	site, period_start, period_end, clicks, impressions, ctr, position_raw, clicks_prev, impressions_prev, truncation_risk, warnings, fetched_at

position は表示回数で重み付けした掲載順位。_trend ビューでは全スナップショットを合算した重み付き平均です。
truncation_risk は none / near / hit の3段階。truncation_in_range は期間内に1つでも none 以外があれば true。
site は https://bulkfit24.com/ のようなプロパティ URL です。like '%bulkfit24.com%' で絞ると確実です。
定義の詳細は指標の定義。

こう聞く	Claude が書く SQL の方向
「全サイトの最新スナップショットを、クリック数の多い順に一覧にして。欠落リスクも一緒に。」	v_gsc_latest_snapshot を使う
「bulkfit24.com の惜しい順位のクエリを、表示回数の多い順に20件。最新の期間だけで。」	v_gsc_striking を period_end の最大値で絞る
「kekkon-db.bzf.jp で「結婚相談所」を含むクエリの、蓄積開始からの合計クリックと重み付き順位。」	v_gsc_query_trend を query like で絞る

最初の会話で「GSC の蓄積データは v_gsc_* ビューにある。position は重み付け済み。truncation_risk が none 以外なら減少を断定しない」と一言伝えておくと、以降の SQL が安定します。プロジェクトの指示欄に書いておくのも有効です。

読み取り専用です。read_only=true の URL で登録するため、書き込みはできません。
DB に蓄積した分だけが対象です。毎週月曜の 28日集計スナップショットで、日次データや「今日の数字」はありません。
ライブ取得は Claude Code 側です。Search Console API から直接取る gsc_live_* や、記事 URL ごとの執筆ブリーフ gsc_page_brief は Claude Code から使うの経路にあります。
欠落リスクを併記する。数値を引用するときは truncation_risk を添え、none 以外の週の減少を「減った」と結論しないでください。
ページ×クエリの組み合わせは DB にありません。必要なら Claude Code 側の gsc_page_queries を使います。

接続情報（project_ref）は運営からお渡しします。まずは権限付与から。