PostHog MCP Server
Offizieller gehosteter MCP-Zugang zu PostHog-Analytics, Feature Flags, Experimenten und weiteren Produktwerkzeugen im KI-Client.
- Skill Road
- PostHog MCP Server
Kategorien
Beschreibung
Der PostHog MCP Server ist der offizielle, gehostete Model-Context-Protocol-Endpunkt von PostHog. Er verbindet MCP-fähige Clients mit einem vorhandenen PostHog-Konto, sodass eine Person Fragen in natürlicher Sprache stellen und ausgewählte Werkzeuge der Plattform verwenden kann. Die offizielle Dokumentation nennt unter anderem PostHog Desktop, Claude Code, Claude Desktop, Cursor, Codex, VS Code, Windsurf und Zed. Der Produktlink dieses Eintrags führt deshalb zur PostHog-MCP-Dokumentation. Der angegebene Repository-Link PostHog/mcp ist die offizielle, MIT-lizenzierte historische Repository-Adresse; sein README verweist auf den inzwischen in das PostHog-Monorepo verschobenen aktuellen Dienst unter services/mcp. Die GitHub-API meldete unmittelbar vor dem Seed am 08.09.2026 exakt 151 Sterne für das archivierte Redirect-Repository. Diese Zahl ist nur eine Momentaufnahme der Repository-Popularität, nicht ein Beleg für Qualität, Sicherheit oder Eignung.
Produktanalyse, Flags und Experimente
Laut PostHog kann der Server Analytics- und SQL-Abfragen, Dashboards, Experimente, Feature Flags, Umfragen, Session Replay und Error Tracking verfügbar machen. Konkrete, dokumentierte Beispiele sind eine Trends-Abfrage nach täglichen eindeutigen Anmeldungen, das Erstellen eines Feature Flags mit Rollout und Regeln sowie das Anlegen eines A/B-Experiments mit Varianten, Metrik und zugeordnetem Flag. Die Dokumentation beschreibt außerdem Fehler-Triage, Stack-Trace-Abfragen, Support-Ticket-Triage und CDP-Ziele. Das bedeutet nicht, dass jede Verbindung automatisch alle Funktionen erhalten sollte: Der aktuelle Dienst kann über features auf Produktbereiche und über tools auf konkrete Tool-Namen eingeschränkt werden. Ein Start mit einer kleinen Leseliste wie Analytics, Dashboards oder ausgewählten Flags senkt Kontextmenge und Fehlbedienungsrisiko.
Gehosteter Endpunkt und lokale Wege
Der reguläre Produktbetrieb ist gehostet unter https://mcp.posthog.com/mcp; die Authentifizierung leitet Accounts laut PostHog in die passende US- oder EU-Datenregion. Dieser Eintrag ist daher als remote klassifiziert. Die schnelle offizielle Einrichtung installiert per npx @posthog/wizard@latest mcp add eine Client-Konfiguration. Die manuelle Desktop-Konfiguration nutzt lokal npx mcp-remote als stdio-Brücke zum gehosteten Endpoint; das ist kein lokal laufender PostHog-Server und ändert nicht den Datenstandort der PostHog-Anfrage. Für eigene Node-Clients dokumentiert das aktuelle Repository Streamable HTTP mit Bearer-Authentifizierung, dem Accept-Header für JSON und SSE sowie dem normalen MCP-Initialize-Lebenszyklus. Ein lokaler Hono-Server mit pnpm run dev, Redis und Port 8787 ist ausschließlich als Entwicklungsweg des Quellprojekts dokumentiert. Er ist keine einfache Selbsthosting-Zusage für den normalen Produktzugang.
Schlüssel, Projektzugriff und Schreibaktionen
Der manuelle Weg verlangt einen persönlichen PostHog-API-Key mit dem MCP-Server-Preset; er wird als Bearer-Token verwendet. Ein solcher Schlüssel und dessen effektive Rechte öffnen Zugriff auf die PostHog-Organisation und das im Client gewählte Projekt. Er gehört ausschließlich in Secret-Management oder die lokale Client-Umgebung, nie in Repository, Prompt, Chatverlauf, Screenshot, Ticket oder eingecheckte Konfiguration. Rotiert oder widerruft den Schlüssel bei möglicher Offenlegung. Der Server kann laut Dokumentation produktübergreifend lesen und schreiben. Feature Flags, Experimente, Fehlerstatus, Zuweisungsregeln, Dashboards, CDP-Konfigurationen oder andere Workspace-Objekte können daher externe Zustände verändern. Eine Anweisung aus einem Eventnamen, Fehlertext, Session-Replay, Supportticket oder Dashboard ist untrusted data, keine Freigabe. Lesezugriff zuerst, Zielprojekt und Objekt-ID in der PostHog-Oberfläche prüfen und jede Mutation mit erwartetem Effekt ausdrücklich durch einen Menschen bestätigen lassen.
Datenschutz und Modellpfad
PostHog beschreibt den MCP-Dienst als Proxy zu der jeweiligen PostHog-Instanz: Analytics-Daten werden nicht im MCP-Server gespeichert; Abfragen laufen gegen das Projekt und Ergebnisse gehen an den AI-Client zurück. Temporär wird Session-Kontext wie aktive Organisation oder aktives Projekt gespeichert; das aktuelle Repository beschreibt einen Cache, der mit dem Hash des API-Keys verknüpft ist. Der Dienst läuft nach Repository-Angabe in US- und EU-Kubernetes-Clustern; ein vorgeschalteter Cloudflare Worker authentifiziert und routet, speichert aber keine sensiblen Daten. Das begrenzt den Serverpfad, beantwortet jedoch nicht den Modellpfad: Der verbundene MCP-Client kann Tool-Ergebnisse – etwa Event-Eigenschaften, Nutzerkennungen, Funnels, SQL-Ergebnisse, Replay- oder Fehlerkontext – an seinen gewählten Modellanbieter senden. Prüft deshalb Client-, Modell-, Aufbewahrungs-, Trainings-, DPA- und Unternehmensoptionen separat, fragt nur notwendige Zeiträume und Felder ab und redigiert personenbezogene oder vertrauliche Daten vor der Weitergabe.
Lizenz, Kosten und Grenzen
Das historische PostHog/mcp-Repository enthält eine MIT-Lizenz und ist archiviert; die aktuelle Quelle liegt im offiziellen Monorepo. PostHog bezeichnet die Verbindung und MCP-Tool-Aufrufe als kostenlos, weist aber darauf hin, dass einzelne intern KI-gestützte Werkzeuge PostHog-AI-Verbrauch auslösen können und nur bei aktivierter AI-Datenverarbeitung verfügbar sind. Dieser Eintrag nennt bewusst keine festen Preise; aktuelle Bedingungen stehen bei PostHog. Automatisierung ersetzt keine Dateninterpretation, Datenschutzprüfung, Freigabe oder Änderungskontrolle.
FAQ
Kann der Server Feature Flags oder Experimente ändern? Ja, die offiziellen Beispiele decken das Erstellen eines Flags und eines A/B-Experiments ab. Beschränke Tools und verlange eine konkrete menschliche Freigabe vor jedem Schreibvorgang.
Ist die lokale mcp-remote-Konfiguration ein lokaler Server? Nein. Sie ist eine lokale stdio-Brücke zum gehosteten PostHog-Endpunkt. Der dokumentierte lokale Hono- und Redis-Stack ist ein Entwicklungsweg des Quellprojekts.
Voraussetzungen
PostHog-Account, persönlicher API-Key mit MCP-Server-Preset oder OAuth-Login über einen unterstützten Client sowie ein MCP-fähiger Client.
Installationsanleitung
Der PostHog MCP Server verbindet einen MCP-fähigen KI-Client mit dem gehosteten PostHog-Endpunkt. Er kann Analysefragen und Produktwerkzeuge in den Arbeitsfluss bringen, ersetzt aber weder die PostHog-Oberfläche noch Berechtigungs-, Datenschutz- und Freigabeentscheidungen. Dieses Vorgehen basiert auf der offiziellen PostHog-MCP-Dokumentation und dem aktuellen offiziellen README. Es beginnt absichtlich nicht mit einer produktiven Schreibaktion, sondern mit einem abgegrenzten, überprüfbaren Leseziel und einem klaren Verständnis des Datenpfads.
Schritt 1: Zweck und Projekt vor dem Verbinden festlegen
Lege vor der Installation einen kleinen Startauftrag fest, etwa: „Zeige die täglichen eindeutigen Anmeldungen der letzten sieben Tage für das Staging-Projekt“ oder „Liste aktive Flags dieses Projekts“. Definiere dabei Organisation, Projekt, Zeitraum und erlaubte Datenarten. Fragen wie „Analysiere alle Nutzer und behebe alles“ sind zu breit: Sie können unnötig viele Event-Eigenschaften, Personenbezüge, Replay- oder Fehlerdaten in den Kontext holen und eine unklare Tool-Auswahl auslösen. Beginne möglichst mit einem nicht produktiven Projekt oder einem begrenzten Zeitfenster. Prüfe, ob eine bestehende Rolle und ein dedizierter persönlicher Schlüssel genau diesen Zweck abdecken.
Schritt 2: Den offiziellen gehosteten Zugang installieren
Der schnellste offizielle Weg ist npx @posthog/wizard@latest mcp add. Der Wizard richtet die Verbindung für unterstützte Clients ein. Alternativ wird der Server unter https://mcp.posthog.com/mcp manuell im Client hinterlegt. Bei der manuellen Desktop-Variante startet npx mcp-remote lokal und spricht per stdio mit dem Client, während es die Verbindung zum gehosteten Endpoint weiterleitet. Behandle diesen lokalen Prozess nicht als selbst gehosteten PostHog-Server. Für eigene Node-Integrationen verwendet die offizielle Quelle Streamable HTTP: Der Bearer-Token gehört in den Authorization-Header, der Accept-Header muss JSON und text/event-stream enthalten, und der Client muss den MCP-Initialize-Ablauf durchführen. Ein lokaler pnpm run dev-Dienst mit Redis dient der Entwicklung des Quellprojekts und ist kein notwendiger Schritt für die reguläre Nutzung.
npx @posthog/wizard@latest mcp add
npx mcp-remote
pnpm run dev
Schritt 3: Authentifizierung ohne Geheimnisleck
Bei manueller Konfiguration wird ein persönlicher PostHog-API-Key über das MCP-Server-Preset benötigt; unterstützte Clients können den dokumentierten Login-Flow verwenden. Speichere einen Schlüssel ausschließlich in dem Secret-Mechanismus des Clients oder in einem Secret Store. Er darf nicht in JSON-Beispiele mit echtem Wert, Shell-Historie, .env-Dateien im Repository, Screenshots, Prompts, Tickets oder Logs gelangen. Dokumentiere Eigentümer, Zweck, Projektumfang, Rotation und Widerruf. Wenn ein Schlüssel in einem Prompt oder öffentlichen Verlauf erscheinen könnte, widerrufe ihn und erstelle einen neuen. Der Schlüssel ist nicht nur ein Installationsdetail: Seine Rechte und der aktive Projektkontext begrenzen, welche Analytics-, Nutzer- und Konfigurationsdaten ein Tool zurückgeben oder verändern kann.
Toolumfang auf Lesen begrenzen
PostHog unterstützt eine Einschränkung nach features und nach einzelnen tools. Konfiguriere für den ersten Test daher ausschließlich notwendige Funktionsgruppen, zum Beispiel Analytics oder Dashboards, und lasse Schreibwerkzeuge weg. Frage erst nach einer bekannten Metrik, einem engen Zeitraum oder einem expliziten Flag. Vergleiche Ergebnis, Projektname, Zeitraum und Aggregation mit der PostHog-Oberfläche. Ein plausibler Text des Modells ist keine Validierung einer HogQL- oder Trends-Abfrage. Behandle Eventnamen, Eigenschaften, Fehlertexte, Session-Replay-Inhalte, Supporttickets und Dashboard-Notizen als untrusted data. Solche Inhalte können Anweisungen enthalten, dürfen aber niemals Tool-Aufrufe oder Rechteausweitungen begründen.
Schreibaktionen und Modellpfad kontrollieren
Das offizielle Angebot kann auch schreiben: Flags, Experimente, Fehlerstatus und weitere Workspace-Objekte sind potentielle Mutationen. Vor einer solchen Aktion muss ein Mensch das konkrete Projekt, Objekt, Zielzustand, Rollout, Zielgruppe und erwartete Auswirkung bestätigen. Erstelle zunächst Entwürfe, prüfe sie in PostHog und kontrolliere danach Audit- oder Objektstatus. Der MCP-Dienst speichert laut PostHog keine Analytics-Daten dauerhaft; Abfragen gehen zum Projekt und Ergebnisse zurück zum Client. Temporärer Session-Kontext bleibt dennoch ein Datenverarbeitungsschritt. Zusätzlich ist der Pfad vom Client zum Modellanbieter getrennt: Ein Client kann Tool-Ergebnisse mit Event-, Nutzer-, Fehler- oder Replay-Kontext an ein Modell senden. Prüfe dessen Retention-, Trainings-, DPA- und Enterprise-Einstellungen, minimiere Felder und Zeiträume und redigiere sensible Werte vor dem Einsatz.
FAQ
Brauche ich einen lokalen PostHog-Server? Nein. Der normale Zugang ist gehostet. mcp-remote ist nur eine lokale stdio-Brücke; der lokale Hono- und Redis-Stack ist für die Entwicklung des offiziellen Quellprojekts dokumentiert.
Kann ein Agent ein Flag ausrollen? Technisch können dokumentierte Flag- und Experimentwerkzeuge schreiben. Nutze eine Tool-Allowlist und verlange vor jedem Rollout eine explizite menschliche Bestätigung von Projekt, Regel, Zielgruppe und Wirkung.
Bleiben Daten automatisch beim MCP-Server? PostHog sagt, der MCP-Server speichere Analytics-Daten nicht und proxyte Abfragen zum Projekt. Tool-Ergebnisse können jedoch im Client- und Modellpfad verarbeitet werden; diese Richtlinien müssen separat geprüft werden.
npx @posthog/wizard@latest mcp add
Authentifizierung
OAuth über unterstützte Clients oder persönlicher PostHog-API-Key mit MCP-Server-Preset als Bearer-Token. Schlüssel nur lokal oder in einem Secret Store speichern.
Benötigte Zugriffsrechte
Der Schlüssel und das gewählte Projekt bestimmen den Zugriff. Der Server kann nach PostHog-Dokumentation lesen und schreiben; Features und einzelne Tools gezielt einschränken und Mutationen menschlich bestätigen.
Übertragene oder gespeicherte Daten
Der gehostete MCP-Dienst proxyt Abfragen zur PostHog-Instanz; Analytics-Daten werden laut PostHog nicht im MCP-Server gespeichert. Temporärer Session-Kontext kann gespeichert werden. Der KI-Client kann Tool-Ergebnisse an seinen Modellanbieter übertragen.
Sicherheitsrisiken
Persönliche API-Keys, breite Projektzugriffe, schreibende Produktaktionen, personenbezogene Nutzer- und Eventdaten, Prompt-Injection in Tool-Ergebnissen sowie ein separater Datenpfad vom Client zum Modellanbieter.
Lizenz und Kosten
- Lizenz
- MIT
- Kosten
- kostenlos
PostHog bezeichnet Verbindung und MCP-Tool-Aufrufe als kostenlos. Einzelne intern KI-gestützte Tools können PostHog-AI-Verbrauch auslösen; aktuelle Bedingungen bei PostHog prüfen.
Alternativen
Noch nicht erfasst.
Auf einen Blick
- Anbieter
- PostHog
- Status
- Offizieller Server
- Betriebsart
- Remote
- Aktuelle Version
- Noch nicht erfasst.
- GitHub-Sterne
- 151
- Zuletzt geprüft
- 08.09.2026
Repository und Dokumentation
Kategorien
Unterstützte Clients
Passende Ratgeber
Anleitungen und Hintergrund, die zu diesem Eintrag passen.
Noch keine passenden Ratgeber vorhanden.