Search Console MCPのセットアップエラーと解決方法

コミュニティ製Google Search Console MCPサーバーのエラーの直し方。APIが無効、403の権限エラー、sc-domain、Access blocked、invalid_grant、spawn uvx ENOENT。

著者: Denis Veisllari

Google Search Console MCPのエラーのほとんどは、5つの場所から生じます。Google Cloudプロジェクト、Search Consoleのプロパティ、OAuth同意画面、認証情報ファイル、AIクライアントの設定です。下の一覧で表示されたエラーメッセージを探し、その手順だけを直してからクライアントを再起動してください。Google Cloudをまったく使わずに済ませたい場合は、Googleログインだけで済む方法を最後のセクションで紹介しています。

GoogleはSearch Consoleの公式MCPサーバーを公開していません。GoogleのMCPリポジトリはGoogle Analytics、BigQuery、Mapsなどを扱っていますが、Search Consoleは含まれていないため、インストールできるSearch Consoleサーバーはすべてコミュニティのプロジェクトです。最もよく使われているのはmcp-gsc(mcp-search-consoleとしてインストール)とmcp-server-gscの2つです。以下のエラーは両方に、そしてほかの多くのサーバーにも当てはまります。

エラー早見表

表示される内容考えられる原因参照先
"has not been used in project ... before or it is disabled"そのCloudプロジェクトでSearch Console APIがオフAPIが有効になっていない
403 "User does not have sufficient permission for site"サービスアカウントがプロパティに追加されていない、またはURL違い権限エラー
"is not a verified Search Console site in this account"ドメインプロパティとURLプレフィックスの混同プロパティの形式が違う
Search Consoleで "Failed to add user: email not found"新しいサービスアカウントに関するGoogleの不具合メールが見つからない
Google画面で "Access blocked" または "Error 403: access_denied"OAuthアプリがTesting中で、自分がテストユーザーではないOAuth画面のエラー
動いていたのに約1週間後に invalid_grantTestingモードのリフレッシュトークンは7日で失効動いていたのに止まった
"Error 400: redirect_uri_mismatch"デスクトップ用クライアントが必要な場面でWeb用クライアントを使用OAuth画面のエラー
"Service account credentials file not found"相対パス、またはパッケージ違い認証情報ファイル
spawn uvx ENOENT または spawn npx ENOENTクライアントがコマンドを見つけられないクライアントのエラー
ツールが表示されず、ログも書き出されないPython 3.11より古いクライアントのエラー
数値がSearch Consoleの画面と合わないデータの遅延、行数の上限、匿名化されたクエリ数値が合わない

APIが有効になっていない

エラーは403で、Google Search Console APIが "has not been used in project" というメッセージとプロジェクト番号が表示され、有効化のリンクが付いていることもよくあります。

APIは、OAuthクライアントやサービスアカウントを所有しているのと同じCloudプロジェクトで有効にする必要があります。よくある間違いは、別のプロジェクトで有効にしていることです。

  1. エラーに表示されたプロジェクト番号と、認証情報JSONのプロジェクトを比べます。
  2. Google Cloudでそのプロジェクトの APIs & Services > Library を開き、Google Search Console API を有効にします。
  3. 数分待ってから再試行します。Googleによると、新しい設定がシステムに反映されるまで少し時間がかかることがあります。

権限エラー

エラーは403の "User does not have sufficient permission for site" です。URL検査の場合は代わりに "The caller does not have permission" と表示されます。

サービスアカウントを作成しただけでは、Search Consoleへのアクセス権は付きません。そのメールアドレスを、問い合わせるプロパティそのものに追加する必要があります。

  1. サービスアカウントのJSONキーを開き、client_email の値をコピーします。
  2. Search Consoleで Settings > Users and permissions > Add user を開き、メールアドレスを貼り付けて「フル」権限を付与します。
  3. OAuthでログインする場合は、Search Consoleでそのプロパティがすでに見えているGoogleアカウントを使ってください。

アカウントにアクセス権があるのに403が出る場合は、プロパティの文字列が間違っている可能性が高いです。次のセクションをご覧ください。

プロパティの形式が違う

エラーは "'sc-domain:example.com' is not a verified Search Console site in this account"、または上と同じ403です。

