AI Data Stream verwenden

Eigene KI verbinden (MCP)

Nutzen Sie Ihre AIdata-Properties aus claude.ai, Claude Desktop, Claude Code, Cursor oder jedem MCP-kompatiblen KI-Client - mit einem einzigen persönlichen Token.

Externer KI-Zugriff lässt Sie Ihre AIdata-Properties aus Ihrem eigenen KI-Assistenten nutzen - claude.ai, Claude Desktop oder jedem Client, der MCP (Model Context Protocol) unterstützt. Ihr Assistent bekommt dieselben Daten-Tools wie der integrierte Chat, und die Nutzung ist durch das KI-Abo abgedeckt, das Sie bereits bezahlen. Ganz ohne API-Schlüssel.

Voraussetzungen

  • Ihr Team ist auf einem Pro- oder Business-Tarif.
  • Ein Team-Eigentümer hat den Externen KI-Zugriff in den Team-Einstellungen aktiviert. Er ist standardmäßig ausgeschaltet.
  • Für claude.ai erfordern benutzerdefinierte Connectors einen bezahlten Claude-Tarif. Claude Desktop und andere MCP-Clients funktionieren mit dem Tarif, den sie ohnehin benötigen.

Einrichtung

1. Externen Zugriff aktivieren (Team-Eigentümer, einmal pro Team)

Gehen Sie zu den Team-Einstellungen und schalten Sie den Externen KI-Zugriff ein. Das ist der Hauptschalter für das ganze Team: Solange er aus ist, erreicht kein Connector eines Mitglieds die Properties dieses Teams.

2. Ihre persönlichen Verbindungsdaten abrufen

Gehen Sie zu Einstellungen → Verbundene KI und klicken Sie auf Meine Verbindungsdaten anzeigen. Sie erhalten drei Werte:

  • Server-URL - der MCP-Endpunkt von AIdata, https://app.aidata.stream/mcp/u. Sie ist für alle gleich und enthält kein Geheimnis.
  • Authorization-Header - Bearer gefolgt von Ihrem persönlichen Token. Das ist, was Sie identifiziert.
  • Verbindungs-URL, unter Clients, die nur eine URL akzeptieren - derselbe Endpunkt mit Ihrem Token in der Adresse, für Clients ohne Eingabemöglichkeit für einen Header.

Ihr Token ist persönlich: Es identifiziert Sie, deckt jede Property ab, auf die Sie über alle Ihre Teams hinweg Zugriff haben, und setzt Ihre Berechtigungen pro Property durch. Jedes Teammitglied bekommt sein eigenes Token - teilen Sie Ihres niemals.

Behandeln Sie Token und URL wie ein Passwort. Wer eines davon hat, kann jede Property lesen, auf die Sie Zugriff haben, und Annotationen in Ihrem Namen schreiben. Falls eines je durchsickert, klicken Sie auf Token neu generieren - jede Kopie von Token und URL hört sofort auf zu funktionieren, Ihre Teamkollegen bleiben unberührt.

3. Zu Ihrem KI-Client hinzufügen

Verwenden Sie die Header-Form überall dort, wo Ihr Client Request-Header unterstützt. Das Token erscheint dann nie in einer URL und bleibt aus Server-Logs, Proxys und dem Browserverlauf heraus.

claude.ai und Claude Desktop: Settings → Connectors → Add custom connector. Geben Sie einen Namen ein (z. B. „AIdata“) und fügen Sie die Server-URL ein. Wählen Sie unter Authentication die Option No sign-in - claude.ai markiert Sign in now womöglich als „Detected“, das ist aber nur seine Vermutung für jeden Server, der Zugangsdaten verlangt; dieser Connector nutzt ein Token, kein OAuth. Wählen Sie das zuerst: Der Abschnitt OAuth client verschwindet und Request headers wird zum Abschnitt für die Zugangsdaten. Klicken Sie auf Add header, wählen Sie authorization als Namen und fügen Sie den Wert Authorization-Header aus der App (Bearer …) als Wert ein, lassen Sie Required angehakt, dann speichern Sie.

