DEEN
Erstgespräch buchen

Einrichten und betreiben

Matomo API, MCP und OAuth: Daten sicher an Werkzeuge und KI-Assistenten geben

Jeder Bericht in Matomo ist auch als Daten abrufbar, für BI-Werkzeuge, eigene Anwendungen und seit 2026 auch für KI-Assistenten über einen offiziellen MCP-Server. Hier steht, wie die Wege funktionieren, wie Sie Zugänge mit Tokens und OAuth so knapp wie möglich halten und was zu klären ist, bevor ein KI-Assistent Ihre Zahlen sieht.

Von Peter Boehlke

Stand: 8 Min. Lesezeit

Was Matomo in Berichten zeigt, liefert es auch als Daten: für ein Dashboard im BI-Werkzeug, für eine eigene Anwendung oder für einen KI-Assistenten, der Fragen zu Ihren Zahlen beantwortet. Der Zugang ist immer derselbe Gedanke: Ein Werkzeug weist sich gegenüber Matomo aus und bekommt genau die Rechte, die dahinterstehen. Wie knapp diese Rechte sind, entscheiden Sie.

Die Reporting API: jeder Bericht als Daten

Eine Anfrage an die Reporting API nennt die Methode, also den Bericht, die Website, den Zeitraum und das Format, etwa JSON, CSV, TSV oder XML. Segmente lassen sich mitgeben, mehrere Abfragen bündelt eine Sammelanfrage. Von Haus aus liefert Matomo 100 Zeilen je Bericht; wer alle will, sagt das ausdrücklich.

Damit Matomo weiß, wer fragt, braucht die Anfrage ein Token. Es ist so geheim wie ein Passwort und gehört nicht in die Adresse, wo es in Logdateien und im Browserverlauf landet. Seit Matomo 5.4 nimmt Matomo es im Kopf der Anfrage als Authorization: Bearer an, sonst im Inhalt einer POST-Anfrage. Neue Tokens sind seit Matomo 5 von Haus aus nur auf diesen sicheren Wegen gültig.

Eine Ausnahme kennt Matomo selbst: Werkzeuge, die ihre Anfragen per GET schicken, etwa der Connector für Looker Studio oder Matomo for WordPress, brauchen ein Token ohne diese Einschränkung.

Tokens: eines je Werkzeug

Tokens legen Sie in Matomo unter Administration > Persönlich > Sicherheit an, mit einer Beschreibung, wahlweise nur für sichere Anfragen und mit Ablaufdatum. Matomo schlägt 180 Tage vor und erinnert 30 Tage vor dem Ablauf. Angezeigt wird ein Token nur einmal; es gehört in einen Passwort-Manager.

  • Matomo 6: Tokens mit eigener Höchststufe. Beim Anlegen wählen Sie, welche Rechte das Token höchstens nutzen darf: Lesen, Schreiben, Admin oder Super User, nie mehr als der Nutzer selbst hat. Ein Token für ein Dashboard darf dann nur lesen, auch wenn sein Nutzer mehr darf. Bestehende Tokens behalten nach dem Update die Rechte ihres Nutzers.
  • Matomo 5 und älter: Ein Token hat die Rechte des Nutzers, der es anlegt. Für ein Werkzeug, das nur lesen soll, legen Sie deshalb einen eigenen Nutzer mit Leserechten an.
  • Tokens überleben Passwort und Anmeldung. Ein neues Passwort sperrt vorhandene Tokens nicht, und wer per LDAP oder SAML deaktiviert wird, behält laut Matomo seine Tokens. Beim Austritt gehören sie ausdrücklich gelöscht.
  • Eingebettete Berichte verlangen einen Zugang, der nur lesen darf: in Matomo 5 das Token eines Nutzers mit reinen Leserechten, in Matomo 6 auch ein Token mit der Höchststufe Lesen. Ein Token nur für sichere Anfragen geht dafür nicht, weil die Adresse eines eingebetteten Widgets das Token enthält.
Jedes Werkzeug mit eigenem Zugang: das BI-Werkzeug mit einem Token, das nur lesen darf, der KI-Assistent über OAuth mit kurzer Laufzeit. Matomo prüft bei jeder Anfrage, welche Rechte dahinterstehen.

OAuth 2.0: Zugriff ohne festes Token

