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...]

Related MCP server: Warpcast MCP Server

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:

"List my PostHog projects"

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:

"Create a PostHog annotation in project 53497 saying 'Deployed v1.2.3'"

o con una fecha específica:

"Create a PostHog annotation in project 53497 for March 20th saying 'Started new marketing campaign'"

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.