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.