# Instrucciones para el agente: PostHog MCP: conecta análisis de producto y diagnóstico

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/PostHog/posthog (licencia NOASSERTION)
- Guía completa: https://lab.wisd.ai/hub/posthog-mcp

---

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

### Preparación

Comprueba Node.js ≥22.22.0 y npm ≥3.10.7 con npx, según el [manifiesto del Wizard](https://github.com/PostHog/wizard/blob/main/package.json). Abre un cliente MCP compatible y confirma acceso a la cuenta y al proyecto que autorizarás.

### Paso 1: configura el cliente

Usa el instalador oficial:

```bash
npx @posthog/wizard mcp add
```

### Paso 2: conecta la cuenta

Completa la autorización y confirma el proyecto. Si configuras el transporte manualmente, el endpoint oficial es `https://mcp.posthog.com/mcp`.

### Paso 3: pide una consulta

Solicita un resumen pequeño de errores o una métrica existente, indicando proyecto y periodo.

## Comprobación

Compara el periodo, filtros y cifras devueltos con la misma consulta en PostHog. Comprueba que no se haya cambiado ningún flag durante la prueba de lectura.

## Si algo falla

Si no aparece una herramienta de IA, revisa la habilitación de procesamiento de IA de la organización. Si los datos no coinciden, compara proyecto, filtros y región antes de cambiar la consulta.

[Fuente del procedimiento](https://posthog.com/docs/model-context-protocol).