MCP経由でGSCを接続

Google Search ConsoleのデータをMCP経由で接続するには?

MCPに対応したアシスタントなら、https://mcp.gscwizard.com/mcpを指定し、ログインまたはAPIキーで認証するだけで、実際のSearch Consoleのデータを読み取れます。分析はサーバー側で実行されるため、アシスタントには生の行ではなく完成した答えが返ります。

ChatGPT、Claude、Grok、Gemini CLI、Cursor、VS Code、Windsurf、その他あらゆるMCPクライアントで動作します。

簡単な答え

クライアントを問わず、接続に必要なことは3つです。

  1. GSC Wizardの中でSearch Consoleを一度だけ接続します。認可はアシスタントではなくここにあります。
  2. クライアントにエンドポイントを追加します:https://mcp.gscwizard.com/mcp
  3. 認証:クライアントが対応していればOAuth 2.1でログインし、そうでなければAuthorization: Bearer gscw_live_...を送信します

サーバーはストリーム可能なHTTPで動作するため、ほとんどのクライアントでローカルへのインストール、Nodeプロセス、stdioブリッジは不要です。

Streamable HTTPエンドポイント

https://mcp.gscwizard.com/mcp

OAuth 2.1によるログイン

ChatGPT、ClaudeのConnectors UI、Grokのコネクタ、Gemini CLI向け。クライアントが自分自身を登録し、Googleのログインへ案内します。コピーも保存も不要です。

APIキーヘッダー

Claude Code、Cursor、VS Code、Windsurfなどの設定ファイル型クライアントと、Meta Muse向け:Authorization: Bearer gscw_live_...を送信します

動画

セットアップの全手順を動画で見る

セットアップから最初の質問まで通しで紹介します。コネクタを追加し、ログインを済ませ、生の行ではなく完成した分析が返ってくる流れです。

セットアップ

接続の3ステップ

どのクライアントでも同じ3ステップです。変わるのは設定の書き方だけです。

  1. 1

    プロパティを接続する

    Googleでtool.gscwizard.comにログインし、使えるようにしたいSearch Consoleプロパティを選びます。認可を付与する場所はここだけです。

  2. 2

    APIキーを作成するか、ログインで接続する

    設定ファイル型のクライアントには、アカウント → APIキーでキーを作成します。リモートOAuthに対応するクライアント(ChatGPT、ClaudeのConnectors UI、Grokのコネクタ、Gemini CLI)は、URLだけで足ります。

  3. 3

    クライアントにサーバーを追加する

    クライアントにhttps://mcp.gscwizard.com/mcpを指定します。キーの名前はクライアントごとに異なりますが、URLとBearerヘッダーは変わりません。

コピーして貼り付け

すべてのクライアントの設定

gscw_live_...を、アカウント → APIキーで作成したキーに置き換えてください。

Claude Code

コマンド1つ、APIキーのヘッダー。

claude mcp add --transport http gsc-wizard \
  https://mcp.gscwizard.com/mcp \
  --header "Authorization: Bearer gscw_live_..."

Claude(ウェブ版とデスクトップ版)

設定 → コネクタ → カスタムコネクタを追加。URLを貼り付け、OAuthのクライアントIDとシークレットは空欄のままにします。Claudeが自分自身を登録し、ログインしてくれます。

https://mcp.gscwizard.com/mcp

ChatGPT

設定 → アプリ、開発者モードで、認証をOAuthにしたアプリを追加します。有料プランが必要です。APIキーの欄はありません。ChatGPTは固定のBearerトークンを送れないためです。または、これらをすべて省いてChatGPT App StoreからGSC Wizardアプリをインストールすることもできます。

https://mcp.gscwizard.com/mcp

Grok

grok.com/connectorsを開き、New ConnectorをクリックしてCustomを選びます。URLを貼り付けてログインを完了します。GrokはOAuth 2.1で自分自身を登録するため、入力するクライアントIDやシークレットはありません。その後Grokがツールを検出し、会話の中で使えるようにします。詳しい手順はGSCをGrokに接続するをご覧ください。

https://mcp.gscwizard.com/mcp

