Google Analytics MCP

Локальный MCP-сервер для Google Analytics 4. Оборачивает API данных GA4 в инструменты, ориентированные на отчетность по SEO и платным каналам.

Инструменты

Настройка

git clone https://github.com/ZLeventer/google-analytics-mcp-server.git
cd google-analytics-mcp-server
npm install
npm run build

Учетные данные

Скопируйте .env.example в .env и заполните:

• GA4_PROPERTY_ID — числовой идентификатор ресурса из GA4: Администратор → Настройки ресурса (например, 123456789). Не идентификатор потока данных (G-XXXXXXX).

• GOOGLE_APPLICATION_CREDENTIALS — абсолютный путь к JSON-файлу ключа сервисного аккаунта.

Создание сервисного аккаунта

1. Перейдите в console.cloud.google.com → выберите/создайте проект

2. API и сервисы → Библиотека → включите Google Analytics Data API

3. IAM и администрирование → Сервисные аккаунты → Создать сервисный аккаунт (назовите его ga4-mcp или аналогично)

4. Для созданного аккаунта → Ключи → Добавить ключ → Создать новый ключ → JSON → скачайте

5. Сохраните JSON как service-account.json в этой директории (уже в .gitignore)

6. В GA4 → Администратор → Управление доступом к ресурсу, нажмите + → вставьте email сервисного аккаунта (ga4-mcp@project-id.iam.gserviceaccount.com) → назначьте роль Читатель

Google SDK автоматически считывает GOOGLE_APPLICATION_CREDENTIALS — изменения в коде не требуются.

Установка в Claude Code

claude mcp add google-analytics \
  --env-file "/absolute/path/to/google-analytics-mcp-server/.env" \
  -- node "/absolute/path/to/google-analytics-mcp-server/dist/index.js"

Или добавьте вручную в ~/.claude.json:

{
  "mcpServers": {
    "google-analytics": {
      "command": "node",
      "args": ["/absolute/path/to/google-analytics-mcp-server/dist/index.js"],
      "env": {
        "GA4_PROPERTY_ID": "123456789",
        "GOOGLE_APPLICATION_CREDENTIALS": "/absolute/path/to/google-analytics-mcp-server/service-account.json"
      }
    }
  }
}

После установки перезапустите Claude Code.

Форматы даты

Все аргументы даты принимают форматы GA4:

• YYYY-MM-DD (например, 2026-04-01)

• NdaysAgo (например, 28daysAgo, 90daysAgo)

• yesterday, today

Значения по умолчанию: 28daysAgo → yesterday.

Проверка

После настройки учетных данных:

node -e '
  import("./dist/tools/reports.js").then(m =>
    m.channelPerformance({ start_date: "7daysAgo", end_date: "yesterday", limit: 10 })
  ).then(r => console.log(JSON.stringify(r, null, 2)))
'

Если команда возвращает строки, значит всё работает. Ожидаемые ошибки:

• GA4_PROPERTY_ID is not set — проверьте .env

• PERMISSION_DENIED — сервисному аккаунту не предоставлена роль «Читатель» для ресурса

• 403 Google Analytics Data API has not been used — включите API в проекте GCP

Дорожная карта

• [ ] Инструменты Admin API (список пользовательских измерений, событий конверсии, аудиторий) по мере необходимости

• [ ] Search Console MCP как вспомогательный сервер для данных о ранжировании / показах / CTR (дополняет этот сервер)

• [ ] Интеграция с Demandbase MCP для объединения трафика GA4 с фирмографическими данными (атрибуция на уровне аккаунта)