====== Google Analytics MCP server ======

Google Analytics MCP Server je experimentální lokální MCP server pro práci s Google Analytics. Zpřístupňuje účty, property a reporty z Google Analytics přes MCP klienta a hodí se hlavně pro dotazy nad GA4 daty z AI nástrojů.

===== Co umí =====

Podle repozitáře server pracuje nad Google Analytics Admin API a Google Analytics Data API a nabízí hlavně tyto nástroje:

  * ''get_account_summaries'' pro přehled dostupných účtů a property
  * ''get_property_details'' pro detail konkrétní property
  * ''list_google_ads_links'' pro vazby mezi property a Google Ads
  * ''run_report'' pro standardní reporty nad daty Google Analytics
  * ''run_realtime_report'' pro realtime reporty
  * ''get_custom_dimensions_and_metrics'' pro přehled vlastních dimenzí a metrik

===== Požadavky =====

Pro zprovoznění je podle README potřeba:

  * Python prostředí a ''pipx''
  * zapnuté API ''Google Analytics Admin API''
  * zapnuté API ''Google Analytics Data API''
  * Application Default Credentials pro účet, který má přístup k příslušným Google Analytics účtům nebo property
  * scope ''https://www.googleapis.com/auth/analytics.readonly''

===== Autentizace =====

Pro autentizaci spouštím ''gcloud'' příkaz na hostitelském počítači, ne uvnitř Dockeru. Vygenerovaný soubor s credentials pak přenesu do Dockeru a v kontejneru použiji cestu, kam byl zkopírován.

Na hostitelském počítači se credentials ukládají do ''~/.config/gcloud/application_default_credentials.json''.

Tady je příkaz, který používám:

<code bash>
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
</code>

===== Základní spuštění =====

README používá jako příklad spuštění přes ''pipx'' a napojení do Gemini CLI nebo Gemini Code Assist.

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

Pokud běží server v Dockeru, ''GOOGLE_APPLICATION_CREDENTIALS'' musí ukazovat na cestu k přenesenému souboru uvnitř kontejneru.

===== Zdroje =====

  * [[https://github.com/googleanalytics/google-analytics-mcp|GitHub: googleanalytics/google-analytics-mcp]]
  * [[https://pypi.org/project/analytics-mcp/|PyPI: analytics-mcp]]
  * [[https://developers.google.com/analytics/devguides/config/admin/v1|Google Analytics Admin API]]
  * [[https://developers.google.com/analytics/devguides/reporting/data/v1|Google Analytics Data API]]