Microsoft Copilot Studio

エージェントにOAuth 2.0と手動の構成タイプでModel Context Protocolツールを追加します。クライアントIDとシークレットはアカウント → MCP APIキー → Microsoft Copilot Studioで作成します。ここには貼り付けるべきURLもすべて載っています。その後、その接続でCopilot Studioが提示するリダイレクトURLを保存してください。詳しい手順はMicrosoft Copilot StudioでSEOデータを使うをご覧ください。

https://mcp.gscwizard.com/mcp

Meta Muse

Museにはカスタムコネクタの設定画面がありません。会話の中で、下のURLに対するカスタム連携を作るよう依頼してください。リモートHTTPで、Bearerトークン認証です。読み取り専用のAPIキーを作成し、チャットではなく、Museの安全な認証情報の入力画面に貼り付けてください。詳しい手順は、Search Console向けSEO MuseコネクタとGoogle Analytics向けMuseコネクタをご覧ください。

URL:  https://mcp.gscwizard.com/mcp
Auth: Bearer gscw_live_... (read-only key)

Gemini CLI

~/.gemini/settings.jsonに追加します。Gemini CLIはストリーム可能なHTTPにhttpUrlを使います。

{
  "mcpServers": {
    "gsc-wizard": {
      "httpUrl": "https://mcp.gscwizard.com/mcp",
      "headers": { "Authorization": "Bearer gscw_live_..." }
    }
  }
}

OpenAI Codex

~/.codex/config.toml(Codex CLI、IDE拡張機能、アプリで共通)に、キーを環境変数にして追加するか、codex mcp add gsc-wizard --url https://mcp.gscwizard.com/mcpを実行してcodex mcp login gsc-wizardでログインします。詳しいガイド:Codex向けGSC MCP。

[mcp_servers.gsc-wizard]
url = "https://mcp.gscwizard.com/mcp"
bearer_token_env_var = "GSCW_API_KEY"

Cursor

~/.cursor/mcp.json(グローバル)、またはプロジェクト内の.cursor/mcp.jsonに追加します。

{
  "mcpServers": {
    "gsc-wizard": {
      "url": "https://mcp.gscwizard.com/mcp",
      "headers": { "Authorization": "Bearer gscw_live_..." }
    }
  }
}

VS Code(Copilotエージェントモード)

.vscode/mcp.jsonに追加します。VS CodeはmcpServersではなくserversを使い、キーの入力を求められるため、キーがソース管理に残りません。

{
  "inputs": [
    { "id": "gscw-key", "type": "promptString", "description": "GSC Wizard MCP key", "password": true }
  ],
  "servers": {
    "gsc-wizard": {
      "type": "http",
      "url": "https://mcp.gscwizard.com/mcp",
      "headers": { "Authorization": "Bearer ${input:gscw-key}" }
    }
  }
}

Windsurf

~/.codeium/windsurf/mcp_config.jsonに追加します。WindsurfはリモートサーバーにserverUrlを使用します。

{
  "mcpServers": {
    "gsc-wizard": {
      "serverUrl": "https://mcp.gscwizard.com/mcp",
      "headers": { "Authorization": "Bearer gscw_live_..." }
    }
  }
}

その他のMCPクライアント

Streamable HTTPエンドポイントを指定し、キーをベアラートークンとして送信します。キーの名前はクライアントによって異なります(transportとtype、urlとserverUrl)が、URLとヘッダーは変わりません。

URL:    https://mcp.gscwizard.com/mcp
Header: Authorization: Bearer gscw_live_...

ステップバイステップガイド:ChatGPT、Claude、Gemini、Grok、Meta Muse。ChatGPTには独自のルールがあります(リモートサーバーのみ、APIキーではなくOAuth、開発者モードは有料プランが必要)。詳しくは2026年版 Search ConsoleデータのためのChatGPTコネクタをご覧ください。Claudeについては、このページで要約しているプロトコルの詳細をClaude Search Console MCPサーバーのリファレンスで解説しています。

認証とスコープ

