Cómo Empezar con el Servidor MCP de PostHog

¿Listo para potenciar tu juego de datos con IA? El Servidor PostHog MCP te permite gestionar la analítica de PostHog —como crear anotaciones o consultar tendencias de usuarios— usando lenguaje natural en herramientas como Cline o Cursor. Lo puse en marcha en solo unos minutos, ¡y es un cambio de juego total! En este tutorial, instalaremos el Servidor PostHog MCP en Cline en VS Code y Cursor, exploraremos sus características impresionantes, y veremos por qué PostHog supera a Google Analytics para la analítica de código abierto. ¡Vamos a sumergirnos en la magia del Servidor PostHog MCP!

💡

¿Quieres una excelente herramienta de prueba de API que genere documentación de API hermosa?

¿Quieres una plataforma integrada y todo en uno para que tu equipo de desarrolladores trabaje en conjunto con la máxima productividad?

Apidog satisface todas tus demandas, ¡y reemplaza a Postman a un precio mucho más asequible!

button

¿Qué es el Servidor PostHog MCP?

El **Servidor PostHog MCP** es un servidor de Protocolo de Contexto de Modelo (MCP) de código abierto que conecta asistentes de IA (como Cline o Cursor) a la plataforma de análisis de PostHog mediante comandos de lenguaje natural. Permite tareas como crear anotaciones, gestionar proyectos, consultar información y alternar indicadores de características, todo sin tocar la interfaz de usuario de PostHog. Las características clave incluyen:

Gestión de Proyectos: Listar y gestionar proyectos de PostHog.
Anotaciones: Añadir notas con marca de tiempo para eventos (ej., lanzamientos de productos).
Consultas de Información: Analizar el comportamiento del usuario (ej., tendencias de registro).
Indicadores de Características (Feature Flags): Controlar y consultar indicadores de características dinámicamente.
Seguimiento de Errores: Depurar errores directamente en tu IDE.

Es un “imprescindible” para la automatización de análisis, con más de 34 estrellas en GitHub que muestran el aprecio de la comunidad. ¿Listo para probarlo? ¡Vamos!

¿Por qué usar el Servidor PostHog MCP?

El **Servidor PostHog MCP** simplifica los flujos de trabajo de análisis con automatización impulsada por IA. He aquí por qué es genial:

Lenguaje Natural: Gestiona la analítica con comandos sencillos.
Integración: Funciona con Claude Desktop, VS Code, Cursor y más.
Código Abierto (la mejor parte): Gratuito, personalizable y impulsado por la comunidad.
Privacidad Primero: A diferencia de Google Analytics, PostHog ofrece opciones autoalojadas para un control total de los datos.

Comparado con Google Analytics, PostHog brilla por su transparencia de código abierto, flexibilidad de autoalojamiento y suite de productos todo en uno (análisis, reproducción de sesiones, indicadores de características). Google Analytics a menudo requiere integraciones de terceros y carece del enfoque de privacidad de PostHog, lo que convierte al **Servidor PostHog MCP** en una alternativa amigable para desarrolladores para equipos modernos.

Lo usé para anotar un lanzamiento de producto en segundos, ¡mucho más rápido que hacer clic en los paneles!

Cómo Instalar y Usar el Servidor PostHog MCP: Guía Paso a Paso

Instalemos el **Servidor PostHog MCP** en Cline en VS Code y Cursor, y luego lo probaremos con ejemplos. Necesitarás Python, una clave API de PostHog y un IDE. No se requiere ser un gurú de la analítica, ¡solo sigue los pasos!

1. Requisitos Previos

Python: 3.8+ (python3 --version).
uv: Gestor de paquetes de Python (pip install uv).
VS Code/Cursor: Última versión con la extensión Cline.
Clave API de PostHog: Obtén una en app.posthog.com/settings (Clave API Personal).
Docker: Opcional para configuración en contenedores (docker --version).
Espacio en Disco: ~500MB para el repositorio y las dependencias.

2. Clonar el Repositorio PostHog MCP

Abre tu terminal y clona el repositorio:

git clone https://github.com/PostHog/mcp.git
cd mcp

Esto descarga un proyecto de ~5MB. Me tomó unos segundos con Wi-Fi.

3. Instalar el Servidor PostHog MCP con Cline en VS Code

Configurar Entorno Virtual:

uv venv
source .venv/bin/activate  # macOS/Linux
.venv\Scripts\activate  # Windows
uv pip install .

Configurar Clave API:
Crea un archivo .env en la raíz del proyecto:

echo "PERSONAL_API_KEY=your-personal-api-key" > .env

Reemplaza your-personal-api-key con tu clave API de PostHog (que puedes adquirir desde su sitio web oficial).

Instalar Cline:
En VS Code, ve a Extensiones (Ctrl+Shift+X), instala Cline, y abre el panel de chat de Cline (Ctrl+Shift+P, “Cline: Abrir Chat”).

Añadir Servidor MCP:
Indica a Cline:

Install the PostHog MCP Server using uv and configure it with my API key.

Cline ejecuta uv run posthog_mcp y actualiza ~/.aws/amazonq/mcp.json:

{
  "mcpServers": {
    "posthog": {
      "command": "uv",
      "args": ["--directory", "/path/to/mcp", "run", "posthog_mcp"],
      "env": {
        "PERSONAL_API_KEY": "your-personal-api-key"
      }
    }
  }
}

Reemplaza /path/to/mcp con la ruta de tu repositorio (ej., /home/user/mcp).

El servidor mcp también se puede encontrar en el marketplace de mcp de Cline. Simplemente ve allí y busca "PostHog", luego haz clic en instalar.

Cline realizará automáticamente la instalación por ti.

