Gsc MCP Server

🚀 Google 検索コンソール分析サーバー（MCP Server）のClaude Desktopでの設定ガイド

このガイドでは、Google 検索コンソール分析サーバー（MCP Server）をClaude Desktop上で設定する方法を説明します。

🚀 クイックスタート

📦 インストール

1. uvのインストール

以下のコマンドを実行してuvをインストールします。

pip install uv

2. MCPサーバーのダウンロードと解凍

GitHubリポジトリにアクセスし、gsc-mcp-server.zipファイルをダウンロードして解凍します。

3. 環境変数の設定

claude_desktop_config.jsonファイルを編集し、以下の内容を追加します。

{
  "mcpServers": {
    "Search Console Analytics": {
      "command": "uv",
      "args": [
        "run",
        "--with",
        "google-api-python-client",
        "--with",
        "google-auth",
        "--with",
        "mcp[cli]",
        "--with",
        "pandas",
        "mcp",
        "run",
        "/Users/YOUR_USER_NAME/Documents/gsc-mcp-server/server.py"
      ],
      "env": {
        "GOOGLE_APPLICATION_CREDENTIALS": "/Users/YOUR_USER_NAME/Path/To/Credentials/gscaccess-credentials.json"
      }
    }
  }
}

⚠️ 重要提示

YOUR_USER_NAMEとパスを実際のパスに置き換えてください。

4. サーバーの起動

以下のコマンドを実行してMCPサーバーを起動します。

uv run --with google-api-python-client --with google-auth --with mcp[cli] --with pandas mcp run /path/to/server.py

💻 使用例

基本的な使用法

Claude Desktopでの使用手順は以下の通りです。

• ステップ1：Claude Desktopで以下の内容を入力し、Enterキーを押して実行します。

! # Search Console Analytics

• ステップ2：システムが自動的に検索コンソールのリンクを取得して表示します。このリンクをコピーしてブラウザで開き、指示に従って権限要求を承認します。

高度な使用法

検索コンソールリンク生成器

以下のコマンドを入力して検索コンソールのアクセスリンクを生成します。

! # Search Console URL

データ取得ツール

• site-stats：ウェブサイトの統計データを取得します。

! mcp site-stats --property-id YOUR_PROPERTY_ID

• search-analytics：検索分析データを取得します。

! mcp search-analytics --property-id YOUR_PROPERTY_ID

🔧 トラブルシューティング

起動問題

起動エラーが発生した場合は、以下の点を確認してください。

1. uvが正しくインストールされていることを確認します。
2. 設定ファイルのパスが正しいことを確認します。

権限問題

権限関連の問題が発生した場合は、サービスアカウントに必要な権限がない可能性があります。Google Cloud Consoleにアクセスし、サービスアカウントに"Google Search Analytics（旧版）API Admin"ロールを追加してください。

📄 注意事項

⚠️ 重要提示

設定ファイルと証明書は、~/Documentsや~/Desktopなどのシステム外のディレクトリに保存することをお勧めします。

💡 使用建议

依存ライブラリを定期的に更新してください。

pip install --upgrade uv google-api-python-client google-auth pandas

以上が、Google 検索コンソール分析サーバー（MCP Server）のClaude Desktopでの設定と使用の完全なガイドです。