GSCをGeminiに接続

Google Search ConsoleのデータをGeminiに接続するには?

Geminiは、他のすべてのアシスタントと同じMCPエンドポイントを通じてSearch Consoleのデータを読み取ります。mcp.gscwizard.comを、Geminiアプリ(米国、個人アカウント)、Antigravity CLI、Gemini Enterprise、Gemini APIに貼り付ければ、Geminiは実際のクリック数、表示回数、掲載順位、CTRをもとに作業します。

エンドポイント:https://mcp.gscwizard.com/mcp

簡単な答え

お使いのGeminiの環境に、GSC Wizard MCPサーバーを追加します。

  1. Geminiアプリ:設定 → 接続済みアプリ → カスタムアプリを追加から、https://mcp.gscwizard.com/mcpを貼り付けます。Googleは、個人のGoogleアカウントを持つ米国の成人にこの機能を提供しています。
  2. Antigravity CLI(個人アカウント向けのGemini CLIの後継):mcp_config.jsonにserverUrlのエントリを1つ追加します。
  3. Gemini Enterprise:OAuth 2.0でカスタムMCPサーバーを追加します。APIキーは使えません。
  4. Gemini API:Google Gen AI SDKでMCPクライアントセッションをtoolsに渡すか、/v1のRESTインターフェースを直接呼び出します。

どれが使えるかわからない場合は、下の表で各方法の対象者を確認してください。

使えるGeminiの方法はどれか

どの環境を誰に提供するかを決めるのはGoogleであり、GSC Wizardではありません。以下の要件はGoogle自身のヘルプページに基づいています。

方法利用できる人ログインセットアップ
Geminiアプリ米国在住の成人(18歳以上)、個人のGoogleアカウント、英語、アクティビティの保存がオン。仕事用・学校用アカウントは対象外。OAuthで自動。コピーするキーはありません。URLを1つ貼り付けるだけ。約1分。
Antigravity CLIとIDE開発者、地域を問わず。Gemini CLI自体は現在、エンタープライズと有料のAPIキーのユーザーのみが対象です。APIキーのヘッダー、またはOAuth。JSONのエントリを1つ。
Gemini Enterprise組織向け。チーム管理者またはクラウド管理者がサーバーを追加します。OAuth 2.0のみ。APIキーは使えません。OAuthクライアントを作成し、コネクタのフォームに入力します。
Gemini API独自のエージェントを構築する開発者。APIキーのヘッダー。Gen AI SDKで数行。
動画

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

Geminiが接続するのと同じMCPサーバーの解説動画です。追加、認証、そして普通の言葉で実際のSearch Console分析を依頼するまでを紹介します。

オプション1:最も簡単

Geminiアプリ

Geminiでは、独自のMCPサーバーをカスタムアプリとして追加できるようになりました。GSC Wizardは動的クライアント登録に対応しているため、Gemini側が自分自身を登録し、コピーするAPIキーやクライアントシークレットはありません。

Googleがお使いの環境で提供しているか確認する

Googleのカスタムアプリ向けヘルプページによると、18歳以上で米国にお住まいであること、個人のGoogleアカウントでログインしていること(仕事用・学校用アカウントは現時点では非対応)、Geminiを英語で使っていること、アクティビティの保存がオンになっていることが必要です。アプリはgemini.google.comのウェブアプリで追加すると、モバイルアプリでも使えるようになります。カスタムアプリを追加が表示されない場合は、これらの条件のいずれかが満たされていません。その場合は、下で紹介するAntigravity CLI、Gemini Enterprise、APIのいずれかを使ってください。

  1. 1

    GSC Wizardでプロパティを接続する

    Search Consoleプロパティへのアクセス権を持つGoogleアカウントで、tool.gscwizard.comにログインします。Geminiが読み取るのは、そこで接続したプロパティだけです。

  2. 2

    Geminiでカスタムアプリを追加する

    パソコンでgemini.google.comを開き、下部の設定をクリックして、接続済みアプリを開きます。カスタムアプリの下でカスタムアプリを追加をクリックし、https://mcp.gscwizard.com/mcpを入力します。末尾の/mcpは必ず付けてください。ドメインだけではMCPリクエストに応答しません。

  3. 3

    ログインして承認する

    次へをクリックして、手順に従います。GeminiからGSC Wizardのログイン画面と同意画面に移動します。詳細機能の認証情報は空欄のままで構いません。クライアントを自動登録できないサーバー向けの項目だからです。

  4. 4

    @で質問する

    新しいチャットで@を入力し、GSC Wizardアプリを選んで、「過去28日間でクリック数が最も減ったexample.comのページはどれ?」のように質問します。書き込み操作を行う前には、Geminiが確認を求めます。

