Google Search Console

1. Google Cloud Console で、API とサービス → 認証情報 → 認証情報を作成 → サービス アカウントに移動します。名前を付けて作成を完了します。省略可能なロールとアクセスの手順はスキップできます。
2. サービス アカウントを開き、鍵 → 鍵を追加 → 新しい鍵を作成 → JSON の順に選択して、鍵をダウンロードします。
3. Search Console で、各プロパティの設定 → ユーザーと権限 → ユーザーを追加を開きます。サービス アカウントのメールアドレスを追加し、アクセス権を制限付きに設定します。

注意

鍵はリポジトリの外に保管し、絶対にコミットしないでください。以下のクライアント設定では、絶対パスを使用してください。

Search Console で「Failed to add user: email not found」というエラーが表示され、メールアドレスが拒否される場合は、自分のアカウントでログインしてください。トラブルシューティングを参照してください。

サーバーは、ローカル ADC より先に GOOGLE_APPLICATION_CREDENTIALS を確認します。ADC に切り替える場合は、クライアント設定と環境から古い鍵のパス設定を削除してください。

git clone https://github.com/sarahpark/google-search-console-mcp.git
cd google-search-console-mcp
npm install
npm run build

以下のクライアント用コマンドでは、npx -y @sarahpark/[email protected] を node "/absolute/path/to/google-search-console-mcp/build/index.js" に置き換えてください。Claude Desktop では、command に node を設定し、args にその絶対パスを含む配列を設定します。オフラインでの認証チェックを実行するには npm test を実行してください。

認証を完了したら、次の内容をエージェントに貼り付けてください。

既存のサーバーを保持したまま、このクライアントのユーザーレベルの MCP 設定で、npx -y @sarahpark/[email protected] を gsc として追加してください。ローカルの Application Default Credentials を使用してください。セットアップが完了したことと、クライアントの再起動が必要かどうかを教えてください。

サービス アカウントを使用する場合は、「ローカルの Application Default Credentials を使用してください」を「GOOGLE_APPLICATION_CREDENTIALS に /path/to/service-account-key.json を設定してください」に置き換え、実際のファイルの場所を指定してください。

設定が完了したら、手順 5 に進んでください。

自分としてサインイン（ADC）：

codex mcp add gsc -- npx -y @sarahpark/[email protected]

サービスアカウントを使用した npm パッケージ：

codex mcp add gsc \
  --env "GOOGLE_APPLICATION_CREDENTIALS=/absolute/path/to/service-account-key.json" \
  -- npx -y @sarahpark/[email protected]

~/.codex/config.toml で手動設定する方法については、Codex MCP のドキュメントを参照してください。

自分としてサインイン（ADC）：

claude mcp add gsc --scope user -- npx -y @sarahpark/[email protected]

サービスアカウントを使用した npm パッケージ：

claude mcp add gsc --scope user \
  --env "GOOGLE_APPLICATION_CREDENTIALS=/absolute/path/to/service-account-key.json" \
  -- npx -y @sarahpark/[email protected]

--scope user を指定すると、すべてのプロジェクトでサーバーを利用できます。代わりに --scope project を指定すると、プロジェクトの .mcp.json を通じて設定を共有できます。

適切なエントリを claude_desktop_config.json に追加し、既存の mcpServers オブジェクトがある場合は、その中に統合してください。

自分としてサインイン（ADC）：

{
  "mcpServers": {
    "gsc": {
      "command": "npx",
      "args": ["-y", "@sarahpark/[email protected]"]
    }
  }
}

サービスアカウントを使用した npm パッケージ：

{
  "mcpServers": {
    "gsc": {
      "command": "npx",
      "args": ["-y", "@sarahpark/[email protected]"],
      "env": {
        "GOOGLE_APPLICATION_CREDENTIALS": "/absolute/path/to/service-account-key.json"
      }
    }
  }
}

Google Search Console でアクセスできるすべてのサイト（プロパティ）を一覧表示します。

パラメーターは不要です。

クリック数、表示回数、CTR、掲載順位などの検索アナリティクスデータをクエリします。

URL のインデックス登録状況、クロール情報、モバイルユーザビリティを確認します。

サイトに送信されたすべてのサイトマップと、そのステータスを一覧表示します。

エラーに API が「割り当てプロジェクトを必要とする」と表示される場合は、次を再実行してください。

gcloud auth application-default set-quota-project YOUR_PROJECT_ID

ご利用のアカウントには、そのプロジェクトに対する serviceusage.services.use 権限が必要です。権限が拒否された場合は、プロジェクト管理者に付与を依頼するか、Search Console API が有効になっている、権限を持つプロジェクトを使用してください。

ログイン時には、設定済みのプロジェクトが自動的に割り当てられますが、権限がない場合は割り当てが省略されることがあります。プロジェクトを明示的に設定すると、その失敗が分かるようになります。セットアップコマンドの cloud-platform スコープにより、割り当てプロジェクトを指定できます。

組み込みの gcloud クライアントでは、Google Cloud SDK 557.0.0 で webmasters.readonly を付与できることが確認されています。ご利用のバージョンで動作しない場合は、追加のスコープに関する gcloud のガイダンスに従って独自の OAuth クライアントを作成し、ダウンロードしたクライアントファイルを使ってログインしてください。

gcloud auth application-default login \
  --client-id-file=client_id.json \
  --scopes=https://www.googleapis.com/auth/webmasters.readonly,https://www.googleapis.com/auth/cloud-platform
gcloud auth application-default set-quota-project YOUR_PROJECT_ID

認証情報ファイルはリポジトリの外に保管してください。

新しく作成したサービスアカウントの追加時にこの問題が報告されており、ADC オプションを設けるきっかけとなりました。ご自身のアカウントでログインするか、すでにプロパティへのアクセス権を持つ既存のサービスアカウントを使用してください。

• npm 1.0.1 以前を使用している場合： ローカルの gcloud ADC を使うため、クライアントコマンドをバージョン 1.1.0 以降に更新してください。
• ADC を使用している場合： 古い GOOGLE_APPLICATION_CREDENTIALS の設定がログイン情報を上書きしていないことを確認してください。ログイン中の Google アカウントには、プロパティへのアクセス権が必要です。
• サービスアカウントを使用している場合： GOOGLE_APPLICATION_CREDENTIALS に鍵の絶対パスを設定し、読み取りたい各プロパティにそのメールアドレスが追加されていることを確認してください。