Claude Code:

claude mcp add --transport http aidata https://app.aidata.stream/mcp/u \
  --header "Authorization: Bearer <Ihr Token>"

Cursor und andere MCP-Clients: Fügen Sie einen Remote-MCP-Server (HTTP) mit der Server-URL und einem Request-Header Authorization: Bearer <Ihr Token> hinzu.

Clients, die nur eine URL akzeptieren: Fügen Sie stattdessen die Verbindungs-URL als Server-URL ein. Kein Header nötig - die URL selbst gewährt den Zugriff - aber das Token reist in der Adresse mit: Behandeln Sie jede Stelle, an der Sie sie einfügen, wie eine Kopie Ihres Passworts.

4. Loslegen

Stellen Sie im Chat sicher, dass der Connector im Tools-Menü aktiviert ist, und fragen Sie einfach. Guter erster Prompt: „Liste meine AIdata-Properties auf.“ Die KI entdeckt Ihre Properties, sieht, welche Datenquellen jede verbunden hat, und wählt für Folgefragen die richtige aus.

Anmelden statt Token

Clients, die OAuth unterstützen, können sich ohne Kopieren eines Tokens verbinden. Verwenden Sie die Server-URL https://app.aidata.stream/mcp (ohne /u) und melden Sie sich mit Ihrem AIdata-Konto an, wenn der Client danach fragt. AIdata zeigt eine Zustimmungsseite, Zugriff auf AIdata erlauben, die die Anwendung nennt und was sie tun kann. Klicken Sie auf Zugriff erlauben, und Sie werden zum Client zurückgeleitet. Die Verbindung hat dann genau den Zugriff, den Ihr Token hätte: dieselben Properties, dieselben Berechtigungen, dieselben Schreibregeln.

  • claude.ai und Claude Desktop: Fügen Sie den benutzerdefinierten Connector mit dieser URL hinzu und wählen Sie Sign in now.
  • Claude Code: claude mcp add --transport http aidata https://app.aidata.stream/mcp, dann in einer Sitzung /mcp ausführen und für aidata Authenticate wählen. Ihr Browser öffnet die Zustimmungsseite.
  • Der Zugriff endet von selbst nach 30 Tagen ohne Nutzung; melden Sie sich dann erneut aus dem Client an. Um einen Client früher zu stoppen, entfernen Sie den Connector in diesem Client.
  • Ihr persönliches Token funktioniert parallel weiter. Beide sind unabhängig: Ein neu generiertes Token trennt keinen angemeldeten Client.

Nur Rückleitungen zu claude.ai oder zu einem Client auf Ihrem eigenen Computer (wie Claude Code) werden akzeptiert. Für jeden anderen Client verwenden Sie die Token-Methode oben.

Was Ihre KI kann

  • Alles lesen, was der integrierte Chat kann: Traffic-Berichte, Suchpositionen, Anzeigenperformance, CRM-Pipelines, Core Web Vitals, Cloudflare-Edge-Traffic und KI-Crawler-Daten, Annotationen und die Wissensdatenbank jeder verbundenen Property.
  • Ihre Skills ausführen: Skills erscheinen im Prompts-Menü Ihres Clients, und die KI kann sie auch selbst auflisten und abrufen - fragen Sie nach einem Skill beim Namen, und sie folgt Ihrem Playbook exakt.
  • Annotationen schreiben: Auf Properties mit Schreibrechten kann die KI eigene Annotationen erstellen und aktualisieren - Ihnen zugeschrieben und für Ihr Team in der App sichtbar.
  • Team-Memories speichern: auf Properties, wo Memory aktiviert ist und Sie Schreibrechte haben.

