KI-Chats verbinden

Ein KI-Chat mit Unterstützung für entfernte MCP-Server (Model Context Protocol) kann FastBI-Daten erkunden, Analysen ausführen und Berichte abrufen. Er erhält nur den von Ihnen genehmigten Zugriff.

Mit OAuth verbinden

1. Öffnen Sie in FastBI User settings → Connect your AI with MCP und kopieren Sie die MCP server URL: https://fastbi.app/api/mcp/v1.
2. Fügen Sie diese URL in den Integrations- oder MCP-Einstellungen Ihres KI-Clients hinzu. Wählen Sie bei Bedarf Streamable HTTP und OAuth. Die Bezeichnungen unterscheiden sich je nach Client.
3. Starten Sie die Verbindung und melden Sie sich bei FastBI an: mit Google, Microsoft oder E-Mail und Passwort.
4. Prüfen Sie auf Connect … den App-Namen und die Return address. Wählen Sie die Organization und unter Allow access to die benötigten Funktionen. Bestätigen Sie mit Allow access oder lehnen Sie mit Cancel ab.
5. Kehren Sie zum Chat zurück. Aktivieren Sie FastBI gegebenenfalls für diesen Chat und lassen Sie sich die verfügbaren Funktionen anzeigen.

Die Anmeldung bestätigt Ihre Identität; erst die separate Zustimmung erlaubt der App den Zugriff auf die ausgewählte Organisation.

Kopieren Sie die MCP-Server-URL und wählen Sie die Funktionen für Ihren KI-Client.

Berechtigungen wählen

• Catalog: verbundene Daten und Schemas durchsuchen.
• Reports: Berichte lesen und gespeicherte Widgets ausführen.
• Ad hoc analysis: Fragen stellen und Analysen ausführen.
• SQL Workbench: Abfragen planen, SQL ausführen und Ergebnisse lesen.

AdHoc und SQL erfordern die Analyst-Rolle. Ihre aktive Mitgliedschaft und Arbeitsbereichsrechte gelten weiterhin. Angeforderte Daten werden an den KI-Client gesendet; Analysen und Abfragen verbrauchen die üblichen FastBI-Credits.

Eine einmalige Frage stellen

Nennen Sie Datenquelle, Kennzahl, Zeitraum, Zeitzone und Ausschlüsse. Passen Sie beispielsweise diese Frage an:

Nutze FastBI, um den Nettoumsatz der letzten vier vollständigen Wochen je Woche in USD anzuzeigen. Verwende unsere Bestellquelle, schließe stornierte Bestellungen aus und nutze die Berichtszeitzone. Zeige ein Diagramm, den abgedeckten Zeitraum und die Quellen.

Der Client kann einen passenden Bericht verwenden oder eine AdHoc-Analyse starten. Beantworten Sie Rückfragen, warten Sie auf den Abschluss und prüfen Sie Filter und Summen. Stellen Sie Folgefragen im selben Gespräch. Kann der Client das Diagramm nicht darstellen, öffnen Sie das Ergebnis in FastBI.

Daten regelmäßig abrufen

Die Planung erfolgt im KI-Client oder einer Automatisierung, die authentifizierte MCP-Aufrufe bei geplanten Ausführungen unterstützt. Die Verbindung allein erstellt keinen Zeitplan. Ohne diese Unterstützung sind einmalige Abfragen möglich.

1. Erstellen Sie einen gespeicherten Bericht mit den gewünschten Kennzahlen und Filtern.
2. Lassen Sie das passende Widget bei jeder Ausführung neu ausführen. Legen Sie Zeitraum, Zeitzone, Häufigkeit und Ziel im Zeitplaner des Clients fest.
3. Testen Sie einen manuellen Abruf und prüfen Sie Zeitraum und Aktualität, bevor Sie den Zeitplan aktivieren.

Führe jeden Werktag um 09:00 Uhr Asia/Bangkok über FastBI das Widget „Umsatz“ des Berichts „Tagesumsatz“ für den vorherigen abgeschlossenen Tag aus. Liefere Umsatz, Bestellanzahl, den Vergleich zum Vortag sowie Zeitraum und letzte Datenaktualisierung.

Passen Sie die Namen an Ihren Arbeitsbereich an und kontrollieren Sie den gespeicherten Zeitplan im Client. FastBI Jobs synchronisieren ausgewählte Daten in den Lake; der KI-Zeitplan ruft sie ab. Planen Sie den Abruf nach erfolgreicher Synchronisierung. Jede Ausführung kann Credits verbrauchen.

OAuth, Ablauf und Widerruf

Nach Ihrer Zustimmung erhält der Client einen kurzlebigen Autorisierungscode an seiner Rücksprungadresse. Er tauscht ihn mittels PKCE gegen Zugriffs- und Aktualisierungstokens ein. Ihr FastBI-Passwort gehört nicht in den KI-Client.

Zugriffstokens gelten höchstens eine Stunde. Ein kompatibler Client erneuert sie innerhalb der 30-tägigen Autorisierung automatisch. Danach müssen Sie die Verbindung erneut genehmigen; die Erneuerung verlängert diese Frist nicht unbegrenzt. Auch geplante Abrufe benötigen gültigen Zugriff.

Unter User settings → Connect your AI with MCP → Connected AI apps → Revoke widerrufen Sie den Zugriff. Bereits an den Client übermittelte Daten werden dadurch nicht gelöscht.

Manuelle Tokens

Unter Manual access tokens geben Sie einen Verbindungsnamen ein, wählen Allowed features und klicken auf Create access token. Kopieren Sie den einmalig angezeigten Token in das Bearer-Token-Feld des Clients für dieselbe MCP-URL. Veröffentlichen Sie ihn weder im Chat noch in geteilter Konfiguration. Diese Tokens laufen nach 30 Tagen ab und lassen sich in User settings widerrufen.

Bei Fehlern prüfen Sie Ablaufdatum, Organisation, genehmigte Funktionen und Rolle. Bei veralteten Ergebnissen prüfen Sie Berichtszeitraum und letzte erfolgreiche Synchronisierung. Um eine externe MCP-Datenquelle in FastBI einzubinden, lesen Sie MCP integrations.