Servidor MCP de PostHog 📊

Un servidor de Protocolo de Contexto de Modelo (MCP) para interactuar con PostHog. ¡Crea anotaciones y gestiona proyectos directamente desde Claude Desktop!

Características 🚀

• Lista de proyectos : vea todos los proyectos PostHog disponibles en su organización

• Crear anotaciones : agregue anotaciones a sus proyectos PostHog con marcas de tiempo opcionales [esta lista puede ser mucho más larga, básicamente cualquier cosa que nuestra API tenga...]

Configuración 🛠️

1. Prerrequisitos

   • Python 3.10 o superior

   • administrador de paquetes uv

   • Clave API de PostHog con annotation:write y project:read obtenidos de la configuración de su proyecto

2. Instalación

   # clone the repo git clone git@github.com:PostHog/posthog-mcp.git # or if https, use: git clone https://github.com/PostHog/posthog-mcp.git cd posthog-mcp uv venv source .venv/bin/activate # Install dependencies uv pip install .

3. Configuración

   • Cree un archivo .env en la raíz del proyecto:

     PERSONAL_API_KEY=phx_your_posthog_api_key_here

4. Configuración del escritorio de Claude

   • Instalar Claude Desktop

   • Abra la configuración de Claude Desktop y haga clic en "Editar configuración". También puede abrir el archivo desde:

     • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

     • Ventanas: %APPDATA%\Claude\claude_desktop_config.json

   • Agregue esto a su claude_desktop_config.json (ajuste las rutas según su sistema):

     { "mcpServers": { "posthog": { "command": "/path/to/uv", # Get this by running: which uv "args": [ "--directory", "/path/to/your/posthog-mcp", # Full path to this project "run", "posthog_mcp" ] } } }

     Consulte la documentación más reciente sobre la configuración de Claude Desktop como cliente MCP si encuentra algún problema.

Uso 💡

Tras la configuración, verás un icono de martillo 🔨 en Claude Desktop. Los siguientes comandos están disponibles:

Lista de proyectos

Pregúntale a Claude:

Obtenga y busque información

Pregúntale a Claude:

"Enumerar mis estadísticas de PostHog" o "Buscar estadísticas de ingresos en mi PostHog"

Búsqueda de documentación en línea

Puedes preguntar:

• "¿Cómo puedo hacer un proxy inverso en nextjs en posthog?"

Crear anotación

Usando el ID del proyecto que obtienes de la lista de proyectos, pregúntale a Claude:

o con una fecha específica:

Solución de problemas 🔍

• Si el icono del martillo no aparece, reinicie Claude Desktop

• Consulte los registros en ~/Library/Logs/Claude/mcp*.log (macOS) o %APPDATA%\Claude\logs (Windows)

• Verifique que su clave API de PostHog tenga los permisos correctos

• Asegúrese de que todas las rutas en claude_desktop_config.json sean rutas absolutas

Contribuyendo 🤝

¡No dudes en publicar problemas y solicitudes de colaboración! Seguimos las normas de contribución de PostHog.