Mit dem kostenlosen Plugin OAuth 2.0 von Matomo, in der Matomo Cloud schon enthalten, bekommen Werkzeuge statt eines dauerhaften Tokens kurzlebige Zugriffe. Ein Super User legt dafür unter Administration > Plattform > OAuth 2.0 einen Client an und legt fest, welche Rechte er höchstens bekommt.

  • Rechte als Scope: Lesen, Schreiben, Admin oder Super User. Der Scope des Clients ist die Obergrenze, die Stufe Super User ist von Haus aus nicht erlaubt.
  • Kurze Laufzeiten: Ein Zugriffstoken gilt von Haus aus eine Stunde, ein Token zur Erneuerung 30 Tage. Matomo empfiehlt, die Zugriffe kurz zu halten, etwa zehn Minuten.
  • Für Anwendungen und Dienste: mit Anmeldung des Nutzers über einen Freigabedialog oder als Dienst ohne Nutzer.

Der MCP-Server: Matomo im KI-Assistenten

Seit Mai 2026 gibt es von Matomo einen offiziellen MCP-Server. Über dieses Protokoll fragt ein KI-Assistent wie Claude, ChatGPT oder Microsoft Copilot Studio Matomo direkt ab und beantwortet Fragen zu Ihren Zahlen. Das Plugin MCP Server ist für Matomo On-Premise kostenlos, in der Matomo Cloud enthalten und in beiden Fällen zunächst ausgeschaltet.

  • Was der Assistent darf: Von Haus aus nur lesen: Websites, Berichte, Ziele, Segmente und Dimensionen. Den direkten Zugriff auf weitere API-Methoden schaltet ein Super User getrennt frei, nur lesend, für einzelne Arten von Änderungen oder ganz.
  • Wer ihn nutzen darf: Eine Höchststufe sperrt Nutzer, deren Rechte darüber liegen. Matomo empfiehlt einen eigenen Nutzer oder ein eigenes Token nur für den MCP-Zugang.
  • Wie er sich anmeldet: über OAuth, wo der Assistent es kann, sonst mit einem Token im Kopf der Anfrage, nie in der Adresse. Claude Desktop verbindet sich laut Matomo nur über OAuth.
  • Wer rechnet: Der MCP-Server liefert nur Daten; gedeutet werden sie vom Sprachmodell des Anbieters. Matomo rät, wichtige Zahlen in Matomo nachzuprüfen. Und auch lesende Abfragen können auf dem Server Berichte neu berechnen lassen.
So fragt ein KI-Assistent Matomo ab: über den MCP-Server mit eigenen Rechten, von Haus aus nur lesend. Die Antwort deutet das Sprachmodell des Anbieters, und was es abfragt, geht an diesen Anbieter.

Eine Sicherheitsfrage ist neu: Inhalte aus dem Tracking, etwa Seitentitel, Adressen, Kampagnenwerte oder Suchbegriffe, kann jeder Besucher beeinflussen. Matomo warnt, dass darüber Anweisungen an den Assistenten geschleust werden können. Analytics-Daten sind für einen KI-Assistenten deshalb fremde Eingaben, und Änderungen sollte er nur nach Rückfrage ausführen.

Datenschutz: was an den KI-Anbieter geht

Was der Assistent abfragt, geht an seinen Anbieter. Matomo nennt in seinen Hinweisen zum MCP-Server die Punkte, die vorher zu klären sind:

  • Sie bleiben verantwortlich, der KI-Anbieter wird Empfänger der Daten. Zu prüfen sind Vertrag, Auftragsverarbeitung und ob der Anbieter die Daten zum Training nutzt.
  • Personenbezogene Daten: Sammelt Matomo volle IP-Adressen, User IDs oder Adressen mit persönlichen Angaben, kann der Assistent darauf zugreifen, auch auf das Besucher-Log. Matomo rät dann zu einer Datenschutz-Folgenabschätzung und dazu, mit zusammengefassten Berichten zu arbeiten.
  • Transparenz: KI-Anbieter gehören in die Datenschutzerklärung, das Consent-Tool und das Verzeichnis der Verarbeitungstätigkeiten, Übermittlungen außerhalb des EWR sind zu prüfen.
  • Keine kostenlosen Versionen: Matomo rät, solche Daten nie mit öffentlichen oder kostenlosen Versionen von KI-Werkzeugen zu teilen.