Googleは、サードパーティのMCPサーバーを管理、監視、保護していないこと、またGeminiがチャットの内容を接続済みのアプリと共有する場合があることを注記しています。GSC Wizardが返すのは、ご自身のアカウントに接続したSearch Console、GA4、Bingのデータだけです。アプリは設定 → 接続済みアプリでいつでもオフにしたり、連携を解除したり、削除したりできます。

オプション2:開発者向け

Antigravity CLIとIDE

AntigravityはGoogleのエージェント環境で、個人アカウント向けのGemini CLIの後継です。リモートMCPサーバーをJSONファイルから読み込み、MCP側に米国限定の制限はなく、Antigravityが動作する場所ならどこでも使えます。

  1. 1

    GSC WizardでAPIキーを作成する

    tool.gscwizard.comにログインしてSearch Consoleプロパティを接続し、アカウント → APIキーでキーを作成します。保存したキーではなくOAuthを使いたい場合は、この手順を省略して、設定例の下にある注記をご覧ください。

  2. 2

    サーバーをmcp_config.jsonに追加する

    すべてのプロジェクトに適用するには~/.gemini/config/mcp_config.jsonを、リポジトリ内に限定するにはその中の.agents/mcp_config.jsonを編集します。リモートサーバーにはserverUrlキーを使います。Googleのドキュメントでは、従来のurlキーとhttpUrlキーはここでは非対応とされています。

  3. 3

    確認して質問する

    プロンプトパネルで/mcpと入力すると、サーバーが接続されていることとそのツールを確認できます。その後は、普通の言葉でサイトについて質問してください。

~/.gemini/config/mcp_config.json

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

キーを保存せずログインで認証するには、headersブロックを省きます。GSC Wizardは動的クライアント登録に対応しているため、エージェント設定 → カスタマイズでサーバーの横にある認証をクリックすると、AntigravityがOAuthフローを実行します。

まだGemini CLIを使っていますか?

Googleは2026年6月18日に、無料、Google AI Pro、Ultraの個人アカウント向けのGemini CLIの提供を終了し、これらのユーザーにはAntigravity CLIを案内しています。エンタープライズのお客様と有料のAPIキーのユーザーは引き続きGemini CLIを使え、その場合はBearerヘッダーを付けてエンドポイントを追加できます。

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

または、~/.gemini/settings.jsonに"httpUrl": "https://mcp.gscwizard.com/mcp"のエントリと、同じheadersオブジェクトを追加します。キーを直接貼り付けず$GSCW_KEYのような環境変数を参照すれば、ソース管理にキーが残りません。

オプション3:組織向け

Gemini Enterprise

Gemini Enterpriseはカスタムのコネクタ用MCPサーバーに対応しているため、管理者が組織全体のエージェントにSearch Consoleのデータを提供できます。Googleがこれらのサーバーについて記載しているログイン方法は、認証なしとOAuth 2.0の2つだけで、固定のAPIキーヘッダーはここでは使えません。GSC Wizardは、ご自身で作成するクライアントを使ったOAuth 2.0で接続します。

  1. 1

    Gemini Enterprise用のOAuthクライアントを作成する

    Gemini Enterpriseは常にユーザーをhttps://vertexaisearch.cloud.google.com/oauth-redirectに戻すため、そのリダイレクトURL用のクライアントを登録します。レスポンスにはクライアントID(gscwc_で始まります)と、一度しか表示されないクライアントシークレットが含まれるので、次に進む前に保存してください。

  2. 2

    カスタムMCPサーバーのフォームを開く

    Businessエディションでは、business.gemini.googleにログインして設定とヘルプを開き、チームを選んでチームを管理 → 接続済みアプリ → MCPサーバーを追加を選びます。Google Cloudコンソールの場合は、Gemini Enterpriseを開き、データストア → データストアを作成に進んで、Custom MCP Serverを検索し、MCPサーバーを追加をクリックします。

  3. 3

    OAuth 2.0の値を入力する

    OAuth 2.0を選び、下の表のとおり入力して、認証を確認をクリックします。その後、ロケーションを選び、コネクタに名前を付けて作成します。

  4. 4

    コネクタとそのツールをオンにする

    Googleでは、新しいカスタムMCP接続は最初オフになっています。Businessエディションでは、コネクタページで接続を有効にします。Cloudコンソールでは、データストアを開いてアクション → カスタムアクションを再読み込みを選び、使いたいツールを選択してアクションを有効にするをクリックします。

