# Instrucciones para el agente: Google Analytics MCP: consulta tus propiedades desde el agente

Pega este texto a tu agente (Claude Code, Codex, OpenCode, Hermes o el que uses) y dile «ayúdame a montarlo». Son los pasos para ponerlo en marcha; el porqué de cada pieza está en la guía completa.

- Dificultad: intermedio
- Proyecto: https://github.com/googleanalytics/google-analytics-mcp (licencia Apache-2.0)
- Guía completa: https://lab.wisd.ai/hub/google-analytics-mcp-official

---

## Para el agente: cómo acompañar al usuario

1. Pregunta primero para qué lo quiere. Si su objetivo no necesita algún paso, sáltalo.
2. Antes de instalar, comprueba lo que ya tiene (versiones, claves, sistema operativo).
3. Avanza un paso cada vez: explica en una frase qué vas a hacer y deja que el usuario lo ejecute o lo apruebe.
4. Tras cada paso, comprueba que funcionó antes de seguir. Si falla, para y explica el error.
5. No inventes comandos ni opciones: si la documentación del proyecto contradice estos pasos, manda la documentación.
6. Al terminar, haz una prueba real con el objetivo del usuario y dile dónde profundizar.

---

## Pasos de configuración

### Paso 1: prepara el acceso

Comprueba que tienes Python ≥3.10, pipx, gcloud y Claude Code disponibles. Habilita Admin API y Data API. Crea un cliente OAuth de escritorio y descarga su JSON privado. La ruta ADC del README se ejecuta así, sustituyendo `YOUR_CLIENT_JSON_FILE` por su ruta:

```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
```

Autoriza con la identidad que puede leer GA4 y conserva la ruta que imprime «Credentials saved to file»: úsala como `PATH_TO_CREDENTIALS_JSON` en el siguiente paso. No pegues el contenido de las credenciales en el chat.

### Paso 2: conecta Claude Code

El comando oficial utiliza marcadores que debes sustituir por rutas e identificadores de tu entorno:

```bash
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
```

### Paso 3: prueba lectura

Pide listar las cuentas y propiedades accesibles y después un informe corto de una propiedad de ensayo.

## Comprobación

Compara un informe con GA4 usando el mismo periodo y dimensiones. Comprueba que la configuración no incorpora `--allow-write` ni solicita alcance de edición.

## Si algo falla

Si no encuentra propiedades, revisa los permisos de la identidad ADC. Si la API está deshabilitada o hay errores de cuota, corrige el proyecto de Google Cloud siguiendo el README.

Consulta el [README oficial](https://github.com/googleanalytics/google-analytics-mcp#readme) para el procedimiento completo y los cambios de versión.