Gsc MCP Server

🚀 Google Search Console Analytics Server (MCP Server) Configuration Guide on Claude Desktop

This guide provides a step - by - step process for configuring the Google Search Console Analytics Server (MCP Server) on Claude Desktop, including installation, setup, usage instructions, troubleshooting, and important notes.

🚀 Quick Start

The following steps will guide you through the process of setting up the MCP Server on Claude Desktop.

📦 Installation

1. Install uv

Run the following command to install uv:

pip install uv

2. Download and Extract the MCP Server

Visit the GitHub repository and download and extract the gsc-mcp-server.zip file.

3. Configure Environment Variables

Edit the claude_desktop_config.json file and add the following content:

{
  "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"
      }
    }
  }
}

⚠️ Important Note

Please replace YOUR_USER_NAME and the paths with your actual paths.

4. Start the Service

Run the following command to start the MCP Server:

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

💻 Usage Examples

Basic Usage

• Step 1: Enter the following content in Claude Desktop and press Enter to execute:

  ! # Search Console Analytics
  

• Step 2: The system will automatically retrieve and display the Search Console link. Copy the link to your browser and open it, then accept the permission request as prompted.

Advanced Usage

1. Search Console Link Generator

Enter the following command to generate an access link to the Search Console:

! # Search Console URL

2. Data Retrieval Tools

• site - stats: Retrieve website statistics data.

  ! mcp site-stats --property-id YOUR_PROPERTY_ID
  

• search - analytics: Retrieve search analytics data.

  ! mcp search-analytics --property-id YOUR_PROPERTY_ID
  

🔧 Troubleshooting

1. Startup Issues

If you encounter startup errors, please check the following:

1. Ensure that uv is installed correctly.
2. Check if the configuration file path is correct.

2. Permission Issues

If you encounter permission - related problems, it may be that the service account lacks the required permissions. Please go to the Google Cloud Console and add the "Google Search Analytics (Legacy) API Admin" role to the service account.

💡 Usage Tip

• It is recommended to store the configuration files and certificates in non - system directories, such as ~/Documents or ~/Desktop.
• Regularly update the dependency libraries:

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

This concludes the complete configuration and usage guide.