Verificar: Ejecuta /tools en el chat de Cline para listar las herramientas (ej., create_annotation, list_projects). ¿Ves el icono de los servidores mcp en Cline? Estás listo.

4. Instalar el Servidor PostHog MCP con Cursor

Clonar e Instalar: Repite la clonación y configuración del entorno virtual del Paso 2.
Configurar Cursor:
Abre Cursor, ve a Configuración > Herramientas e Integraciones > Herramientas MCP > Añadir un Servidor MCP Personalizado, y añade la configuración del servidor a .cursor/mcp.json:

{
  "mcpServers": {
    "posthog": {
      "command": "/path/to/uv",
      "args": ["--directory", "/path/to/mcp", "run", "posthog_mcp"],
      "env": {
        "PERSONAL_API_KEY": "your-personal-api-key"
      }
    }
  }
}

Encuentra la ruta de uv con which uv (macOS/Linux) o where uv (Windows).

Reiniciar Cursor: Haz clic en el botón de actualizar en Configuración > Herramientas e Integraciones > Herramientas MCP.
Verificar: Pregunta a Cursor: “Listar herramientas disponibles del Servidor PostHog MCP.” Debería mostrar create_annotation, list_projects, etc.

5. Probar las Características del Servidor PostHog MCP

Crear una Anotación:
En Cline (VS Code) o Cursor, indica:

Create a PostHog annotation in project 53497 for March 20th, 2025, with the description 'Launched new user onboarding flow' using the PostHog MCP Server.

El servidor llama a la API de PostHog, añadiendo la anotación. Verifica en app.posthog.com para confirmar.

Consultar Información:
Indica:

Show the trend of user sign-ups in project 98765 over the last 30 days using 
the PostHog MCP Server.

El servidor recupera datos estructurados (ej., JSON con tendencias de registro). Salida de ejemplo:

{
  "insight": "user_signups",
  "project_id": 98765,
  "data": [
    {"date": "2025-06-01", "count": 120},
    {"date": "2025-06-02", "count": 135}
  ]
}

Ejecuté esto y obtuve datos limpios en ~5 segundos, ¡súper pulcro!

6. Configuración en Contenedores (Opcional)

Para una configuración con Docker:

docker run -i --rm -e PERSONAL_API_KEY=your-personal-api-key ghcr.io/metorial/mcp-container--posthog--posthog-mcp--posthog-mcp posthog-mcp

Añade a mcp.json de Cline/Cursor:

{
  "mcpServers": {
    "posthog": {
      "command": "docker",
      "args": ["run", "-i", "--rm", "ghcr.io/metorial/mcp-container--posthog--posthog-mcp--posthog-mcp", "posthog-mcp"],
      "env": {
        "PERSONAL_API_KEY": "your-personal-api-key"
      }
    }
  }
}

Reinicia y verifica como se indicó anteriormente. La limpieza de Docker (--rm) me ahorró espacio en disco.

7. Solución de Problemas Comunes

Sin Icono de Martillo:
Revisa los registros: ~/Library/Logs/Claude/mcp*.log (macOS) o %APPDATA%\Claude\logs (Windows).
Asegúrate de usar rutas absolutas en mcp.json.
Errores de Clave API:
Verifica los permisos de la clave en app.posthog.com/settings.
Usa variables de entorno, no claves codificadas.
Servidor No Ejecutándose:
Ejecuta uv run posthog_mcp manualmente para verificar errores.
Asegúrate de tener Python 3.8+ y las dependencias (uv pip install .).
¿Necesitas Ayuda? Consulta github.com/PostHog/mcp o X para obtener consejos.

Por Qué PostHog Supera a Google Analytics

El **Servidor PostHog MCP** de PostHog se integra con su plataforma, que supera a Google Analytics en:

Código Abierto: Autoalojamiento gratuito, a diferencia del encierro propietario de Google Analytics.
Privacidad: Controla los datos con instancias autoalojadas; Google Analytics comparte datos con Google.
Todo en Uno: Análisis, reproducción de sesiones, indicadores de características y experimentos en una sola plataforma, frente a las herramientas fragmentadas de Google.
Automatización: El **Servidor PostHog MCP** permite consultas en lenguaje natural, a diferencia de los paneles manuales de Google Analytics.
Comunidad: Más de 1.500 estrellas en GitHub y soporte activo, rivalizando con Google pero con la flexibilidad del código abierto.

Cambié un proyecto secundario a PostHog y me encantó la privacidad y el control de los indicadores de características, ¡sin la hinchazón de Google Analytics!

Personalizando y Extendiendo el Servidor PostHog MCP

Mejora tu configuración:

Herramientas Personalizadas: Añade nuevas herramientas al servidor (ej., información SQL personalizada) a través de github.com/PostHog/mcp.
Múltiples Proyectos: Consulta todos los proyectos con “Listar todos los proyectos en mi organización de PostHog.”
Indicadores de Características (Feature Flags): Genera código para alternar indicadores:

Genera un fragmento de Python para alternar el indicador de característica 'new-ui' en el proyecto 12345
usando el Servidor PostHog MCP.

Contribuir: Envía PRs para mejorar el servidor —PostHog los recibe con gusto.

Por Qué el Servidor PostHog MCP es un Imprescindible para Desarrolladores

El **Servidor PostHog MCP** hace que la automatización de análisis se sienta como chatear con un gurú de datos. Su interfaz de lenguaje natural y la ventaja de código abierto de PostHog superan a Google Analytics para equipos conscientes de la privacidad. La configuración puede ser delicada (¡problemas con la clave API!), pero la documentación de PostHog y la comunidad son salvavidas.

¿Listo para usar a tope el **Servidor PostHog MCP**? ¡Inicia Cline o Cursor, consulta esos datos y comparte tus logros analíticos —estoy emocionado de ver brillar tu configuración!

💡

button