SEO向けGoogle Search Console MCPサーバー

Google Search Console(GSC)をAIアシスタントに接続するModel Context Protocol (MCP)サーバーです。自然言語での会話を通じてSEOデータを分析できます。Claude Desktop、Cursor、Codex CLI、Gemini CLI、Antigravity、その他MCP互換クライアントで動作します。

セットアップ不要で、より高機能に。 より高度なホスト型バージョン — ワンクリックサインイン、GA4ツール追加。Claude Desktop、Claude Code、Claude.ai、Codex、Cursor、その他MCPクライアントで動作します。わずか100席。 → Advanced GSC MCP(ホスト型)

新着情報

[0.3.3] — 2026年7月

• mcp 2.0による新規インストールの破損を修正 — mcp[cli]<2.0.0に固定しました。mcp SDK 2.0.0(2026年7月28日リリース)はmcp.server.fastmcpモジュールを削除したため、新規のuvx mcp-search-consoleインストールはすべて起動時にModuleNotFoundError: No module named 'mcp.server.fastmcp'でクラッシュしていました。新規インストールは再び動作する1.x SDKを解決するようになりました — --with "mcp<2"の回避策は不要です。

[0.3.2] — 2026年4月

• uvxでのOAuthブラウザフローを修正 — macOSでMCPサブプロセスとして実行した際にブラウザのログインウィンドウが開かない原因となっていたisattyブロックを削除しました。OAuthはuvxでそのまま動作し、手動でのターミナル実行は不要になりました。

• get_capabilitiesツールを追加 — これを呼び出すと、利用可能な全ツールと現在の認証ステータスを一括で確認できます。AIアシスタントが利用可能なツールを把握していない場合に便利です。

• 認証エラーメッセージを改善 — すべてのツールで、認証情報が欠落または期限切れの場合に何をすべきか正確に指示するようになりました。

Related MCP server: Google Search Console MCP Server

できること

プロパティ管理

• GSCプロパティを一覧表示

• 検証詳細と所有権情報を取得

• アカウントへのプロパティ追加・削除

検索アナリティクスとレポート

• サイトへの訪問者をもたらすクエリを特定

• インプレッション、クリック数、クリック率を追跡

• パフォーマンストレンドの分析と期間比較

• AIアシスタントが作成するチャートでデータを可視化

URL検査とインデックス

• 特定のページにインデックス問題がないか確認

• Googleが最後にページをクロールした日時を確認

• 複数のURLを一度に検査してパターンを特定

サイトマップ管理

• すべてのサイトマップとそのステータスを表示

• 新しいサイトマップを送信

• エラーや警告を確認

利用可能なツール

AIアシスタントに「get_capabilitiesを呼び出して」と依頼すると、全20ツールの完全なリストが表示されます。

はじめに

ステップ1 — Google API認証情報の設定

クライアントを設定する前に認証情報が必要です。次のいずれかの方法を選択してください:

オプションA — OAuth(推奨 — 自分のGoogleアカウントを使用)

1. Google Cloud Consoleに移動し、プロジェクトを作成または選択

2. Search Console APIを有効化

3. 認証情報 → 認証情報を作成 → OAuthクライアントID に移動

4. OAuth同意画面を設定し、デスクトップアプリを選択して、作成をクリック

5. JSONファイルをダウンロード — 恒久的な場所に保存(例: ~/Documents/client_secrets.json)

初回使用時にブラウザウィンドウが開き、Googleアカウントへのサインインが求められます。以降はトークンが保存され、ブラウザ操作は不要です。

オプションB — サービスアカウント(自動化またはチーム利用向け)

1. Google Cloud Consoleに移動し、プロジェクトを作成または選択

2. Search Console APIを有効化

3. 認証情報 → 認証情報を作成 → サービスアカウント に移動

4. 「キー」タブ → 鍵を追加 → 新しい鍵を作成 → JSON → ダウンロード に移動

5. ファイルを恒久的な場所に保存(例: ~/Documents/service_account.json)

6. サービスアカウントのメールアドレスをGSCプロパティに追加: Search Console → 設定 → ユーザーと権限 → ユーザーを追加 → フルアクセス

🎥 このセクションのステップバイステップ設定チュートリアルを見る

