Google Analytics MCP Server

Что умеет сервер

Сервер запускается на вашем компьютере и использует Google Analytics Admin API и Data API. Инструменты делятся на три группы: сведения об аккаунтах и ресурсах (сводки аккаунтов, детали ресурса, связи с Google Ads), основные отчёты (обычный отчёт, воронка, пользовательские параметры и показатели) и отчёты в реальном времени.

Так ассистент отвечает на вопросы вроде «какие события популярнее всего за последние 180 дней», «были ли пользователи в основном авторизованы» или «какие в ресурсе пользовательские параметры и показатели».

Когда использовать

Подходит, когда аналитику хочется разбирать разговором: быстро получить цифры без интерфейса GA4, сопоставить периоды, проверить настройки ресурса. Связки с Google Ads в списке инструментов видны только как перечень ссылок; управлять рекламой сервер не умеет.

В README сервер назван экспериментальным: набор инструментов и поведение могут меняться.

Ограничения и безопасность

Права доступа читаются через Application Default Credentials и должны включать область только для чтения analytics.readonly, поэтому изменить настройки аналитики сервер не может. Нужны включённые в проекте Google Cloud Admin API и Data API, а также установленный pipx.

Сервер видит всё, что доступно вашей учётной записи Google в Analytics. Для рабочих сценариев в README показана и подмена через сервисный аккаунт (impersonation), чтобы выдать минимально нужные права.

Подготовка

1. Установите pipx.
2. Включите в проекте Google Cloud Google Analytics Admin API и Google Analytics Data API.
3. Настройте Application Default Credentials с областью только для чтения (аккаунт должен иметь доступ к ресурсам Analytics):

gcloud auth application-default login   --scopes https://www.googleapis.com/auth/analytics.readonly,https://www.googleapis.com/auth/cloud-platform   --client-id-file=YOUR_CLIENT_JSON_FILE

Вместо учётных данных пользователя можно подменить сервисный аккаунт:

gcloud auth application-default login   --impersonate-service-account=SERVICE_ACCOUNT_EMAIL   --scopes=https://www.googleapis.com/auth/analytics.readonly,https://www.googleapis.com/auth/cloud-platform

Команда выведет путь к файлу учётных данных в строке Credentials saved to file: [PATH_TO_CREDENTIALS_JSON]. Он понадобится ниже.

Gemini

Создайте или отредактируйте ~/.gemini/settings.json:

{
  "mcpServers": {
    "analytics-mcp": {
      "command": "pipx",
      "args": ["run", "analytics-mcp"],
      "env": {
        "GOOGLE_APPLICATION_CREDENTIALS": "PATH_TO_CREDENTIALS_JSON",
        "GOOGLE_PROJECT_ID": "YOUR_PROJECT_ID"
      }
    }
  }
}

Claude Code

claude mcp add analytics-mcp   --scope user   -e "GOOGLE_APPLICATION_CREDENTIALS=PATH_TO_CREDENTIALS_JSON"   -e "GOOGLE_PROJECT_ID=YOUR_PROJECT_ID"   -- pipx run analytics-mcp

Проверка в Gemini CLI или Gemini Code Assist: выполните /mcp, в списке должен появиться analytics-mcp.