Connecter vos conversations IA

Un client IA compatible avec les serveurs MCP distants (Model Context Protocol) peut explorer vos données FastBI, lancer des analyses et consulter des rapports avec les autorisations que vous accordez.

Se connecter avec OAuth

1. Dans FastBI, ouvrez User settings → Connect your AI with MCP et copiez MCP server URL : https://fastbi.app/api/mcp/v1.
2. Ajoutez cette URL dans les paramètres d’intégration ou MCP du client IA. Si nécessaire, choisissez Streamable HTTP et OAuth. Les libellés dépendent du client.
3. Lancez la connexion, puis connectez-vous à FastBI avec Google, Microsoft ou votre adresse e-mail et votre mot de passe.
4. Sur Connect …, vérifiez le nom de l’application et Return address. Choisissez Organization, puis les fonctions nécessaires sous Allow access to. Sélectionnez Allow access pour accepter ou Cancel pour refuser.
5. Revenez au chat, activez FastBI pour cette conversation si nécessaire et demandez la liste de ses fonctions disponibles.

La connexion vérifie votre identité. L’autorisation distincte donne accès à l’organisation choisie, pas à toutes vos organisations.

Copiez l’URL du serveur MCP et choisissez les fonctions accessibles au client IA.

Choisir les autorisations

• Catalog : parcourir les données connectées et leurs schémas.
• Reports : consulter les rapports et exécuter les widgets enregistrés.
• Ad hoc analysis : poser des questions et lancer des analyses.
• SQL Workbench : préparer des requêtes, exécuter du SQL et lire les résultats.

AdHoc et SQL nécessitent le rôle Analyst. Votre appartenance active à l’espace et vos droits continuent de s’appliquer. Les données demandées sont transmises au client IA ; les analyses et requêtes utilisent vos crédits FastBI habituels.

Poser une question ponctuelle

Précisez la source, la mesure, la période, le fuseau horaire et les exclusions. Adaptez cet exemple à vos données :

Utilise FastBI pour afficher le revenu net hebdomadaire des quatre dernières semaines complètes en USD. Utilise notre source de commandes, exclus les commandes annulées et applique le fuseau horaire des rapports. Ajoute un graphique, la période couverte et les sources.

Le client peut utiliser un rapport adapté ou lancer une analyse AdHoc. Répondez aux demandes de précision, attendez la fin de l’exécution et vérifiez les filtres et totaux. Poursuivez dans la même conversation. Si le client ne peut pas afficher le graphique, consultez le résultat dans FastBI.

Récupérer les données régulièrement

Configurez le planning dans un client ou une automatisation prenant en charge les appels MCP authentifiés pendant les exécutions planifiées. La connexion FastBI ne crée pas de planning. Sans cette fonction, utilisez des demandes ponctuelles.

1. Créez un rapport enregistré avec les mesures et filtres à répéter.
2. Demandez au client d’exécuter le widget correspondant pour obtenir de nouveaux résultats. Définissez période, fuseau horaire, fréquence et destination dans son planificateur.
3. Testez une exécution manuelle et vérifiez période et fraîcheur des données avant d’activer le planning.

Chaque jour ouvré à 09:00 Asia/Bangkok, utilise FastBI pour exécuter le widget « Revenu » du rapport « Ventes quotidiennes » pour la journée complète précédente. Indique le revenu, le nombre de commandes, la comparaison avec la veille, la période et la dernière actualisation des données.

Adaptez les noms à votre espace et vérifiez le planning enregistré dans le client. Les Jobs FastBI synchronisent les données sélectionnées vers le Lake ; le planning du client les récupère. Prévoyez la récupération après la réussite de la synchronisation. Chaque exécution peut consommer des crédits.

Fonctionnement d’OAuth et révocation

Après votre accord, le client reçoit un code d’autorisation de courte durée à son adresse de retour. Il l’échange, avec PKCE, contre des jetons d’accès et de renouvellement. Vous ne saisissez pas votre mot de passe FastBI dans le client IA.

Les jetons d’accès durent au maximum une heure. Un client compatible les renouvelle automatiquement pendant la période d’autorisation de 30 jours. Ensuite, reconnectez-vous et autorisez à nouveau l’accès : le renouvellement ne prolonge pas indéfiniment cette période. Les tâches planifiées exigent aussi une autorisation valide.

Pour retirer l’accès, ouvrez User settings → Connect your AI with MCP → Connected AI apps → Revoke. Les données déjà reçues par le client ne sont pas effacées.

Jetons manuels

Sous Manual access tokens, saisissez un nom, choisissez Allowed features, puis Create access token. Copiez le jeton affiché une seule fois dans le champ bearer token du client, avec la même URL MCP. Ne le collez pas dans un chat ou une configuration partagée. Ces jetons expirent après 30 jours et peuvent être révoqués dans User settings.

En cas d’échec, vérifiez expiration, organisation, fonctions autorisées et rôle. Pour des résultats anciens, vérifiez la période du rapport et la dernière synchronisation réussie. Pour ajouter une source MCP externe à FastBI, consultez MCP integrations.