2026年更新 — Google認証情報の設定から最初のクエリ成功まで、新しいuvxメソッドを使用した完全なインストールプロセスを解説しています。

ステップ2 — インストール

オプションA — uvx(推奨)

クローン不要、Pythonインストール不要、仮想環境不要。uvxがサーバーを自動的にダウンロードして実行し、最新の状態に保ちます。

uvをインストール — ターミナルを開き、次の3つのコマンドを順番に実行します:

# 1. Download and install
curl -LsSf https://astral.sh/uv/install.sh | sh

# 2. Activate in the current Terminal session
source $HOME/.local/bin/env

# 3. Make it permanent for all future sessions
echo 'source $HOME/.local/bin/env' >> ~/.zshrc

確認:

uv --version

なぜ3つのコマンドすべてが必要なのか? インストーラーはuvを~/.local/binに配置しますが、開いているターミナルセッションはそのフォルダーをまだ認識していません。ステップ2で即座に有効化します。ステップ3で、将来開くすべてのターミナルウィンドウで自動的に利用できるようにします。

次にAIクライアントを設定します:

Claude Desktop

設定ファイル: ~/Library/Application Support/Claude/claude_desktop_config.json

OAuth:

{
  "mcpServers": {
    "gscServer": {
      "command": "/FULL/PATH/TO/uvx",
      "args": ["mcp-search-console"],
      "env": {
        "GSC_OAUTH_CLIENT_SECRETS_FILE": "/full/path/to/client_secrets.json"
      }
    }
  }
}

サービスアカウント:

{
  "mcpServers": {
    "gscServer": {
      "command": "/FULL/PATH/TO/uvx",
      "args": ["mcp-search-console"],
      "env": {
        "GSC_CREDENTIALS_PATH": "/full/path/to/service_account.json",
        "GSC_SKIP_OAUTH": "true"
      }
    }
  }
}

Cursor

設定ファイル: ~/.cursor/mcp.json

OAuth:

{
  "mcpServers": {
    "gscServer": {
      "command": "/FULL/PATH/TO/uvx",
      "args": ["mcp-search-console"],
      "env": {
        "GSC_OAUTH_CLIENT_SECRETS_FILE": "/full/path/to/client_secrets.json"
      }
    }
  }
}

Codex CLI

設定ファイル: ~/.codex/config.toml

OAuth:

[mcp_servers.gscServer]
command = "/FULL/PATH/TO/uvx"
args = ["mcp-search-console"]
enabled = true
env = { GSC_OAUTH_CLIENT_SECRETS_FILE = "/full/path/to/client_secrets.json" }

サービスアカウント:

[mcp_servers.gscServer]
command = "/FULL/PATH/TO/uvx"
args = ["mcp-search-console"]
enabled = true
env = { GSC_CREDENTIALS_PATH = "/full/path/to/service_account.json", GSC_SKIP_OAUTH = "true" }

uvxパスの確認方法: macOS/Linuxでは、uvインストール後にターミナルでwhich uvxを実行します(通常は/Users/YOUR_NAME/.local/bin/uvx)。Windowsでは、PowerShellでGet-Command uvx | Select-Object -ExpandProperty Source(またはcmdでwhere uvx)を実行します — 通常はC:\Users\YOUR_NAME\.local\bin\uvx.exeです。上記の設定の/FULL/PATH/TO/uvxをそのパスに置き換えてください。

なぜフルパスが必要なのか? Claude DesktopやCursorなどのGUIアプリはシェル設定(~/.zshrc)を読み込まずに起動するため、~/.local/binを認識しません。フルパスを使用することで、アプリの起動方法に関係なく確実に動作します。spawn uvx ENOENTエラーが表示された場合は、これが修正方法です。

設定を保存したら、アプリを完全に終了(Cmd+Q)して再度開きます。

OAuthの場合: 初回使用時にブラウザウィンドウが自動的に開きログインします。以降はトークンがキャッシュされ、再度求められることはありません。

オプションB — クローン(上級者向け)

この方法のビデオチュートリアルをご希望ですか? 以下のチュートリアルでは、クローンインストールの手順をステップバイステップで解説しています — 仮想環境のセットアップ、依存関係、設定:

