DataFast MCP

Erste Schritte mit MCP

Verbinden Sie Ihren KI-Assistenten mit DataFast, um Fragen zu Traffic, Umsatz und benutzerdefinierten Zielen zu stellen oder autorisierte Website-Operationen zu verwalten. Sie benötigen ein DataFast-Konto mit API-Zugriff.

Verbindungsmethode wählen

Wählen Sie eine Methode. Beide verwenden Streamable HTTP zur Kommunikation mit DataFast.

• Mit OAuth anmelden — empfohlen für Clients, die OAuth-Anmeldung anbieten, einschließlich Codex und Claude Code. Wählen Sie Websites und Berechtigungen in DataFast; der Client verwaltet sein Verbindungstoken automatisch. Sie erstellen oder kopieren keinen API-Schlüssel.
• API-Token verwenden — für Clients, die ein Bearer-Token verlangen. Erstellen Sie ein eingeschränktes Kontotoken in DataFast und fügen Sie es der Konfiguration Ihres Clients hinzu.

Beide Methoden bieten dieselben DataFast-Tools. OAuth-Berechtigungen ermöglichen es Ihnen, Analytik, Website-Verwaltung, Kontofunktionen und Anmeldedatenverwaltung separat zu genehmigen. Siehe die Tool-Referenz für Details, was jede Methode unterstützt.

Mit OAuth verbinden

1. DataFast zu Ihrem Client hinzufügen

Fügen Sie einen Remote-MCP-Server mit der folgenden URL hinzu und wählen Sie OAuth oder Anmelden.

https://datafa.st/api/mcp

Für Codex fügen Sie den Server hinzu und schließen Sie die Browser-Anmeldung ab:

codex mcp add datafast --url https://datafa.st/api/mcp

Um sich später erneut anzumelden, führen Sie codex mcp login datafast aus. Sowohl Client-Metadaten-Dokumente als auch dynamische Registrierung werden unterstützt, einschließlich nativer Loopback-Callbacks. Wenn DataFast bereits mit einem Bearer-Token konfiguriert ist, entfernen Sie diese Anmeldedaten aus der DataFast-Konfiguration des Clients, bevor Sie zu OAuth wechseln.

Für Claude Code fügen Sie den Server hinzu, öffnen Sie dann /mcp in Claude Code und authentifizieren Sie DataFast:

claude mcp add --transport http datafast https://datafa.st/api/mcp

2. Anmelden und Zugriff genehmigen

1. Melden Sie sich auf datafa.st mit Ihrem bestehenden DataFast-Konto an.
2. Wählen Sie die Websites aus, auf die dieser Client zugreifen darf.
3. Überprüfen Sie die angeforderten Berechtigungen. Leseberechtigungen sind standardmäßig ausgewählt; aktivieren Sie Schreibzugriff nur, wenn der Client diese Änderungen vornehmen soll.
4. Wählen Sie Zugriff erlauben, um zu Ihrem Client zurückzukehren.

DataFast stellt dem Client ein Zugriffstoken für diese Verbindung aus. Der Client speichert es und aktualisiert es automatisch, solange die Verbindung gültig ist. Ihr DataFast-Passwort, Ihre Dashboard-Sitzung und bestehende API-Schlüssel werden nicht mit dem Client geteilt.

3. Ausprobieren

Starten Sie ein Gespräch mit aktiviertem DataFast und fragen Sie:

Listen Sie meine verfügbaren Websites auf und zeigen Sie dann Besucher und Umsatz für meine Website der letzten sieben Tage.

Bestätigen Sie die Website und den Datumsbereich, bevor Sie fortfahren. Ihr Plan und Ihre Berechtigungen gelten weiterhin.

Verwalten oder widerrufen Sie die Verbindung unter Einstellungen → API / MCP → Verbundene Apps. Verbinden Sie sich erneut, wenn DataFast Sie auffordert, den Zugriff erneut zu genehmigen, oder wenn Sie andere Websites oder Berechtigungen freigeben möchten.

Mit einem API-Token verbinden

Verwenden Sie diese Methode, wenn Ihr Client einen API-Schlüssel oder ein Bearer-Token verlangt. Für MCP beginnen Sie mit einem Kontozugriffstoken, das mit dft_ beginnt.

1. Kontotoken erstellen

1. Öffnen Sie Kontoeinstellungen → API / MCP.
2. Wählen Sie unter Neues Zugriffstoken die Option Bestimmte Websites, um den Zugriff einzuschränken, oder Alle Websites, wenn Ihr Workflow dies erfordert.
3. Wählen Sie nur die Berechtigungen aus, die Sie benötigen. Für eine Analytik-Verbindung beginnen Sie mit Websites → Lesen und Analytik → Lesen, wobei alle anderen Berechtigungen deaktiviert sind.
4. Geben Sie dem Token einen erkennbaren Namen, wählen Sie Token erstellen und kopieren Sie den dft_-Wert. Er wird nur einmal angezeigt.

2. Token zum Client hinzufügen

Verwenden Sie https://datafa.st/api/mcp und senden Sie das Token als Authorization: Bearer …-Header. Bewahren Sie es in den Anmeldedaten-Einstellungen des Clients oder in einer Umgebungsvariable auf, außerhalb von Versionskontrolle und Chat-Nachrichten.

Codex: Machen Sie Ihr Token als DATAFAST_TOKEN-Umgebungsvariable verfügbar und führen Sie dann aus:

