SavignySavignyDocs
Erste Schritte

Matomo verbinden

API-Token erstellen, Zugriff eingrenzen und die Verbindung verwalten.

Einen API-Token vorbereiten

Melde dich in Matomo an und öffne die persönlichen Einstellungen. Die Token-Verwaltung findest du je nach Version unter Sicherheit → Authentifizierungstoken. Erstelle einen eigenen Token für Savigny. Verwende möglichst einen Matomo-Nutzer, der nur Lesezugriff auf die benötigten Websites hat, und beachte Ablaufdatum und Vorgaben deiner Installation.

Der Token übernimmt die Berechtigungen seines Matomo-Nutzers. Die zusätzliche Website-Auswahl in Savigny begrenzt, welche dieser Websites Savigny abfragen darf.

Token vertraulich behandeln

Gib den Token ausschließlich in der Savigny-Einrichtung ein. Er gehört weder in einen Chat noch in eine MCP-Konfigurationsdatei, einen Screenshot oder eine Support-Nachricht.

Verbindung einrichten

  1. Öffne Matomo-Einrichtung und melde dich bei Savigny an.
  2. Trage die Basis-URL ein, etwa https://analytics.example.com oder https://example.com/matomo. Verwende keine Reporting-URL mit Abfrageparametern.
  3. Gib den API-Token ein und prüfe die Verbindung.
  4. Wähle die Websites aus, die du mit Savigny verwenden möchtest.
  5. Speichere die Auswahl und öffne das Dashboard.

Savigny unterstützt eine Matomo-Verbindung pro Nutzer. Prüfe bei einer neuen Verbindung, ob du eine bestehende ersetzen möchtest.

Anforderungen an die Adresse

Die Installation muss öffentlich über HTTPS auf Port 443 erreichbar sein. Private Netzwerke, lokale Hostnamen, IP-Adressen als Host sowie URLs mit eingebetteten Zugangsdaten, Query oder Fragment werden abgewiesen. Verwende die endgültige Adresse; Weiterleitungen werden nicht verfolgt.

Token erneuern oder Verbindung trennen

Wenn dein Token abläuft oder widerrufen wird, aktualisiere die Verbindung in der Einrichtung und prüfe sie erneut. Beim Trennen wird der gespeicherte Verbindungsdatensatz gelöscht; neue Anfragen können diese Verbindung anschließend nicht mehr nutzen. Bereits laufende Anfragen können noch abschließen.

Das Entfernen eines KI-Clients und das Trennen von Matomo sind separate Schritte. Widerrufe bei Bedarf zusätzlich dessen OAuth-Freigabe und den Token in Matomo. Weitere Hinweise findest du unter Datenschutz und Zugriff.