すべてのキーには作成時に選んだスコープが設定されるため、アシスタントに許可する操作の範囲を自分で決められます。

読み取り専用

データのクエリとレポートの実行ができます。読み取りキーでは書き込みツールを物理的に呼び出せないため、接続は構造上、読み取り専用になります。共有エージェントや、クライアント向けの環境に適した選択です。

読み取りと書き込み

読み取りキーでできることすべてに加えて、サイトの追加、IndexNowへのURL送信、トピッククラスタ、コンテンツグループ、アノテーションの管理といった変更操作が可能です。変更はすべて、お客様のアカウントの監査ログに記録されます。

キーは作成時に一度だけ表示され、いつでも無効化でき、GSC Wizardアカウントにすでに接続されているSearch Consoleプロパティにしかアクセスしません。

このMCPが違う理由

モデルが見る前に分析が完了している

多くのSEO向けMCPサーバーは、生の行データをそのままアシスタントに返します。しかし言語モデルは、大きな表に対する計算には向いていません。遅く、トークンを消費し、ミスにも気づきにくいからです。

トークンが大幅に少ない

1回のツール呼び出しで、モデルが読み込み、コンテキストに保持し、そのぶんの料金を支払う必要がある何万行ものデータではなく、コンパクトに完成した回答が返ります。

はるかに高速

集計はウェアハウス上でミリ秒単位で実行されます。4 GBのデータセットに対する完全なSEOレポートが約4.4秒で完了し、GSC APIを1バッチずつページングする必要はありません。

エラーが起きにくい

計算は決定論的です。数値は実際のクエリから得られるため、モデルが数え間違えたり、合計を作り上げたりするおそれはありません。

より大きなデータセットを対象に

負荷の高い処理がコンテキストウィンドウに入ることはないため、サーバーはプロンプトには到底収まらない数か月分、数百万行のデータを分析できます。

アシスタントが呼び出せるもの

すべてのツールの引数例を含む完全なカタログは、mcp.gscwizard.comで公開しています。

検索アナリティクス 上位のクエリとページ ランキングの変動 キーワードカニバリゼーション コンテンツ劣化の検出 あと一歩のキーワード / ページの押し上げ CTR曲線の分析 改善機会のスコアリング URLの一括検査 インデックス登録トラッカー IndexNowへの送信 コンテンツグループとトピッククラスタ 国別・デバイス別の内訳 サイトマップのパフォーマンス SEOレポートの自動作成 指名・非指名の内訳 掲載順位の分布 移行の比較 共有可能なクライアント向けレポート Google Analytics 4 ウェブに関する主な指標(CrUX) 予測と異常検出 Bing Webmaster Tools

接続できない場合

ツールが表示されない

多くのクライアントはMCPの設定を起動時にしか読み込みません。設定ファイルを編集したら、ウィンドウだけでなくアプリを完全に終了してから開き直してください。

401 Unauthorized(認証エラー)

ヘッダーが正確にAuthorization: Bearer gscw_live_...になっていること、キーが無効化されていないこと、アカウントに有効なサブスクリプションまたはトライアルがあることを確認してください。

Claude Desktopが設定を無効と判断する

設定ファイルで起動できるのはローカルのstdioサーバーのみのため、"type": "http"のエントリは拒否されます。コネクタのUIを使うか、mcp-remote経由でブリッジしてください。Claudeガイドをご覧ください。設定ファイルがHTTPのエントリを拒否する理由はClaude Search Console MCPリファレンスで解説しています。

書き込みツールが403を返す

キーが読み取り専用です。アシスタントがどうしてもデータを変更する必要がある場合は読み書きキーを作成し、そうでなければ読み取りキーのままにして、変更はアプリ上で行ってください。

プロパティが見つからない

MCPから見えるのは、GSC Wizardにすでに接続されているプロパティだけです。まずアプリで追加し、その後アシスタントにサイトの一覧をもう一度取得させてください。ドメインプロパティにはsc-domain:のプレフィックスが付きます。

同じデータを、ほかのアシスタントでも

別のAIツールを接続しますか?

1つのSearch Console接続で、すべてのアシスタントに対応。お使いのクライアントを選び、ステップバイステップガイドに従ってください。

