Amplitude MCP Server
Offizieller Amplitude-MCP für Analytics, Experimente und Nutzerdaten per natürlicher Sprache im KI-Client.
- Skill Road
- Amplitude MCP Server
Kategorien
Beschreibung
Der Amplitude MCP Server ist die offizielle Model-Context-Protocol-Integration von Amplitude. Er macht Amplitude-Analytics, Taxonomie, Dashboards, Experimente, Feature Flags, Kohorten und Session Replays aus MCP-fähigen KI-Clients heraus zugänglich. Laut offizieller Amplitude-Dokumentation können Nutzer Charts abfragen, Ad-hoc-Segmentierungen durchführen, Funnel- und Retention-Analysen starten, Experiment-Ergebnisse auswerten und Tracking-Plan-Definitionen verwalten — alles ohne die Amplitude-Oberfläche zu öffnen oder SQL zu schreiben.
Der Server läuft als gehosteter Remote-Dienst. Die offizielle Dokumentation nennt zwei regionale Endpunkte: https://mcp.amplitude.com/mcp für den US-Standard und https://mcp.eu.amplitude.com/mcp für EU-Datenspeicherung. Die Authentifizierung erfolgt über OAuth 2.0. Der Server respektiert dabei die bestehenden Amplitude-Berechtigungen des angemeldeten Nutzers: Wer in Amplitude selbst keinen Zugriff auf ein Projekt hat, kann es auch über den MCP-Client nicht abrufen.
Analytics und Datenabfragen
Laut Amplitude-Dokumentation bietet der MCP Server umfangreiche Analysetools. query_chart ruft Daten aus bestehenden Charts ab, query_experiment analysiert A/B-Test-Ergebnisse inklusive statistischer Signifikanz, query_dataset führt individuelle Analytics-Abfragen aus und query_metric gibt Daten zu einzelnen Metriken zurück. Das search-Tool findet Dashboards, Charts, Notebooks und Experimente per Freitextsuche.
Für Content-Zugriff dokumentiert die Quelle get_charts zum Abrufen vollständiger Chart-Definitionen, get_dashboard für Dashboard-Inhalte und -Layout sowie get_notebook für Notebooks mit eingebetteten Charts und Analysen. get_experiments liefert detaillierte Experiment-Informationen, get_flags gibt Feature-Flag-Konfigurationen zurück.
Taxonomie und Tracking-Plan-Verwaltung
Ein besonderer Schwerpunkt liegt auf der Tracking-Plan-Verwaltung. Die Amplitude-Dokumentation beschreibt Write-Tools für Taxonomie-Operationen: manage_amp_events erstellt, aktualisiert, löscht und stellt Events, Custom Events und Labeled Events wieder her; außerdem können neu auftauchende, nicht geplante Events in den Tracking Plan aufgenommen werden. create_properties legt Event-, User- oder Gruppen-Properties an, update_properties aktualisiert deren Metadaten. manage_amp_data_taxonomy steuert den Branch-Workflow für Tracking-Plan-Branches: Erstellen, Aktualisieren, Zusammenführen, Löschen, Überprüfen und Aktualisieren von Zweigen.
Laut Dokumentation erfordern Schreiboperationen die RBAC-Aktion „Use MCP (write)". Diese Berechtigungsstufe ist von Organisations-Administratoren steuerbar, was eine granulare Zugriffskontrolle auch innerhalb des MCP-Zugangs ermöglicht.
Session Replay und Nutzereinblicke
get_session_replays ermöglicht das Suchen und Filtern von Session-Recordings anhand von Kriterien. Damit lassen sich Nutzersitzungen mit bestimmten Ereignissen, Fehlern oder Verhaltensmustern finden, ohne die Amplitude-Oberfläche aufzurufen. get_event_properties erkundet Event-Property-Definitionen, get_context gibt Nutzer- und Organisationsinformationen zurück.
Die offizielle Dokumentation beschreibt außerdem Progressive Tool Discovery: Durch Hinzufügen von ?discovery=progressive zur Server-URL startet der Client mit einer minimalen Toolmenge und entdeckt Werkzeuge bedarfsgesteuert. Das reduziert Token-Verbrauch in lang laufenden Agenten-Sessions.
Sicherheit, Datenzugriff und Abgrenzungen
Alle Anfragen über den Amplitude MCP Server verlassen die lokale Maschine und werden über die Amplitude-Cloud verarbeitet. Die Dokumentation hält fest: „Third-party AI models process your data during analysis." Das bedeutet, Prompt, Tool-Aufruf, Ergebnis und Datenbankabfragen können an den gewählten KI-Modellanbieter (z. B. Anthropic, OpenAI, Google) und an die Amplitude-API weitergegeben werden. Prüfe die Datenschutz- und Aufbewahrungsrichtlinien beider Anbieter, bevor vertrauliche Kundendaten in Abfragen fließen.
Laut Dokumentation ist der Amplitude MCP Server ausschließlich ein Lese- und Schreibwerkzeug für Analytics-Inhalte — kein Event-Ingestion-Endpunkt. Produktions-Events müssen weiterhin über ein Amplitude-SDK oder die HTTP-V2-API eingespielt werden. Das Tool manage_amp_events registriert Eventdefinitionen im Tracking Plan, sendet aber keine Eventdaten.
Organisations-Administratoren können den MCP-Zugriff über RBAC-Rollen einschränken. Die Dokumentation beschreibt zwei separate Rollen: eine für Lesezugriff und eine für Schreiboperationen. Das ermöglicht es, bestimmten Nutzergruppen ausschließlich lesenden oder vollständigen MCP-Zugriff zu gewähren. Für scoped MCP-Zugriff empfiehlt die Dokumentation, Rollen gezielt zu vergeben statt organisationsweiten Zugang zu aktivieren.
Der Server befindet sich laut README und Dokumentation noch in der Beta-Phase. Amplitude weist darauf hin, dass nicht alle Funktionen verfügbar sein könnten und Rate Limits gelten. Plane für produktionskritische Analytik-Workflows entsprechende Fehlerbehandlungen ein.
AI Context und Referenzdateien
Die Amplitude-Dokumentation beschreibt das Tool get_amplitude_context: Es gibt beim Aufruf mit einer Projekt-ID die organisationsspezifische AI-Context-Konfiguration zurück — Metrikdefinitionen, Terminologie und Geschäftsregeln, die der Nutzer in den Amplitude-AI-Controls hinterlegt hat. Die Dokumentation empfiehlt, dieses Tool zu Beginn einer Session aufzurufen, damit der KI-Client mit den korrekten Metriken und Begriffen arbeitet.
Für repo-seitige Instrumentierungskonventionen dokumentiert Amplitude eine optionale Datei .amplitude/instrumentation-agent-context.md im Repository-Root. Marketplace-Skills wie instrument-events lesen diese Datei automatisch.
Das öffentliche GitHub-Repository amplitude/mcp-server-guide enthält ausschließlich eine Anleitung und eine README; es besteht kein öffentliches Open-Source-Repository des eigentlichen MCP-Servers. Die GitHub API meldete am 08.09.2026 exakt 45 Sterne. Diese Zahl ist ein Popularitätssignal für das Guide-Repository, kein Qualitätsbeweis für den gehosteten Dienst.
FAQ
Kann der Amplitude MCP Server Events einspielen? Nein. Laut offizieller Dokumentation ist der MCP Server kein Ingestion-Endpunkt. Für Event-Tracking sind ein Amplitude-SDK oder die HTTP-V2-API zu verwenden.
Muss eine neue Amplitude-Lizenz erworben werden? Laut Dokumentation kann jeder bestehende Amplitude-Kunde den MCP Server aus einem kompatiblen Client nutzen. Prüfe die aktuellen Account-Bedingungen direkt bei Amplitude.
Können andere Nutzer auf meine Daten zugreifen? Nein. Der Server respektiert die bestehenden Amplitude-Berechtigungen. Organisationsadministratoren steuern den MCP-Zugriff zusätzlich per RBAC.
Welcher Endpoint ist für EU-Datenspeicherung korrekt? Die Dokumentation nennt https://mcp.eu.amplitude.com/mcp für EU-Residency.
Voraussetzungen
Ein bestehender Amplitude-Account, ein MCP-fähiger KI-Client mit OAuth-Unterstützung und die entsprechenden Projektberechtigungen in Amplitude.
Installationsanleitung
Der Amplitude MCP Server bringt Amplitude-Analytics, Dashboards, Experimente, Feature Flags und Tracking-Plan-Tools in einen MCP-fähigen KI-Client. Die offizielle Dokumentation nennt zwei regionale Remote-Endpunkte: https://mcp.amplitude.com/mcp für den US-Standard und https://mcp.eu.amplitude.com/mcp für EU-Datenspeicherung. Keine lokale Installation ist erforderlich — die Verbindung erfolgt per OAuth 2.0 aus dem Client heraus.
Schritt 1: Vor dem Verbinden: Aufgabe und Berechtigungen klären
Stelle vor der Einrichtung sicher, dass du in Amplitude Zugriff auf die relevanten Projekte hast. Der MCP Server übernimmt ausschließlich die Berechtigungen des angemeldeten Amplitude-Nutzers; es gibt keinen eigenständigen Service-Account. Wenn du Schreiboperationen — also das Anlegen oder Ändern von Events, Properties, Branches oder Dashboards — nutzen möchtest, muss ein Organisations-Administrator dir die RBAC-Aktion „Use MCP (write)" zuweisen. Für reine Leseaufgaben reicht der Lesezugriff.
Überlege vorab, welche Daten in den KI-Client fließen sollen. Laut Amplitude-Dokumentation verarbeiten Drittanbieter-KI-Modelle die Daten während der Analyse. Anfragen, Ergebnisse und Chart-Daten können also an den Modellbetreiber des verwendeten Clients weitergegeben werden. Für sensible Kundendaten oder regulierte Informationen prüfe die Datenschutzrichtlinien von Amplitude und dem gewählten Modellanbieter, bevor du diese in Abfragen einbeziehst.
Schritt 2: Den Remote MCP per OAuth verbinden
Öffne die MCP-Konfiguration des gewählten Clients und trage die regionale Server-URL ein. Für den US-Standard: https://mcp.amplitude.com/mcp. Für EU-Datenspeicherung: https://mcp.eu.amplitude.com/mcp. Der Client öffnet daraufhin einen OAuth-2.0-Autorisierungs-Dialog. Melde dich mit dem Amplitude-Konto an, das Zugriff auf die relevanten Projekte hat, und erteile die angefragten Berechtigungen. Nach erfolgreichem Abschluss ist der MCP Server aktiv.
In Claude Code beschreibt die offizielle Dokumentation beispielsweise HTTP-Transport und einen browserbasierten OAuth-Ablauf. Cursor, ChatGPT und andere kompatible Clients folgen ihren jeweiligen MCP-Konfigurationsschritten. Consult the documentation of your specific client for the exact configuration steps.
Falls du Token-Kosten reduzieren möchtest, dokumentiert Amplitude den Progressive-Discovery-Modus: Hänge ?discovery=progressive an die URL an — also etwa https://mcp.amplitude.com/mcp?discovery=progressive. In diesem Modus startet der Client mit einem minimalen Toolset und entdeckt weitere Tools bedarfsgesteuert per list_tool_categories und get_category_tools.
Den AI Context für bessere Ergebnisse nutzen
Die offizielle Dokumentation empfiehlt, zu Beginn jeder Session get_amplitude_context mit einer Projekt-ID aufzurufen. Dieses Tool gibt die in den Amplitude-AI-Controls hinterlegten Konfigurationen zurück: Metrikdefinitionen, Terminologie und Geschäftsregeln deiner Organisation. Wenn der KI-Client diese Informationen kennt, arbeitet er bei Folgeabfragen mit den korrekten Begriffen und Metriken — was Missverständnisse über Definitionen reduziert.
Organisationsadministratoren können AI Context im Amplitude-Dashboard unter AI Controls konfigurieren: Markdown-Textanweisungen und hochgeladene Referenzdokumente. Die Textanweisungen gibt get_amplitude_context zurück; hochgeladene Dateien sind für in-product Agents verfügbar, aber nicht direkt über MCP-Tools abrufbar. Lege daher Regeln und Definitionen, die der MCP-Client kennen soll, als Textanweisungen an.
Schritt 3: Erste Abfragen und typische Workflows
Beginne mit einer einfachen Suchabfrage: „Finde alle Dashboards zum Thema Onboarding." Damit testest du die Verbindung und siehst, auf welche Projekte der Client zugreifen kann. Probiere anschließend query_chart für einen bekannten Chart oder get_dashboard für ein vorhandenes Dashboard.
Ein typischer Analyse-Workflow laut Amplitude-Dokumentation: Suche mit search nach relevantem Content, rufe Chart-Definitionen mit get_charts ab, führe individuelle Abfragen mit query_dataset durch und stelle Folgefragen auf Basis der Ergebnisse. Für Experimente: get_experiments gibt Metadaten zurück, query_experiment die statistischen Ergebnisse.
Für Session Replay: get_session_replays mit Filterkriterien wie Eventname, Nutzerattribut oder Zeitraum. Das Ergebnis enthält passende Sitzungs-IDs und Metadaten, die du direkt im Amplitude-Interface öffnen kannst.
Schreiboperationen: Tracking-Plan verwalten
Wenn du die RBAC-Aktion „Use MCP (write)" hast, kannst du Tracking-Plan-Änderungen vornehmen. Nutze manage_amp_data_taxonomy, um einen Branch zu erstellen, bevor du Eventdefinitionen änderst — so bleiben Änderungen trennbar und überprüfbar. manage_amp_events legt neue Events an oder aktualisiert bestehende. create_properties und update_properties verwalten Eigenschaften.
Wichtig: Diese Tools ändern Tracking-Plan-Definitionen in Amplitude Data. Sie senden keine Produktions-Events. Für das Senden von Events nutze ein Amplitude-SDK oder die HTTP-V2-API.
Sicherheit, Rate Limits und Beta-Status
Der Amplitude MCP Server befindet sich laut README und Dokumentation noch in der Beta-Phase. Rate Limits sind dokumentiert und können sich ändern. Plane für Produktions-Workflows entsprechende Fehlerbehandlung ein und teste neue Funktionen zunächst in einer Testumgebung.
Organisationsadministratoren können den MCP-Zugriff über AI Controls im Amplitude-Dashboard einschränken. Die Dokumentation beschreibt eine separate RBAC-Rolle für Schreiboperationen. Aktiviere Schreibzugriff nur für Nutzer, die ihn tatsächlich benötigen. Für Teams empfiehlt es sich, zunächst nur Lesezugriff zu aktivieren und Schreiboperationen gezielt freizugeben.
Amplitude-Analysedaten — darunter Nutzersegmente, Ereignisvolumen und Experiment-Ergebnisse — sind sensible Produktdaten. Sie sollten nicht in öffentliche Chats, Screenshots oder nicht autorisierte Systeme gelangen. Prüfe nach jeder Einrichtung, welche Daten der Client tatsächlich abrufen kann, und begrenze Abfragen auf das Notwendige.
FAQ
Welcher Endpoint ist für EU-Datenspeicherung korrekt? Die Dokumentation nennt https://mcp.eu.amplitude.com/mcp.
Kann ich den MCP Server für Event-Tracking nutzen? Nein. Laut offizieller Dokumentation ist der MCP Server kein Ingestion-Endpunkt. Verwende für Produktions-Events ein Amplitude-SDK oder die HTTP-V2-API.
Was ist der Progressive-Discovery-Modus? Das Anhängen von ?discovery=progressive an die Server-URL reduziert die initial übertragene Toolmenge. Der Client entdeckt Tools bedarfsgesteuert, was Token-Kosten senkt.
Brauche ich eine spezielle Amplitude-Lizenz? Laut Dokumentation können alle bestehenden Amplitude-Kunden den MCP Server nutzen. Prüfe Account-Limits und Konditionen direkt bei Amplitude.
Authentifizierung
OAuth 2.0. Der Server übernimmt die bestehenden Amplitude-Berechtigungen des angemeldeten Nutzers. Organisations-Administratoren steuern MCP-Zugriff via RBAC-Rollen.
Benötigte Zugriffsrechte
Zugriff ist auf die Amplitude-Projekte und Daten begrenzt, für die der angemeldete Nutzer in Amplitude selbst berechtigt ist. Schreibzugriff erfordert die RBAC-Aktion „Use MCP (write)".
Übertragene oder gespeicherte Daten
Anfragen und Antworten werden über die Amplitude-Cloud verarbeitet. Laut Anbieter verarbeiten Drittanbieter-KI-Modelle die Daten während der Analyse. Prüfe Datenschutz- und Aufbewahrungsrichtlinien von Amplitude und dem gewählten Modellbetreiber.
Sicherheitsrisiken
Amplitude-Analysedaten und Nutzerdaten gelangen in den Kontext des verbundenen KI-Clients und Modells. Der MCP-Zugriff ist per RBAC kontrollierbar. Beta-Status: Rate Limits und fehlende Features möglich.
Lizenz und Kosten
- Lizenz
- Noch nicht erfasst.
- Kosten
- kostenpflichtig
Der MCP Server steht laut Dokumentation allen bestehenden Amplitude-Kunden zur Verfügung. Kosten und Account-Limits richten sich nach dem bestehenden Amplitude-Plan. Dieser Eintrag nennt keine konkreten Preise; prüfe diese direkt bei Amplitude.
Alternativen
Noch nicht erfasst.
Auf einen Blick
- Anbieter
- Amplitude
- Status
- Offizieller Server
- Betriebsart
- Remote
- Aktuelle Version
- Noch nicht erfasst.
- GitHub-Sterne
- 48
- 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.