ステップ1:クライアントを登録する

curl -X POST https://tool.gscwizard.com/api/oauth/register \
  -H "Content-Type: application/json" \
  -d '{
    "client_name": "Gemini Enterprise",
    "redirect_uris": ["https://vertexaisearch.cloud.google.com/oauth-redirect"],
    "token_endpoint_auth_method": "client_secret_post",
    "grant_types": ["authorization_code", "refresh_token"]
  }'

ステップ3:値

Gemini Enterpriseの項目値
MCPサーバーURLhttps://mcp.gscwizard.com/mcp
認証OAuth 2.0
認可URLhttps://tool.gscwizard.com/oauth/authorize
トークンURLhttps://tool.gscwizard.com/api/oauth/token
クライアントIDとシークレットステップ1のレスポンスの値(gscwc_とシークレット)
スコープ読み取り専用ならmcp:read、それ以外はmcp:read mcp:write
PKCEフォームに選択肢がある場合はオンにします。GSC Wizardの認可サーバーはPKCEを必須としています

認可URLには/api/が含まれず、トークンURLには含まれますが、どちらも正しい値です。Cloudコンソール経由の場合、管理者はさらに、Discovery Engine編集者のロールが必要で、カスタムMCPデータストアをデフォルトでブロックする組織ポリシーを上書きし、ドメインmcp.gscwizard.comとtool.gscwizard.comを許可する必要があります。どちらの経路についても、Googleのセットアップページで説明されています:CloudコンソールのガイドとBusinessエディションのガイド。

オプション4:開発者向け

Gemini APIと独自のエージェント

チャットではなくエージェントを作る場合、Google Gen AI SDKならMCPクライアントセッションをそのままツールのリストに渡せるため、GeminiがGSC Wizardのツールを直接呼び出します。

Python:MCPセッションを使うgoogle-genai

from google import genai
from mcp import ClientSession
from mcp.client.streamable_http import streamablehttp_client

URL = "https://mcp.gscwizard.com/mcp"
HEADERS = {"Authorization": "Bearer gscw_live_..."}
MODEL = "gemini-3.1-pro"  # or whichever Gemini model you use

async with streamablehttp_client(URL, headers=HEADERS) as (read, write, _):
    async with ClientSession(read, write) as session:
        await session.initialize()
        response = await genai.Client().aio.models.generate_content(
            model=MODEL,
            contents="Which pages on example.com lost the most clicks in the last 28 days?",
            config=genai.types.GenerateContentConfig(tools=[session]),
        )
        print(response.text)

MCPをまったく使いたくない場合も、同じキー、スコープ、レート制限で、https://mcp.gscwizard.com/v1のシンプルなRESTインターフェースを利用できます。自動生成されたOpenAPI 3.1ドキュメントが/v1/openapi.jsonにあり、関数呼び出しの仕様としてGeminiに渡せます。

米国外の場合や、仕事用アカウントの場合は?

Googleは現在、Geminiアプリのカスタムアプリを、個人のGoogleアカウントを持つ米国の成人にのみ提供しているため、このオプションが表示されない場合があります。Antigravity CLI、Gemini Enterprise、Gemini APIはこの制限の対象外です。同僚に数値を渡したいだけなら、GSC Wizardの共有レポートのリンクやCSVエクスポートがどのチャットでも使えます。

Windsor.aiやSupermetricsなどのコネクタプラットフォーム

Search Consoleの接続方法をGeminiに尋ねると、Windsor.aiやSupermetricsといったデータコネクタのプラットフォームが挙がることがよくあります。これらは別の課題を解決するものなので、何が必要かによって選択が変わります。

コネクタプラットフォームが向いているのは次の場合

  • Search Consoleが、すでに1か所に集約している十数個の広告・マーケティングデータソースの1つにすぎない。
  • 広告プラットフォーム、アナリティクス、Search Consoleを横断した統合レポートが欲しい。
  • チームがスプレッドシートやBIツールを中心に動いていて、Geminiは補助的な位置づけ。

GSC Wizardが向いているのは次の場合

  • 生の行だけでなく、劣化、カニバリゼーション、CTR曲線、機会のスコアリングといったSEO分析が欲しい。
  • Search Consoleの全データセットを対象に分析をサーバー側で実行し、Geminiには完成した結果を読ませたい。
  • ChatGPT、Claude、Grok、Copilot Studioでも使える、1つのMCP URLが欲しい。

レポートやパイプラインのツールを並べて比較するには、おすすめのSEOレポートツールのまとめと、Search Consoleデータ向けコネクタのガイドをご覧ください。

