GA4 - Google Analytics MCP Server

Что такое GA4 - Google Analytics MCP Server?

GA4 - Google Analytics MCP Server — это автономный сервер, который предоставляет возможности отчетности Google Analytics 4 через стандартизированный Протокол Контекста Модели. Он служит безопасным мостом между вашим свойством GA4 и любыми ИИ-инструментами, совместимыми с MCP, что позволяет быстро запрашивать аналитику, генерировать отчеты и интегрировать их в ИИ-рабочие процессы с помощью предопределенных функций.

Как настроить

1. Настройка Google

   • Включите Google Analytics Data API в своем проекте Google Cloud.
   • Создайте Сервисный аккаунт в меню "IAM & Admin > Сервисные аккаунты" и сгенерируйте JSON-ключ для аутентификации.
   • Предоставьте Сервисному аккаунту доступ "Viewer" к вашему свойству GA4 в Google Analytics.

2. Среда сервера

   • Настройте переменные окружения:
     • GOOGLE_CLIENT_EMAIL: адрес электронной почты сервисного аккаунта из JSON-ключа
     • GOOGLE_PRIVATE_KEY: закрытый ключ сервисного аккаунта из JSON-ключа
     • GA_PROPERTY_ID: ваш ID свойства GA4

3. Установка

   • Установите глобально: npm install -g mcp-server-google-analytics
   • Или используйте с npx: npx mcp-server-google-analytics
   • Или установите через Smithery для интеграции с Claude Desktop.

4. Конфигурация для ИИ-инструментов (например, Claude Desktop)

   • Добавьте соответствующие команды и переменные окружения в конфигурацию вашего инструмента под MCP-серверами.

Как использовать

1. Запустите сервер

   • Запустите pnpm start, npx mcp-server-google-analytics или откройте из вашей интеграции инструмента.

2. Вызов функций/инструментов

   • ИИ-инструменты или агенты LLM могут вызывать функции, такие как runReport, getPageViews, getActiveUsers, getEvents или getUserBehavior через интерфейс MCP.
   • Передайте необходимые поля (например, диапазоны дат, размеры, метрики) в качестве аргументов функции.

3. Пример: Запрос просмотров страниц

   • Используйте инструмент getPageViews, предоставив диапазон дат и опционально размеры, чтобы получить метрики просмотров.

4. Интеграция

   • Интегрируйте сервер с любым ИИ-клиентом или системой автоматизации, поддерживающей MCP, для динамического доступа к аналитике.

Ключевые особенности

• Доступ к данным аналитики GA4 в реальном времени через стандартные функции MCP.
• Настраиваемая отчетность: выбирайте определенные метрики, размеры, фильтры и периоды.
• Множество предопределенных инструментов: просмотры страниц, метрики пользователей, метрики событий и анализ поведения.
• Безопасная аутентификация сервисного аккаунта с минимально необходимыми правами.
• Простая установка и настройка как для автономного, так и для интегрированного использования (например, в Claude Desktop).
• Разработан с возможностью расширения для будущих аналитических нужд.

Сценарии использования

• Интегрировать метрики GA4 непосредственно в панели управления, инструменты отчетности или рабочие процессы ассистентов на основе ИИ.
• Позволить чат-ботам или агентам ИИ отвечать на вопросы о использовании веб-сайта или приложения, тенденциях трафика или вовлеченности пользователей.
• Автоматизировать создание сводок аналитики, анализа когорт или отчетов на основе событий.
• Мониторить производительность кампаний и поведение пользователей в реальном времени в рамках продуктов с поддержкой ИИ.

Часто задаваемые вопросы

Q1: Какие разрешения GA4 нужны для сервисного аккаунта?
A: Сервисному аккаунту нужен доступ "Viewer" к целевому свойству GA4, что позволяет только чтение аналитических данных.

Q2: Безопасен ли мой закрытый ключ во время работы?
A: Да, ваш закрытый ключ и учетные данные хранятся только в переменных окружения на стороне сервера; никогда не раскрывайте ключи клиенту или публичным репозиториям.

Q3: Могу ли я использовать это с любым ИИ-инструментом или рабочим процессом?
A: Да, пока инструмент поддерживает интеграцию MCP, вы можете подключить сервер и получить доступ к аналитическим функциям.

Q4: Что происходит, если мои учетные данные недействительны или неправильно настроены?
A: Сервер не сможет аутентифицироваться с Google Analytics, и вызовы функций будут возвращать ошибки, указывающие на проблемы с учетными данными; убедитесь, что вы внимательно следуете инструкциям по настройке.

Q5: Можно ли расширять или настраивать доступные инструменты?
A: Да, проект с открытым исходным кодом, и вы можете внести вклад или адаптировать сервер для поддержки дополнительных запросов GA4 или логики пользовательских отчетов.