codex mcp add datafast \
  --url https://datafa.st/api/mcp \
  --bearer-token-env-var DATAFAST_TOKEN

Claude Code: Ersetzen Sie dft_xxx durch Ihr Token:

claude mcp add --transport http datafast https://datafa.st/api/mcp \
  --header "Authorization: Bearer dft_xxx"

Cursor: Fügen Sie diesen Eintrag zu Ihrer mcp.json hinzu. Machen Sie DATAFAST_TOKEN in der Umgebung von Cursor verfügbar; Cursor erweitert die Umgebungsvariable beim Verbinden.

{
  "mcpServers": {
    "datafast": {
      "url": "https://datafa.st/api/mcp",
      "headers": {
        "Authorization": "Bearer ${env:DATAFAST_TOKEN}"
      }
    }
  }
}

Andere Clients: Geben Sie die Server-URL und das Bearer-Token in deren Remote-MCP-Einstellungen ein. Clients, die nur lokale stdio-Server unterstützen, benötigen eine Brücke wie mcp-remote.

3. Ausprobieren und Zugriff verwalten

Bitten Sie Ihren Client, Ihre verfügbaren Websites aufzulisten, und fordern Sie dann Besucher und Umsatz für eine Website der letzten sieben Tage an.

Verwalten Sie das Token unter Ihre Zugriffstokens in Kontoeinstellungen → API / MCP. Verwenden Sie Berechtigungen bearbeiten, um zu ändern, was es tun kann, Rotieren, um sein Geheimnis zu ersetzen, oder Löschen, um es zu widerrufen. Nach dem Rotieren eines Tokens aktualisieren Sie den Wert in Ihrem Client.

Haben Sie bereits einen df_-Website-API-Schlüssel? Der allgemeine MCP-Endpunkt akzeptiert auch diese, wobei der Zugriff an diese Website gebunden ist. Überprüfen Sie API-Authentifizierung für die unterstützten Operationen. Sie können ein Kontotoken auch mit Bestimmte Websites oben auf eine Website beschränken.

Wie der Zugriff begrenzt ist

Beide Methoden geben dem Client eine geheime Anmeldeinformation. OAuth automatisiert die Ausstellung und Erneuerung dieser Anmeldeinformation nach Ihrer Zustimmung; ein API-Token ist eine Anmeldeinformation, die Sie selbst erstellen und konfigurieren.

DataFast prüft die Anmeldeinformation, die erlaubte Aktion, den Website-Zugriff, die aktuelle Mitgliedschaft und geltende Konto- oder Planeinschränkungen auf dem Server. Eine Website-ID in einer Tool-Anfrage ist ein Ziel zur Prüfung, kein Beweis für Zugriff. Beispielsweise kann eine OAuth-Verbindung, die zum Lesen von Website A genehmigt wurde, Website B nicht lesen oder Website A bearbeiten.

OAuth-Verbindungen greifen nur auf genehmigte Websites zu. Eine Website, die über ein genehmigtes OAuth-Tool erstellt wurde, wird dieser Verbindung hinzugefügt; anderswo hinzugefügte Websites werden nicht automatisch geteilt. OAuth-Tokens laufen nach einer Stunde ab, aktualisieren sich automatisch bis zu 30 Tage ab Ausstellung und erfordern nach höchstens 90 Tagen eine neue Zustimmung. Im Dashboard erstellte Kontotokens bleiben gültig, bis Sie sie rotieren oder löschen, vorbehaltlich Ihres Kontozugriffs und Ihrer Berechtigungen. API-Schlüssel und Kontotokens, die über OAuth ausgestellt wurden, hängen auch von der Gültigkeit der ursprünglichen Verbindung ab.

OAuth-Tokens funktionieren nur an dem MCP-Endpunkt, für den sie ausgestellt wurden. Sie können nicht in die öffentliche REST-API eingefügt oder zur Anmeldung im DataFast-Dashboard verwendet werden. Kontotokens funktionieren auch mit den unterstützten REST-API-Endpunkten.

Sicherheit

• Mit begrenztem Zugriff beginnen. Geben Sie dem Client nur die Websites und Berechtigungen, die er benötigt. Kontofunktionen, Anmeldedatenverwaltung und vollständige Besucherdetails erfordern separate OAuth-Berechtigungen, die standardmäßig deaktiviert sind.
• Änderungen überprüfen. OAuth-Schreibtools erfordern Bestätigung und einen Wiederholungsschlüssel. API-Token-Tools erfordern Bestätigung für sensible Operationen wie das Löschen von Daten oder das Ausstellen von Anmeldedaten. Diese Prüfungen ergänzen die Bestätigungs-UI des Clients; sie ersetzen nicht die Wahl eines vertrauenswürdigen Clients.
• Anmeldedaten privat halten. Beide Methoden verwenden Bearer-Tokens: Wer ein gültiges Token erhält, kann dessen erlaubten Zugriff nutzen, bis es abläuft oder widerrufen wird. Geben Sie Anmeldedaten niemals in URLs, Versionskontrolle oder Chat-Nachrichten weiter.
• Bei Bedarf trennen. Das Widerrufen einer OAuth-Verbindung blockiert nachfolgende Anfragen und Aktualisierungen. Eine bereits laufende Anfrage kann abgeschlossen werden, und bereits mit der anderen App geteilte Daten werden durch den Widerruf nicht gelöscht.
• Nur-Dashboard-Operationen bleiben im Dashboard. MCP kann keine Websites löschen oder Zahlungsanbieter verbinden/trennen.