普段の言葉で質問し、完成した回答を受け取る

接続後に質問できること

すべての分析はデータウェアハウスに対してサーバー側で実行されるため、アシスタントは生の行で計算するのではなく、完成した結果を読み取ります。

「example.comのパフォーマンスの概要を教えて」 「今月の上位のクエリとページは?」 「先月と比べて順位が上がったクエリと下がったクエリは?」 「劣化しているページを見つけて」 「キーワードのカニバリゼーションが起きているのはどこ?」 「CTRと掲載順位の曲線を見せて」 「完全なSEOレポートを作成して」 「https://example.com/pricingをGoogleで検査して」 「1ページ目まであと少しのページはどれ?」 「これらのURLをIndexNowに送信して」
同じデータを、ほかのアシスタントでも

別の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サーバーのまとめ記事、そして2026年版のSearch ConsoleデータのためのChatGPTコネクタガイドもご覧ください。

よくある質問

GeminiアプリはGoogle Search Consoleに接続できますか?

はい、Googleの要件を満たしていれば可能です。18歳以上で米国にお住まいであること、個人のGoogleアカウント(仕事用・学校用アカウントは不可)でログインしていること、英語を使っていること、アクティビティの保存がオンになっていることが条件です。gemini.google.comを開き、設定、接続済みアプリの順に進み、カスタムアプリを追加をクリックして、https://mcp.gscwizard.com/mcp を入力します。Geminiがサーバーに自分自身を登録し、GSC Wizardのログイン画面に移動します。これらの要件を満たさない場合は、Antigravity CLI、Gemini Enterprise、Gemini APIを使ってください。

Geminiアプリに「カスタムアプリを追加」が表示されないのはなぜですか?

Googleは現在、カスタムアプリを、米国の成人で、個人のGoogleアカウントを使い、英語で、アクティビティの保存がオンの場合にのみ提供しています。追加はgemini.google.comのウェブアプリで行います。米国外にお住まいの場合や、仕事用・学校用アカウントの場合は、このオプションは表示されません。代わりにAntigravity CLI、Gemini Enterprise、Gemini APIを使ってください。

Gemini EnterpriseはAPIキーに対応していますか?

いいえ。GoogleはGemini EnterpriseのカスタムMCPサーバーの認証方法として、認証なしとOAuth 2.0の2つを挙げており、どちらも固定のAuthorizationヘッダーには対応していません。Gemini EnterpriseのリダイレクトURL用に作成したクライアントIDとシークレットを使い、OAuth 2.0でGSC Wizardを接続してください。

Antigravity CLIは、認証付きのリモートMCPサーバーに対応していますか?

はい。serverUrlとheadersオブジェクトを含むエントリを~/.gemini/config/mcp_config.json(プロジェクト内なら.agents/mcp_config.json)に追加します。GSC Wizardのように動的クライアント登録に対応したサーバーでは、headersを省き、代わりにエージェント設定からOAuthで認証できます。

Gemini CLIはまだ使えますか?

一部のアカウントのみです。Googleは2026年6月18日に、無料、Google AI Pro、Ultraの個人アカウント向けのGemini CLIの提供を終了し、これらのユーザーにはAntigravity CLIを案内しています。Gemini CLIはエンタープライズのお客様と有料のAPIキーのユーザーには引き続き使え、その場合は--transport httpと--headerを付けたgemini mcp addでGSC Wizardを登録できます。

データはSearch Consoleのエクスポートのようにサンプリングされたり、上限が付いたりしますか?

いいえ。データはすべての行を保持するClickHouseウェアハウスから提供されるため、エクスポートの行数上限もGSC APIのページングもありません。ウェアハウスは約2日遅れで、各レスポンスには、データが確定している日付が含まれます。

接続すると、Geminiは何ができますか?

MCPが提供するすべてのことが可能です。検索アナリティクス、上位のクエリとページ、順位変動、劣化とカニバリゼーション、CTR曲線、機会のスコアリング、URLの一括検査、インデックス登録の追跡、IndexNowの送信、Bing Webmasterのデータ、GA4の指標、完全なSEOレポートなどです。

費用はかかりますか?

APIキーはすべてのGSC Wizardアカウントで無料で、無料プランではGSC API経由で動作します。サブスクライバーは、ウェアハウスを使った高速なクエリを利用でき、これによって全データセットの分析が現実的になります。詳細は料金ページをご覧ください。

Geminiを、Search Consoleのデータにつなぎましょう

無料のAPIキーを作成し、Geminiの設定にエントリを1つ追加して、普通の言葉でサイトについて質問してください。

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

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