Search Consoleのプロパティには2種類あり、APIは自分が持っている種類に合った正確な文字列を求めます。

  • ドメインプロパティ: sc-domain:example.com
  • URLプレフィックスプロパティ: プロトコルと末尾のスラッシュを含む完全なURL。例:https://www.example.com/

httpとhttpsは別のプロパティで、wwwありとなしも別です。推測はやめましょう。エージェントにサーバーのサイト一覧ツールを実行してもらい、返ってきたサイトURLをそのままコピーしてください。

Search Consoleでサービスアカウントのメールが見つからない

サービスアカウントをユーザーとして追加すると、Search Consoleが "Failed to add user: email not found." と返します。

これは新しく作成したサービスアカウントに関するGoogle側の問題で、あなたの操作ミスではありません。2026年4月ごろに最初に報告され、2026年9月に再発し、Google Analyticsにも影響しています。Googleは問題を認めていますが、修正時期は示していません。ユーザーからは3つの回避策が報告されています。

  • 数時間から1日待って、もう一度ユーザーを追加する。
  • Search Consoleの画面ではなく、APIでユーザーを追加する。
  • サーバーが対応していれば、サービスアカウントの代わりにOAuthを使う。

OAuth画面のエラー

"Access blocked" と "Error 403: access_denied"。 同意画面がTesting中で、ログインに使ったGoogleアカウントがテストユーザーになっていません。Google Cloudで Google Auth Platform > Audience > Test users を開き、自分のアドレスを追加してください。

"Google hasn't verified this app"。 確認を受けていないアプリがSearch Consoleへのアクセスを求めると表示されます。Cloudプロジェクトを自分で作成し、自分だけが使うなら、この警告を先へ進んで構いません。確認が必要になるのは、アプリをほかの人に使わせる場合だけです。

"Error 400: redirect_uri_mismatch"。 「Web application」タイプのOAuthクライアントを作成していますが、ローカルサーバーはランダムなポートのhttp://localhostのようなループバックアドレスでログインします。Desktop app タイプのOAuthクライアントを新しく作成し、そのJSONをダウンロードしてサーバーに指定してください。mcp-gscの場合は GSC_OAUTH_CLIENT_SECRETS_FILE の設定です。

動いていたのに1週間後に止まった

エラーは invalid_grant で、たいていは "Token has been expired or revoked." です。

外部アプリの同意画面がTesting中のままだと、Googleはリフレッシュトークンを7日で失効させます。アクセス権を取り消した場合や、6か月使わなかった場合もトークンは無効になります。

  1. Google Cloudで、同意画面の公開ステータスを In production にします。個人で使うだけなら未確認のままで構いません。
  2. サーバーが保存したトークンファイルを削除します。
  3. もう一度ログインします。

mcp-gscを使っている場合は、アップグレードもしてください。0.4.2より前のバージョンでは、読み取り専用トークンの更新に失敗し、トークンファイルを削除してしまうことがありました。

認証情報ファイルが見つからない

エラーは "Service account credentials file not found." です。

  • 相対パス。 uvxなどのツールはキャッシュフォルダからサーバーを起動するため、./key.json のようなパスはどこも指しません。クライアントの設定には完全なパスを書いてください。Windowsではバックスラッシュを2つ重ねます:C:\\Users\\you\\key.json
  • パッケージ違い。 mcp-gscを使うなら、PyPIにある無関係のmcp-gscパッケージではなくmcp-search-consoleをインストールします。最新版を使うため、uvx mcp-search-console@latestとして実行してください。
  • ファイルと設定の取り違え。 サービスアカウントのキーには"type": "service_account"とclient_emailが含まれます。OAuthクライアントのファイルはinstalledかwebのキーで始まります。それぞれ別の設定に指定します。mcp-gscでは前者がGSC_CREDENTIALS_PATH、後者がGSC_OAUTH_CLIENT_SECRETS_FILEで、mcp-server-gscはGOOGLE_APPLICATION_CREDENTIALSを使います。

クライアントがサーバーを起動できない

spawn uvx ENOENT または spawn npx ENOENT。 デスクトップアプリはターミナルのPATHを読み込まないため、コマンドを見つけられません。"command"に完全なパスを書いてください。パスはmacOSやLinuxならwhich uvx、Windowsならwhere uvxで確認できます。Windowsでnpxを使う場合は、"command": "cmd"と引数["/c", "npx", "-y", ...]を使います。