あわせて、Google Search Console MCPの概要、GA4 MCP、Yandex Webmaster MCP、Merchant Center MCP、ChatGPTアプリ(ChatGPTにインストールする)、Search ConsoleとGoogle Analytics向けのMeta Museコネクタ、おすすめSEO向けMCPサーバーのまとめ、そしてGSC Wizardが2026年のベストなSearch Console MCPである理由もご覧ください。

よくある質問

MCPサーバーとは?

MCP(Model Context Protocol)サーバーは、AIアシスタントがライブデータを読み取り、ツールを呼び出せるようにする標準のコネクタです。Google Search Console MCPはSearch Consoleのプロパティをアシスタントに公開するため、アシスタントは数値を作り上げる代わりに、実際のクリック数、表示回数、掲載順位、CTRを取得できます。

どのクライアントが接続できますか?

リモートMCPサーバーに対応しているクライアントなら、どれでも接続できます。ChatGPT、ClaudeとClaude Code、Grok、Gemini CLI、Cursor、Copilotのエージェントモードを使ったVS Code、Windsurf、Gemini Enterprise、そしてOpenAI、Anthropic、GoogleのSDKで構築したカスタムエージェントなどです。エンドポイントはStreamable HTTPに対応しています。

APIキーとOAuth、どちらが必要ですか?

設定ファイル方式のクライアント(Claude Code、Cursor、VS Code、Windsurf、Gemini CLI)は、APIキーをAuthorization: Bearerヘッダーで送信します。コネクタのUIがあるクライアント(ChatGPT、Claudeのウェブ版とデスクトップアプリ、Grok)はOAuth 2.1と動的クライアント登録を使うため、ログインするだけでよく、クライアントIDとシークレットは空欄のままにします。

接続を読み取り専用にできますか?

はい。すべてのAPIキーには、作成時に選んだスコープが設定されます。読み取り専用キーでは書き込みツールをまったく呼び出せないため、接続は構造上、読み取り専用になります。読み書きキーでは、サイトの追加、IndexNowのURL送信、クラスタの管理などの変更操作が加わり、そのすべてが監査ログに記録されます。

データはどのくらい新しいですか?

ウェアハウスから読み取るデータは、Search Console本体より約2日遅れており、各レスポンスには確定済みの日付が記載されます。ウェアハウスで対応できないリクエストは自動的にライブのGSC APIにフォールバックし、どちらのソースから取得したかも各レスポンスに示されます。

モデルに生のGSC APIを直接読ませればよいのでは?

多くのSearch Console MCPは、GSC APIを遅いバッチごとにページングし、生の行データをモデルのコンテキストにそのまま流し込みます。そのため遅く、サンプリングや行数の上限にかかり、ハルシネーションが起きる余地も残ります。GSC Wizardは各分析をサーバー側のSQLで計算し、完成した結果を返します。4 GBのデータセットに対する完全なSEOレポートが約4.4秒で完了します。

クライアントにツールが表示されません。どうすればよいですか?

多くのクライアントはMCPの設定を起動時にしか読み込まないため、設定を編集した後はクライアントを完全に再起動してください。そのうえで、キーが有効で無効化されていないこと、URLに/mcpのパスを付けていること、使いたいツールが読み取り専用キーでブロックされている書き込みツールではないことを確認してください。

通常のHTTPで使う方法はありますか?

はい。同じサーバーが、同じキー、スコープ、レート制限、監査ログを使うREST APIをhttps://mcp.gscwizard.com/v1で提供しています。/v1/openapi.jsonにあるOpenAPI 3.1ドキュメントは、サーバーが検証に使うスキーマと同じものから生成されています。

Search ConsoleのデータをあらゆるAIクライアントに接続する

エンドポイントは1つ、認証方法は2つ。生の行データではなく、完成した回答が返ります。約2分で設定できます。

Search Consoleのヒントをメールでお届け

GSCとGA4の実践的なワークフロー、製品のアップデート、SEOの実験をお届けします。スパムは送りません。いつでも配信を停止できます。