Serveur MCP BEEM — Guide de configuration
Connectez la plateforme de données BEEM à vos assistants IA. Explorez vos espaces de travail, interrogez vos jeux de données, créez des vues SQL, surveillez vos pipelines et gérez vos tableaux de bord — le tout en langage naturel.
URL du serveur
Utilisez cette URL pour connecter n'importe quel client compatible MCP :
<https://mcp.beemdata.com/mcp>
Configuration
Claude pour Teams & Entreprise (à l'échelle de l'organisation)
Sur les forfaits Teams et Entreprise, un Propriétaire ou Propriétaire principal doit d'abord ajouter le connecteur au niveau de l'organisation avant que les membres puissent l'utiliser. Cela rend BEEM disponible pour toute l'équipe sans configuration individuelle.
Étape 1 — Propriétaire : ajouter le connecteur à votre organisation
- Connectez-vous à Claude et accédez à Paramètres de l'organisation → Connecteurs
- Cliquez sur Ajouter
- Collez l'URL du serveur :
https://mcp.beemdata.com/mcp - Cliquez sur Paramètres avancés (optionnel) pour fournir un identifiant et un secret OAuth personnalisés
- Cliquez sur Ajouter pour confirmer
Le connecteur apparaît maintenant pour tous les membres de votre organisation avec le label Personnalisé.
Étape 2 — Membres : connecter votre compte individuel
Chaque membre de l'équipe s'authentifie de façon indépendante afin que Claude n'accède qu'aux données auxquelles votre compte BEEM a accès.
- Dans Claude, cliquez sur le bouton + en bas à gauche de l'interface
- Sélectionnez Connecteurs
- Trouvez le connecteur BEEM (labellisé Personnalisé) dans la liste
- Cliquez sur Connecter et connectez-vous avec vos identifiants BEEM
- Activez le connecteur par conversation via le même interrupteur
Remarque : Les propriétaires peuvent gérer l'accès au connecteur et désactiver des appels d'outils spécifiques dans Paramètres de l'organisation → Connecteurs.
Claude.ai (Web)
- Accédez à Paramètres → Intégrations
- Cliquez sur Ajouter un serveur MCP
- Collez l'URL du serveur ci-dessus
- Connectez-vous avec votre compte BEEM
Claude Desktop
- Ouvrez Paramètres → Développeur → Modifier la configuration
- Ajoutez la configuration JSON suivante :
{
"mcpServers": {
"beemdata": {
"url": "<https://mcp.beemdata.com/mcp>"
}
}
}
- Redémarrez Claude Desktop
- Authentifiez-vous à la première utilisation
Claude Code (CLI)
Exécutez cette commande dans votre terminal :
claude mcp add --transport http beemdata <https://mcp.beemdata.com/mcp>
Une fenêtre de navigateur s'ouvrira pour l'authentification. Les outils BEEM sont disponibles immédiatement après.
Autres clients MCP
Tout client MCP compatible Streamable HTTP fonctionne :
- Utilisez l'URL du serveur ci-dessus
- Auth : OAuth 2.0 avec PKCE
- Enregistrement dynamique de client supporté
- Point de découverte OAuth :
https://mcp.beemdata.com/.well-known/oauth-authorization-server
Exemples
Explorer et interroger des données
« Montre-moi les jeux de données dans mon espace de travail et interroge le premier »
- Récupère vos espaces de travail et liste les jeux de données disponibles
- Obtient les détails du jeu de données, incluant la requête SQL et le schéma
- Interroge le contenu du jeu de données et retourne un échantillon de lignes
Créer et déployer un jeu de données SQL
« Crée un jeu de données appelé 'Revenus mensuels' qui agrège les revenus par mois, puis déploie-le »
- Crée un nouveau jeu de données dans votre espace de travail
- Sauvegarde une requête SQL en brouillon et prévisualise les résultats
- Déploie la requête comme vue Redshift en production avec une planification
Surveiller la santé des pipelines
« Vérifie si des pipelines de données ont échoué au cours des dernières 24 heures »
- Liste les événements de pipeline récents filtrés par statut d'échec
- Identifie les jeux de données et sources de données affectés
- Affiche les détails des erreurs et la consommation actuelle de DPU
Outils disponibles
Espaces de travail & Organisations
| Outil | Description |
|---|---|
beem_get_current_user |
Obtenez vos informations utilisateur, espaces de travail et organisations |
beem_get_workspace |
Obtenez les détails d'un espace de travail, y compris ses utilisateurs |
beem_list_workspaces |
Listez tous les espaces de travail d'une organisation |
beem_get_organization |
Obtenez les détails d'une organisation |
beem_list_user_organizations |
Listez vos organisations |
Jeux de données
| Outil | Description |
|---|---|
beem_get_dataset |
Obtenez les détails, métadonnées et configuration d'un jeu de données |
beem_list_datasets |
Listez les jeux de données dans un espace de travail ou dossier |
beem_create_dataset |
Créez un nouveau jeu de données (commence en brouillon) |
beem_update_dataset |
Mettez à jour la description, le dossier ou les paramètres de recherche IA |
beem_rename_dataset |
Renommez et redéployez la vue Redshift |
SQL & Contenu des jeux de données
| Outil | Description |
|---|---|
beem_get_dataset_sql_queries |
Obtenez l'historique des requêtes SQL (déployées et brouillons) |
beem_save_dataset_sql_query |
Sauvegardez une requête SQL en brouillon |
beem_deploy_dataset_sql_query |
Déployez le SQL — crée une vue Redshift avec planification |
beem_get_dataset_content |
Interrogez et récupérez les lignes d'un jeu de données |
beem_preview_sql_query |
Prévisualisez les résultats SQL sans déployer |
beem_refresh_dataset |
Déclenchez un rafraîchissement manuel du jeu de données |
Tests de jeux de données
| Outil | Description |
|---|---|
beem_get_dataset_test |
Obtenez les détails d'un test |
beem_list_dataset_tests |
Listez tous les tests d'un jeu de données |
beem_create_dataset_test |
Créez un test de qualité des données avec SQL |
beem_update_dataset_test |
Renommez un test |
beem_delete_dataset_test |
Supprimez un test et son historique de requêtes |
beem_save_dataset_test_sql_query |
Sauvegardez le SQL de test en brouillon |
beem_deploy_dataset_test_sql_query |
Déployez une requête SQL de test |
Sources & Ingestion
| Outil | Description |
|---|---|
beem_get_source |
Obtenez les détails d'une connexion source (catalogue) |
beem_list_sources |
Listez toutes les sources dans un espace de travail |
beem_get_data_object |
Obtenez les détails d'une table source |
beem_list_data_objects |
Listez les tables d'une source |
beem_create_data_object |
Créez une nouvelle table source |
beem_start_ingestion |
Démarrez la synchronisation du catalogue pour un objet de données |
Tableaux de bord & Visualisations
| Outil | Description |
|---|---|
beem_get_dashboard |
Obtenez les détails d'un tableau de bord |
beem_list_dashboards |
Listez les tableaux de bord dans un espace de travail |
beem_create_dashboard |
Créez un nouveau tableau de bord |
beem_update_dashboard |
Renommez un tableau de bord |
beem_get_dashboard_widget |
Obtenez les détails d'un widget |
beem_list_dashboard_widgets |
Listez les widgets dans un tableau de bord |
beem_create_dashboard_widget |
Ajoutez un widget à un tableau de bord |
beem_update_dashboard_widget |
Mettez à jour un widget |
beem_get_visualization |
Obtenez les détails d'une visualisation |
beem_list_visualizations_by_dataset |
Listez les visualisations d'un jeu de données |
beem_list_visualizations_by_workspace |
Listez toutes les visualisations d'un espace de travail |
beem_create_visualization |
Créez une visualisation |
beem_update_visualization |
Mettez à jour une visualisation |
beem_delete_visualization |
Supprimez une visualisation |
Dossiers
| Outil | Description |
|---|---|
beem_get_folder |
Obtenez les détails d'un dossier avec ses sous-dossiers et jeux de données |
beem_list_folders |
Listez les dossiers dans un dossier parent |
beem_create_folder |
Créez un nouveau dossier |
beem_update_folder |
Renommez ou déplacez un dossier |
Flows
| Outil | Description |
|---|---|
beem_get_flow |
Obtenez les détails d'un flow (connexion jeu de données vers destination) |
beem_list_flows |
Listez tous les flows dans un espace de travail |
Événements & Utilisation
| Outil | Description |
|---|---|
beem_list_events_by_workspace |
Listez les événements de pipeline dans un espace de travail |
beem_list_events_by_object |
Listez les événements pour un jeu de données ou une source spécifique |
beem_list_events_by_user |
Listez les événements déclenchés par un utilisateur |
beem_get_dpu_usage |
Obtenez la consommation de DPU et les informations du cycle de facturation |
Dépannage
« Session terminée » ou « Session expirée »
Votre session a peut-être été perdue suite à une mise à jour du serveur. Réessayez simplement — le client se réauthentifiera automatiquement.
L'authentification échoue ou boucle
Assurez-vous de vous connecter avec un compte BEEM ayant accès à au moins un espace de travail. Essayez de déconnecter puis de reconnecter le serveur MCP.
L'outil retourne des erreurs « introuvable »
Vérifiez que vous avez accès à l'espace de travail ou au jeu de données. Le serveur MCP utilise vos permissions BEEM — vous ne pouvez accéder qu'aux ressources auxquelles votre compte a accès.
Besoin d'aide ? Contactez team@beemdata.com