ツールもログファイルも出てこない。 mcp-gscにはPython 3.11以降が必要で、古いバージョンではエラーを出さずに失敗します。適切なPythonを選んでくれるuvx経由で実行するか、Python 3.12をインストールしてください。

設定を変えても何も変わらない。 JSONに末尾のカンマやエスケープされていないバックスラッシュがないか確認し、アプリを完全に終了してから開き直してください。Macではウィンドウを閉じるだけでは足りないので、Cmd+Qを使います。

ログの場所:

  • macOSのClaude Desktop: ~/Library/Logs/Claude。mcp.logに接続の失敗、mcp-server-<name>.logにそのサーバー自身のエラーが記録されます。
  • WindowsのClaude Desktop: %APPDATA%\Claude\logs
  • Claude Code: エラーを見るにはclaude mcp get <name>を実行するか、セッション内で/mcpを使います。
  • Cursor: Outputパネルを開き、MCP Logs を選びます。

もう1つの制限として、ローカルサーバーはデスクトップアプリとターミナルアプリでしか動きません。ブラウザのclaude.aiやChatGPTはリモートサーバーが必要なため、そこでは使えません。

数値が画面と合わない

これらはエラーではありませんが、「エージェントが間違えた」という報告の大半はこれが原因です。

  • 遅延。 Search Consoleのデータは通常2、3日後に届き、直近の数日分はまだ変わることがあります。確定データだけを取得するサーバーもあり、その場合は直近の数日が空に見えます。
  • 行数の上限。 1回のAPIリクエストで返るのは最大25,000行で、Googleが提供するのは検索タイプごとに1日最大50,000行です。大規模サイトでは、ロングテールのクエリが切り捨てられます。
  • 表示されないクエリ。 まれなクエリや個人的なクエリは除外されるため、クエリ別の行を合計しても総クリック数にはなりません。正確な合計が必要なら、クエリやページのディメンションなしでデータを取得してください。
  • 合計の違い。 グラフはプロパティ単位、表はページ単位で集計するため、両者が異なることがあります。期間も確認してください。時間別データは太平洋時間です。
  • 割り当て上限。 URL検査は1サイトにつき1日2,000回までなので、大規模サイトでまとめて検査すると途中で止まります。Search Analyticsは1サイトにつき1分あたり1,200クエリまでです。

Google Cloudをまったく使わない方法

最後のセクションを除き、上のエラーはすべて自分のGoogle Cloudプロジェクトを運用することから生じます。zaDojoのGoogle Search Console MCPはホスティング済みです。zaDojoのプロジェクトで通常のGoogleログインによってSearch Consoleを接続すれば、エージェントはhttps://app.zadojo.com/mcpからデータを読み取れます。Cloudプロジェクトも、APIの有効化も、サービスアカウントも、同意画面も、認証情報ファイルも不要で、デスクトップのクライアントに加えてclaude.aiとChatGPTでも使えます。

Search Consoleの読み取り、URL検査、インデックス登録状況は、カード登録不要のzaDojoのFreeプランで無料です。Google Analyticsの読み取りと50ページまでのサイト監査も同様です。キーワード、競合、AI可視性のデータにはクレジットを使います。ほかの無料の選択肢との比較は無料SEO MCPサーバーをご覧ください。

よくある質問

Google Search Consoleの公式MCPサーバーはありますか? ありません。GoogleはGoogle Analyticsなどの製品向けにMCPサーバーを公開していますが、Search Console向けは公開していません。Search Consoleのサーバーはすべて、コミュニティのプロジェクトかホスティング型のサービスです。

サービスアカウントとOAuthのどちらを使うべきですか? サービスアカウントは無人で動くサーバーに向いていますが、すべてのプロパティにそのメールアドレスを追加する必要があります。OAuthは自分のGoogleアカウントを使い、すでにアクセスできるすべてのプロパティが見えますが、Testingモードのままだと、In productionに切り替えるまで7日ごとにログインし直す必要があります。

エージェントに一部のサイトしか見えないのはなぜですか? エージェントが使うアカウントやサービスアカウントは、追加されたプロパティしか見られません。エージェントにサイト一覧を出してもらい、Search Consoleの一覧と比べてください。

Search Console MCPサーバーがサイトを変更することはありますか? ありません。これらのサーバーはSearch Consoleのデータを読み取り、管理するだけです。ページを編集するものはありません。