コードを変更したい場合や、特定のローカルバージョンを実行したい場合に使用します。この方法では、認証情報の設定手順に上記のビデオチュートリアルを使用します。

Python 3.11以上が必要です。 このサーバーはPython 3.10以前では起動しません — また、Claude DesktopなどのGUIクライアントから起動された場合、サイレントに失敗します(ツールが表示されず、ログファイルも書き込まれません)。python --versionでバージョンを確認してください。3.11未満の場合は、Python 3.11以降をインストールし、仮想環境を作り直してください。uvxメソッド(オプションA)はPythonバージョンを自動管理するためこの問題を完全に回避でき、Windowsでは推奨パスです。

リポジトリをクローン:

git clone https://github.com/AminForou/mcp-gsc.git
cd mcp-gsc

または、このページ上部の緑色のCodeボタンからZIPをダウンロードして解凍します。

環境をセットアップ:

uv venv .venv
uv pip install -r requirements.txt

AIクライアントを設定(Claude Desktopの例):

OAuth:

{
  "mcpServers": {
    "gscServer": {
      "command": "/full/path/to/mcp-gsc/.venv/bin/python",
      "args": ["/full/path/to/mcp-gsc/gsc_server.py"],
      "env": {
        "GSC_OAUTH_CLIENT_SECRETS_FILE": "/full/path/to/client_secrets.json"
      }
    }
  }
}

サービスアカウント:

{
  "mcpServers": {
    "gscServer": {
      "command": "/full/path/to/mcp-gsc/.venv/bin/python",
      "args": ["/full/path/to/mcp-gsc/gsc_server.py"],
      "env": {
        "GSC_CREDENTIALS_PATH": "/full/path/to/service_account.json",
        "GSC_SKIP_OAUTH": "true"
      }
    }
  }
}

Macのパス例:

• Python: /Users/yourname/Documents/mcp-gsc/.venv/bin/python

• スクリプト: /Users/yourname/Documents/mcp-gsc/gsc_server.py

ステップ3 — テスト

AIアシスタントに次のように尋ねます: 「GSCプロパティを一覧表示して」

プロパティが表示されれば成功です。表示されない場合は、「get_capabilitiesを呼び出して」 と尋ねて認証ステータスを確認し、問題を診断してください。

環境変数リファレンス

Cursorマーケットプレイス

ワンクリックインストールが可能です — Cursorマーケットプレイスでmcp-search-consoleを検索してください。

インストール後、認証情報を設定し（上記ステップ1を参照）、バンドルされたスキルをCursor Agentチャットで直接使用できます：

サンプルプロンプト

トラブルシューティング

spawn uvx ENOENT または command not found: uvx

AIクライアントが uvx を見つけられません。uvx の代わりにフルパスを使用してください：

# Find your full path (macOS/Linux):
which uvx
# Typically: /Users/YOUR_NAME/.local/bin/uvx

# Find your full path (Windows PowerShell):
Get-Command uvx | Select-Object -ExpandProperty Source
# Typically: C:\Users\YOUR_NAME\.local\bin\uvx.exe

設定ファイル内の "command": "uvx" をフルパス（例："command": "/Users/YOUR_NAME/.local/bin/uvx"）に置き換えてください。

インストール直後に uv --version で「command not found」が表示される

インストーラーは ~/.local/bin を更新しますが、現在のターミナルセッションではまだ認識されていません。以下を実行してください：

source $HOME/.local/bin/env

その後、永続的に追加します：

echo 'source $HOME/.local/bin/env' >> ~/.zshrc

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

認証情報ファイルには絶対パスを使用してください。相対パスや ~/ は使用しないでください。例：

/Users/yourname/Documents/client_secrets.json   ✅
~/Documents/client_secrets.json                 ✅
client_secrets.json                              ❌

MCPがClaude Desktopアプリでのみ動作し、ウェブサイトでは動作しない

MCPサーバーはローカルマシン上で実行されます。claude.ai/download からダウンロードしたClaude Desktopアプリでのみ動作し、claude.aiのブラウザインターフェースでは動作しません。

AIクライアントの設定に関する問題

1. 設定内のすべてのファイルパスが正しい絶対パスであることを確認してください

