SCMCP — マルチテナント Google Search Console MCP

ホスト型のMCPサーバーで、任意の数のユーザーがClaudeを自分のGoogle Search Consoleデータに接続できます。生のGSCではできないカスタムSEO分析（クイックウィン、コンテンツ減衰、カニバリゼーション、CTR外れ値、ブランド分割、フォルダ集計、インテント分類、アルゴリズム更新相関）を提供します。

各ユーザーはGoogleでサインインし、スコープ付きアクセストークンを発行して、Claudeに接続します。各トークンは所有者のデータのみを読み取れます。すべてのツールは読み取り専用です。

SearchPulse のMCPサーバーを再利用して構築されています。

アーキテクチャ

Google sign-in ──► NextAuth ──► Account (OAuth tokens, ENCRYPTED at rest)
                                     │
Claude ──HTTP──► /api/mcp ──► token → userId (+ site scope)  ──► tools ──► GSC API
                     │
              IP + per-token rate limits · revocation · expiry · audit

• ログイン: Google OAuth (webmasters.readonly)、署名付きJWTとしてのセッション。

• ユーザーごとのMCPトークン: scmcp_ + 256ビットのエントロピー、SHA-256ハッシュとしてのみ保存。ユーザーごとに複数の名前付きトークンがあり、それぞれオプションでサイトスコープと有効期限を設定でき、個別に失効可能で、最終使用日時/IP/回数の監査があります。

• 状態: Prisma経由のPostgres。

Related MCP server: GSC MCP Server v2 - Remote Edition

MCPの堅牢化

セットアップ

1. データベース

Postgresデータベース（例: Neon の無料ティア）を作成し、接続文字列をコピーします。

2. Google Cloud

1. Google Cloud Console → プロジェクトを作成/選択します。

2. APIを有効化 → Google Search Console API。

3. 認証情報 → OAuthクライアントIDを作成 → Webアプリケーション。

4. 承認済みのリダイレクトURI:

   • http://localhost:3000/api/auth/callback/google (開発)

   • https://your-app.vercel.app/api/auth/callback/google (本番)

5. OAuth同意画面: 外部; ユーザーをテストユーザーとして追加（非公開・未検証アプリには問題ありません）。

3. 設定と実行

npm install
cp .env.example .env.local     # fill in all values
npm run db:push                # create the tables
npm run dev

• ランディング: http://localhost:3000

• サインイン: http://localhost:3000/login

• ダッシュボード（トークン + プレイグラウンド）: http://localhost:3000/dashboard

• ヘルス: http://localhost:3000/api/health

• MCPエンドポイント: http://localhost:3000/api/mcp

openssl rand -base64 32 でシークレットを生成します（NEXTAUTH_SECRET と ENCRYPTION_KEY 用）。

Vercel + Neon へのデプロイ

1. Gitリポジトリにプッシュし、Vercel でインポートします。Neon 統合を追加します（または DATABASE_URL を貼り付けます）。

2. 環境変数を設定: DATABASE_URL, NEXTAUTH_URL（本番URL）, NEXTAUTH_SECRET, GOOGLE_CLIENT_ID, GOOGLE_CLIENT_SECRET, ENCRYPTION_KEY。

3. 本番DBに対してスキーマを一度実行: npm run db:push（本番の DATABASE_URL を使ってローカルで、または一回限りのジョブで）。

4. Google Cloudで本番リダイレクトURIを追加します。デプロイします。

使用方法

1. ユーザーがあなたのURLにアクセスし、Googleでサインインして、/dashboard に着地します。

2. トークンを作成し（特定のサイトにスコープするか、有効期限を設定することも可能）、一度だけコピーします。

3. ダッシュボードが表示するスニペットでClaudeに接続します:

claude mcp add --transport http scmcp "https://your-app.vercel.app/api/mcp" --header "Authorization: Bearer <TOKEN>"

次に、「sc-domain:example.com の今月のクイックウィンは？」 と尋ねます。

ダッシュボードにはツールプレイグラウンド（セッション認証）もあり、Claudeを開かずに自分のデータに対して任意のツールを実行できます。

ツール

ライブGSC API — list_gsc_properties · gsc_totals · gsc_top_queries · gsc_top_pages · gsc_performance_timeseries · gsc_compare_queries · gsc_compare_pages · gsc_page_queries · gsc_query_pages · gsc_breakdown · gsc_quick_wins · gsc_content_decay · gsc_cannibalization · gsc_new_lost_keywords · gsc_ctr_outliers · gsc_branded_split · gsc_folder_performance · gsc_query_intent · list_algorithm_updates

BigQuery一括エクスポート（履歴、非サンプリング、1000行の上限なし）— bq_status · bq_totals · bq_top_queries · bq_top_pages · bq_timeseries · bq_by_country · bq_by_device · bq_page_queries · bq_query_pages · bq_custom_query

詳細は src/lib/tools.ts / src/lib/tools-bq.ts に追加 — ツールごとに1エントリ; スコープの強制と両方のトランスポートが自動的に取得します。

BigQueryコネクタ

Search Consoleの Bulk Data Export は、完全で非サンプリングのGSCデータをBigQueryに継続的にストリーミングします。SCMCPはそのエクスポートをクエリするため、ClaudeはライブAPIの制限を超えた履歴/大規模データを取得できます。

• 新しいシークレットは不要。 クエリはユーザー自身のOAuthトークン（SCMCPが bigquery.readonly スコープを追加）を使用して、ユーザー自身の Google Cloudプロジェクトに対して実行されます。保存するサービスアカウントキーはありません。

• セットアップ（ユーザーごと）: Search Console → 設定 → Bulk data export で、エクスポートをGCPプロジェクトに指定します。次にSCMCPダッシュボード → Analytics → BigQuery で、プロジェクトID、データセット（searchconsole で始まる）とロケーションを入力します。BigQueryアクセスは新しいスコープのため、既存ユーザーは一度サインアウトして再サインインします。

• 安全性: すべてのクエリはBigQueryの名前付きパラメータ（インジェクション安全）を使用し、請求バイト数（BQ_MAX_BYTES_BILLED、デフォルト10GB）を上限とし、トークンのサイトスコープを尊重します。bq_custom_query は単一の読み取り専用 SELECT を実行し、サイトスコープのトークンでは無効です。

Claudeに尋ねる: 「sc-domain:example.com の過去12か月のトップクエリをBigQueryから取得して。」

アナリティクスダッシュボード

/dashboard/analytics はデータをチャート（Recharts）としてレンダリングします: 前期間との差分を示すメトリックカード、メトリック切り替え付きの二軸パフォーマンス折れ線チャート、並べ替え/検索可能なトップページとトップクエリのテーブル、国/デバイスのバー。ソーストグルでビュー全体をライブGSC APIとBigQueryの間で切り替えます。セッション認証済みで、自分のデータを表示するのにMCPトークンは不要です。

スタック

Next.js 16 · NextAuth v5 (Google) · Prisma + Postgres · mcp-handler · @modelcontextprotocol/sdk · googleapis · zod.