Welche Einstellungen in Matomo dafür zählen, steht unter Matomo und Datenschutz. Die rechtliche Bewertung bleibt bei Ihrer Rechtsberatung.

BI, Exporte und die KI-Berichte in Matomo

  • Looker Studio: Matomo bietet einen kostenlosen Connector an, für die Matomo Cloud, On-Premise und Matomo for WordPress.
  • Power BI: Einen eigenen Connector gibt es nicht. Der Weg führt über die Reporting API oder, bei Matomo On-Premise, über einen lesenden Zugang zur Datenbank.
  • Rohdaten im Data Warehouse: In der Matomo Cloud gibt es dafür einen kostenpflichtigen Connector, On-Premise greifen Sie direkt auf die Datenbank zu.
  • Berichte per E-Mail: regelmäßig als HTML, PDF oder CSV, mehr dazu unter E-Mail-Berichte.

Nicht zu verwechseln mit dem MCP-Server sind die KI-Berichte in Matomo selbst: Im Lauf von Matomo 5 kamen Berichte zu Besuchen über KI-Assistenten, zu KI-Agenten und zu Zugriffen von KI-Chatbots dazu, seit Version 5.12 gesammelt unter AI Insights. Sie zählen, wie KI Ihre Website nutzt; der MCP-Server lässt eine KI Ihre Zahlen lesen.

So bleibt der Zugang im Griff

  • Ein Zugang je Werkzeug Eigenes Token oder eigener OAuth-Client, einzeln sperrbar.
  • Nur lesen Mit Höchststufe, Ablaufdatum und kurzen OAuth-Laufzeiten.
  • Token im Kopf der Anfrage Nie in der Adresse, nie in Chat oder Code.
  • KI bewusst angebunden Rechte je Einsatz, Datenschutzerklärung geprüft.

Typische Stolpersteine

  • Das Super-User-Token für alles Ein Leck öffnet die ganze Instanz.
  • Tokens ohne Ablauf Niemand weiß nach zwei Jahren, wer sie noch nutzt.
  • Austritt ohne Aufräumen Deaktivierte Nutzer behalten ihre Tokens.
  • Besucher-Log für den Assistenten Einzelne Besuche gehen an den KI-Anbieter.

Quellen

Stand: 13. November 2026, Matomo 5.14 und 6.0.0-rc1

FAQ

Häufige Fragen

Wie gebe ich das Token sicher mit?

Im Kopf der Anfrage als Authorization: Bearer, was Matomo seit Version 5.4 annimmt, oder im Inhalt einer POST-Anfrage. Nicht in der Adresse: Dort landet es in Logdateien und im Verlauf. Neue Tokens lässt Matomo seit Version 5 von Haus aus nur auf diesem sicheren Weg zu.

Brauche ich Matomo 6 für Tokens mit eigenen Rechten?

Für Tokens mit eigener Höchststufe ja. In Matomo 5 hat ein Token die Rechte seines Nutzers. Dort hilft ein eigener Nutzer, der nur lesen darf, und dessen Token geht an das Werkzeug.

Kostet der MCP-Server etwas?

Nein. Das Plugin MCP Server ist für Matomo On-Premise kostenlos, in der Matomo Cloud ist es enthalten. In beiden Fällen ist es zunächst aus und muss von einem Super User eingeschaltet werden. Kosten entstehen beim Anbieter des KI-Assistenten.

Darf ein KI-Assistent Besucherdaten sehen?

Technisch sieht er, was der Nutzer oder das Token sehen darf, also auch das Besucher-Log, wenn diese Rechte bestehen. Matomo rät, mit zusammengefassten Berichten statt einzelnen Besuchen zu arbeiten, und der KI-Anbieter wird Empfänger der Daten. Die rechtliche Bewertung bleibt bei Ihrer Rechtsberatung.

Fragen zu Ihrem Setup?

Im Erstgespräch schauen wir gemeinsam auf Ihre Situation.

Erstgespräch buchen

Newsletter

Matomo-Wissen, einmal im Monat.

Praxistipps zu Tracking, Datenschutz-Einstellungen und Performance, dazu Hinweise auf wichtige Matomo-Updates. Kein Spam, Abmeldung jederzeit.