2. 設定変更後はアプリを完全に終了（Cmd+Q）してから再度開いてください。ウィンドウを閉じるだけでは不十分です

3. AIアシスタントに「get_capabilitiesを呼び出して」と依頼してください。正確な認証ステータスとエラーが報告されます

安全性：破壊的操作

デフォルトでは、add_site、delete_site、delete_sitemap は無効になっています。有効にするには：

"GSC_ALLOW_DESTRUCTIVE": "true"

リモートデプロイとDocker（上級者向け）

標準的なセットアップではサーバーをローカルで実行します。このセクションは、リモートサーバーまたはコンテナ内で実行したいユーザー向けです。

HTTPトランスポート

MCP_TRANSPORT=sse MCP_HOST=0.0.0.0 MCP_PORT=3001 python gsc_server.py

Docker

docker build -t mcp-gsc .

docker run \
  -e MCP_TRANSPORT=sse \
  -e MCP_HOST=0.0.0.0 \
  -e MCP_PORT=3001 \
  -e GSC_CREDENTIALS_PATH=/app/credentials.json \
  -v /path/to/credentials.json:/app/credentials.json \
  -p 3001:3001 \
  mcp-gsc

関連ツール

Advanced GSC Visualizer — インタラクティブなチャート、最大25,000行のワンクリックエクスポート、キーワードカニバリゼーション検出、AIアシスタントを備えたChrome拡張機能（14,000人以上のユーザー）で、すべてGoogle Search Console内で直接利用できます。同じ作者によって開発されました。Chromeウェブストアからインストール →

コントリビューション

バグを発見した場合や改善のアイデアがある場合は、GitHubでIssueを開くかプルリクエストを送信してください。

ライセンス

MITライセンス。詳細は LICENSE ファイルを参照してください。

変更履歴

[0.3.3] — 2026年7月

• mcp[cli]>=1.3.0,<2.0.0 に固定しました。mcp SDK 2.0.0 は mcp.server.fastmcp を削除したため、すべての新規 uvx インストールで ModuleNotFoundError が発生していました。2.0未満に制限することで、正常なインストールが復元されます。（#41を修正）

[0.3.2] — 2026年4月

• uvxでのOAuthブラウザフローを修正 — macOSでMCPサブプロセスとして実行する際にOAuthブラウザウィンドウの起動を妨げていた isatty ブロックを削除しました。OAuth + uvx がそのまま動作するようになりました。

• get_capabilities ツール — カテゴリ別にグループ化されたすべての利用可能なツールと、現在の認証ステータスを1回の呼び出しで返します。

• 認証エラーメッセージの改善 — すべてのツールで、認証情報が欠落または期限切れの場合に reauthenticate を呼び出すよう明示的に指示するようになりました。

• list_properties の説明を改善 — 遅延ツール読み込みを使用するクライアントでのセマンティックなツール発見が向上しました。

[0.3.1] — 2026年4月

• list_properties が実際の認証エラーを隠蔽していた問題を修正。認証情報が欠落している場合は即座に失敗するようになりました。

[0.3.0] — 2026年4月

• 4つのバンドル済みSEOスキルを備えたCursor Marketplaceプラグイン

• プラットフォームのユーザー設定ディレクトリへの安定したトークン保存（uvx アップグレード後も保持）

• すべてのデータツールに対する構造化JSON出力

• 39のユニットテスト

[0.2.2] — 2026年4月

• 破壊的ツールのセーフティモード（デフォルトで無効）

• リモートデプロイ用のHTTP/SSEトランスポート

• Dockerfile

[0.2.1] — 2026年3月

• Googleアカウントを切り替えるための reauthenticate ツール

• sitemapのTypeErrorクラッシュを修正

• ドメインプロパティの404エラーを修正

[0.2.0] — 2026年3月

• デフォルトで dataState: "all"（GSCダッシュボードと一致）

• 柔軟な row_limit パラメータ（最大500）

• 高度な分析のための多次元フィルタリング

[0.1.0] — 初回リリース

• プロパティ管理、検索アナリティクス、URL検査、サイトマップ管理をカバーする19のツール

• OAuthおよびサービスアカウント認証