Alles andere ist schreibgeschützt. Der Connector kann niemals etwas in Ihren verbundenen Plattformen ändern - er kann keine Google-Analytics-Einstellungen anfassen, keine Kampagnen bearbeiten und nicht Ihre WordPress-Site verändern.

Berechtigungen und Sicherheit

  • Ihre Berechtigungen reisen mit. Der Connector sieht nur Properties, auf die Sie Zugriff haben, und Property-Berechtigungen (Lesen/Schreiben/Admin) gelten für jeden Aufruf - die KI kennt Ihre Berechtigungsstufe pro Property.
  • Team-Notausschalter. Deaktiviert ein Team-Eigentümer den Externen KI-Zugriff, verschwinden die Properties dieses Teams sofort aus dem Connector jedes Mitglieds, ohne URLs ungültig zu machen. Wiedereinschalten stellt den Zugriff wieder her.
  • Persönliche Rotation. Das Neugenerieren Ihres Tokens macht Ihr altes Token und Ihre Verbindungs-URL überall dauerhaft ungültig. Kompletter Lockdown für ein Team = jedes Mitglied rotiert, der Eigentümer deaktiviert.
  • Ein Team verlassen entfernt dessen Properties automatisch aus Ihrem Connector.

Hinweis zu kostenpflichtigen Tools

Manche Tools kosten pro Aufruf Geld - zum Beispiel DataForSEO-Backlink-Analysen. Sie werden dem Team berechnet, dem die von der KI übergebene Property gehört, und die KI ist angewiesen, Ihnen zu sagen, welche Property-Verbindung sie nutzt, wenn sie eine Domain analysiert, die nicht die eigene Website dieser Property ist. Verbindungs-Admins können Analysen in den DataForSEO- und PageSpeed-Verbindungseinstellungen auf bestimmte Domains beschränken („erlaubte Domains“).

Wann der integrierte Chat besser ist

Der Connector ist ideal für schnelle Fragen von dort, wo Sie ohnehin arbeiten. Der integrierte Chat bleibt für schwere Analysen das schärfere Werkzeug - er speichert große Ergebnisse in einer Datenbank pro Unterhaltung und führt echtes SQL darüber aus - und Berichte, Berichtshistorie und Teilen leben in der App. Siehe den Ankündigungsartikel für einen ehrlichen Vergleich.

Fehlerbehebung

  • „External MCP access is not enabled for any of your teams“ - keines Ihrer Teams kombiniert einen Pro-/Business-Tarif mit aktiviertem Externem KI-Zugriff. Bitten Sie einen Team-Eigentümer, ihn in den Team-Einstellungen einzuschalten.
  • Eine Property fehlt - entweder hat ihr Team den externen Zugriff deaktiviert, oder Sie haben in der App keinen Zugriff auf diese Property. Der Connector zeigt nie mehr als die App.
  • „Unauthorized MCP access“, oder der Client meldet, dass ein Login nötig ist - die Server-URL wurde ohne den Authorization-Header hinzugefügt, oder der Header-Wert ist falsch. Er muss Bearer gefolgt von Ihrem vollständigen Token sein, genau wie unter Einstellungen → Verbundene KI angezeigt. Wenn Sie Ihr Token neu generiert haben, aktualisieren Sie den Header überall, wo Sie ihn hinzugefügt haben.
  • Die KI nutzt den Connector nicht - prüfen Sie, dass er im Tools-Menü des Chats aktiviert ist, und fragen Sie beim ersten Mal explizit („nutze AIdata, um…“).
  • Schreibzugriffe werden abgelehnt - Annotationen und Memories erfordern Schreibrechte auf der Property; bitten Sie einen Team-Admin, sie zu erteilen.
  • Die Anmeldung schlägt mit „invalid_client“ fehl - der Client hat eine Rückleitungsadresse gesendet, die AIdata nicht erlaubt. Nur claude.ai und Clients auf Ihrem eigenen Computer (wie Claude Code) können sich anmelden; für alles andere verwenden Sie die Token-Methode.