Cédric Rittié

PostHog
MCP · Analytics

PostHog

Le MCP officiel de PostHog expose plus de 27 outils pour interroger ton projet analytics en langage naturel. Claude lit tes événements, crée des feature flags, liste les erreurs, génère des insights. Utile dès que tu veux comprendre un comportement sans passer par l'UI.

Documentation officielleGratuit (jusqu'à 1M events/mois)

Cas d'usage

  • Répondre à une question analytics sans ouvrir le dashboard
  • Créer un feature flag avec rollout progressif depuis Claude
  • Investiguer une régression : quels utilisateurs, quelles pages, quelles erreurs

Installation

1.Génère une Personal API Key dans PostHog : Settings → Personal API keys → Create key. Scopes recommandés : read sur projects, feature_flag et query.

2.Une ligne, un terminal
$ claude mcp add posthog -- npx -y @posthog/mcp-server --api-key=YOUR_KEY

Remplace YOUR_KEY par ta clé. Redémarre Claude Code puis vérifie avec /mcp (tu dois voir posthog dans la liste).

Besoin d'installer Claude Code d'abord ? Voir la fiche Claude Code · Documentation officielle

Exemples concrets

"Combien de visiteurs uniques sur cedricrittie.com cette semaine, et quelle est la page la plus vue ?"

Claude appelle deux outils du MCP : trends-get (unique users sur 7 jours) et insights-query (top pages). Retourne les chiffres bruts + une micro-analyse.

Résultat type
→ Calling posthog.trends_get (event=$pageview, interval=week)
→ Calling posthog.insights_query (top pages, 7d)

Visiteurs uniques (7 derniers jours) : 1 247 (+18 % vs semaine précédente)

Top 5 pages
1. /fr/blog/bibliotheque-skills          342 vues
2. /fr                                    298 vues
3. /fr/ressources                         187 vues
4. /fr/blog/mcp-connecter-claude-outils   156 vues
5. /fr/parcours                            92 vues

Observation : l'article Skills concentre 27 % du trafic. L'article MCP monte
progressivement depuis sa publication il y a 12 jours.
"Crée un feature flag 'new-onboarding' actif à 10% sur les users US, et explique-moi ce que j'ai créé."

Claude appelle feature_flag_create avec un rollout progressif conditionnel sur la géo. Retourne la config finale et un résumé en langage clair.

Résultat type
→ Calling posthog.feature_flag_create
   name: "new-onboarding"
   rollout: 10%
   filter: user.country == "US"

✓ Feature flag créé (id 8412)

Résumé : le flag 'new-onboarding' est actif sur 10 % des utilisateurs
situés aux États-Unis. Les autres utilisateurs (hors US + 90 % des US)
voient l'ancien flow. Le flag est modifiable sans redéploiement côté code :
change le rollout ou la condition directement dans PostHog.
"Investigue la chute de conversion sur /pricing entre hier et aujourd'hui."

Claude croise events (pageviews), errors (erreurs JS/API) et session_recordings pour identifier la cause probable. Combine 3 outils du MCP en une investigation.

Résultat type
→ Analyse période : 24h glissantes vs 24h précédentes

Funnel /pricing → checkout : 8,2 % (hier 12,4 %). Chute de -34 %.

Erreurs trouvées
- Stripe.js error "Invalid publishable key" : 47 occurrences depuis 16h hier
- Bloque le bouton "Payer" sans message visible côté user

Sessions liées (3 replays échantillonnés) : user clique, rien ne se passe,
abandon après 12-20 secondes.

Hypothèse : ta clé Stripe a été rotée ou expirée hier vers 16h. Vérifie
dashboard Stripe + redéploie avec la nouvelle clé. Le fix devrait
ramener la conversion à son niveau normal sous 24h.