PostHog MCP einrichten: Projekt und Abfragen prüfen
Beginnen Sie mit einem bekannten Insight. Stimmen Projekt, Zeitraum und Zählweise überein, wird aus einer Zahl ein überprüfbares Ergebnis.
Zwei Abfragen können dasselbe Ereignis nennen und trotzdem unterschiedliche Zahlen liefern. Vielleicht zählt eine Ereignisse, die andere Personen; vielleicht ist nur in einer Ansicht der interne Testverkehr ausgeschlossen. Halten Sie diese Bedingungen vor dem ersten MCP-Abruf fest. Ein vorhandener Insight eignet sich als Vergleichspunkt, weil Sie seine Einstellungen nachsehen können.
Den gehosteten PostHog-Zugang verbinden
PostHog dokumentiert https://mcp.posthog.com/mcp als gemeinsamen Server-Endpunkt. Der Anmeldedienst ordnet das Konto seiner US- oder EU-Datenregion zu. Das folgende HTTP-Beispiel gehört in .vscode/mcp.json. Ergänzen Sie den Eintrag unter servers, wenn die Datei bereits andere Verbindungen enthält.
{
"servers": {
"posthog": {
"type": "http",
"url": "https://mcp.posthog.com/mcp"
}
}
}
Starten Sie den Server im Editor und folgen Sie dem Anmeldeablauf. Prüfen Sie danach die ausgewählte Organisation und das Projekt. Die VS-Code-Anleitung zeigt die Einrichtung im Zusammenhang. Ein ähnlicher Projektname reicht als Nachweis nicht aus; halten Sie auch die Projektkennung fest.
Die Zählweise vor dem Ergebnis prüfen
| Angabe | Beispiel für Ihre Notiz | Warum es zählt |
|---|---|---|
| Projekt | Kennung des Testprojekts | Gleiche Ereignisnamen können mehrfach vorkommen |
| Ereignis | Exakter Name und Eigenschaftsfilter | Ähnliche Ereignisse sind keine gleiche Menge |
| Zeitraum | Feste Grenzen und Zeitzone | Relative Zeitfenster verschieben sich |
| Messgröße | Ereignisse oder eindeutige Personen | Die Zahlen beantworten verschiedene Fragen |
Einen vorhandenen Insight als Kontrollpunkt nutzen
Öffnen Sie einen gespeicherten Insight mit einem bekannten Ereignis. Notieren Sie die Projektkennung, Datumsgrenzen, Filter und Zählweise. Verwenden Sie für den ersten Versuch keine gerade laufende Minute.
Prüfen Sie die Werkzeugliste des verbundenen Servers. Formulieren Sie ausdrücklich einen Leseauftrag für den gewählten Insight oder dieselbe Abfrage, ohne einen neuen Insight zu speichern.
Vergleichen Sie nicht nur die Gesamtzahl, sondern auch einen Tageswert oder eine bekannte Eigenschaft. Bei einer Abweichung kontrollieren Sie zuerst die Definition der Messgröße.
Halten Sie die Ergebnisabweichung und deren Erklärung fest. Wiederholen Sie den Test nach einer Konfigurationsänderung mit denselben Angaben, damit Sie die Wirkung der Änderung erkennen können.
Lesen und Änderungen getrennt planen
Der PostHog-Zugang bietet laut Dokumentation auch schreibende Funktionen, etwa für Feature Flags und andere Produkte. Ein sinnvoller Lesetest benötigt diese Änderungen nicht. Eine Bitte um Lesezugriff im Text ersetzt jedoch keine Kontoberechtigung. Prüfen Sie vor weiteren Aufgaben die Rechte und die im Client verfügbaren Freigaben.
Die Anleitung zum Lesezugriff erklärt diese Trennung. Der Monitoring-Vergleich ordnet Produktdaten neben Logs ein. Weitere Quellenangaben finden Sie in der PostHog-Registersuche.
- Brauche ich für die EU-Region eine andere MCP-Adresse?
- Die gelesene PostHog-Dokumentation nennt einen gemeinsamen Endpunkt. Die Anmeldung ordnet das Konto der Datenregion zu. Prüfen Sie trotzdem das gewählte Projekt.
- Warum stimmt die Zahl nicht mit meinem Dashboard überein?
- Vergleichen Sie Ereignisdefinition, Eigenschaftsfilter, Zeitfenster und Zählweise. Ein Dashboard kann außerdem andere Filter verwenden als der einzelne Insight.
- Ist eine Verbindung automatisch nur lesend?
- Nein. Der dokumentierte Funktionsumfang enthält auch Änderungen. Legen Sie die erlaubten Aufgaben und Rechte gesondert fest.
- Sollte ich für den Test einen neuen Insight erstellen?
- Verwenden Sie möglichst einen vorhandenen Kontrollpunkt. Eine neue gespeicherte Auswertung ist eine zusätzliche Änderung und für den ersten Ergebnisabgleich nicht erforderlich.
Dokumentation gelesen am 3. Oktober 2026. Die beschriebenen Tests sind Vorschläge für Ihre eigene Umgebung.
- PostHog: MCP connection
Abrufbefehl anzeigen
curl -s https://posthog.com/docs/model-context-protocol - PostHog: VS Code setup
Abrufbefehl anzeigen
curl -s https://posthog.com/docs/model-context-protocol/vscode - PostHog: insights
Abrufbefehl anzeigen
curl -s https://posthog.com/docs/product-analytics/insights