Serveur MCP Genie One

info

Bêta

Cette fonctionnalité est en Bêta. Les administrateurs du Workspace peuvent contrôler l'accès à cette fonctionnalité à partir de la page Previews . Consultez Gérer les aperçus Databricks.

Le serveur MCP Genie One est un serveur MCP géré par Databricks qui expose Genie comme un outil conversationnel via le Model Context Protocol (MCP), en tirant parti de Chat dans Genie One. Un client ou un agent MCP envoie une question en langage naturel, et Genie recherche vos données d'entreprise, écrit des queries SQL et renvoie une réponse basée sur l'ontologie Genie avec des liens profonds vers vos sources Databricks citées.

Connectez n'importe quel client ou agent MCP pour ancrer ses questions sur les données dans les insights fiables de Genie. Les clients qui prennent en charge les applications MCP peuvent afficher une vue interactive qui présente la progression, les visualisations et les résultats de Genie en ligne.

Les autorisations Unity Catalog sont toujours appliquées, de sorte que les utilisateurs et les agents ne peuvent query que les données auxquelles ils sont autorisés à accéder.

remarque

Le serveur Genie One MCP répond aux questions concernant les données de votre workspace en utilisant Chat dans Genie One et est accessible via le chemin /api/2.0/mcp/genie. Il est distinct du serveur Genie par agent à /api/2.0/mcp/genie/{genie_space_id}, qui interroge un seul Genie Agent. Consultez les serveurs MCP gérés par Databricks pour le serveur par agent.

Activer le serveur MCP Genie One

Le serveur Genie One MCP nécessite l'aperçu du Workspace Managed MCP Servers . Un administrateur de Workspace l'active comme suit :

1. En tant qu'administrateur du Workspace, cliquez sur votre nom d'utilisateur dans la barre supérieure du Workspace Databricks.
2. Dans le menu, sélectionnez Aperçus .
3. Recherchez et activez les **serveurs MCP gérés**.

Pour en savoir plus sur la gestion des aperçus, consultez Gérer les aperçus Databricks.

Endpoint et authentification

Le serveur MCP Genie One est disponible à l'URL suivante.

https://<workspace-hostname>/api/2.0/mcp/genie

La connexion au serveur MCP Genie One est similaire à la connexion à tout autre serveur MCP géré par Databricks : les requêtes doivent être authentifiées auprès de votre Workspace. Lors de la connexion avec l'authentification utilisateur pour le compte de, incluez le champ d'application OAuth genie. Consultez Connecter les clients à l'aide de l'authentification OAuth pour les instructions de configuration, et Connecter les MCP aux assistants d'IA et aux agents de codage pour connecter des clients tels que Cursor et Claude Desktop.

Outils disponibles

Le serveur Genie One MCP expose les outils suivants. En pratique, un agent invoque genie_ask (ou view_ask sur les clients d'applications MCP) pour poser une question ; l'agent gère les outils restants en votre nom au fur et à mesure qu'il traite la réponse.

Outil	Description
genie_ask	Posez à Genie une question sur les données en langage naturel et start une réponse. Renvoie conversation_id, response_id et status. Passez un conversation_id pour poursuivre une conversation précédente.
genie_poll_response	Récupérez le dernier état d'une réponse en cours ou terminée, y compris les étapes de progression, la réponse finale et les liens profonds vers vos sources Databricks.
genie_get_query_result	Récupérez le résultat SQL complet — schéma des colonnes et lignes — pour une query exécutée par Genie.
genie_cancel_response	Demandez l'annulation d'un tour de Genie en cours.
view_ask	Posez une question à Genie et ouvrez la vue interactive. Proposé au lieu de genie_ask aux clients d'applications MCP, et préféré lorsqu'il est disponible.

Outil	Description
genie_ask	Posez à Genie une question sur les données en langage naturel et start une réponse. Renvoie conversation_id, response_id et status. Passez un conversation_id pour poursuivre une conversation précédente.
genie_poll_response	Récupérez le dernier état d'une réponse en cours ou terminée, y compris les étapes de progression, la réponse finale et les liens profonds vers vos sources Databricks.
genie_get_query_result	Récupérez le résultat SQL complet — schéma des colonnes et lignes — pour une query exécutée par Genie.
genie_cancel_response	Demandez l'annulation d'un tour de Genie en cours.
view_ask	Posez une question à Genie et ouvrez la vue interactive. Proposé au lieu de genie_ask aux clients d'applications MCP, et préféré lorsqu'il est disponible.

Posez une question

Comme Genie exécute un agent qui recherche des données et exécute du SQL, les réponses sont asynchrones. Vous (ou votre agent) appelez genie_ask avec une question ; l'agent gère alors le reste de l'échange automatiquement. Un flux typique ressemble à ceci :

1. genie_ask start la réponse et renvoie un conversation_id et response_id avec status: in_progress. Genie continue de fonctionner en arrière-plan.
2. L’agent interroge genie_poll_response jusqu’à ce que la réponse soit terminée, affichant progress_steps et un narration_instruction en cours de route pour vous tenir informé.
3. Lorsque status est completed (ou incomplete / failed), l'agent renvoie la réponse rendue, y compris un Explore in Databricks deep Link vers la conversation complète et toutes les visualisations produites par Genie.

Pour poursuivre la même conversation, la question de suivi réutilise le conversation_id précédent.

Application MCP

Le serveur MCP Genie One fournit une Application MCP, une extension qui permet à un serveur de renvoyer une vue interactive au lieu de texte brut. Sur les clients qui prennent en charge les applications MCP, le serveur renvoie une vue interactive : un panneau intégré au client qui affiche la progression, les visualisations et la réponse finale de Genie au fur et à mesure que la conversation se déroule, plutôt qu'une réponse textuelle uniquement.

L'application MCP Genie One affichant un histogramme, des métriques récapitulatives et des citations de l'ontologie Genie dans Claude Desktop.

Aucune configuration supplémentaire n'est requise. Les clients qui prennent en charge les applications MCP obtiennent automatiquement la vue interactive. Les clients qui ne continuent pas à recevoir les résultats textuels.

Considérations

• Autorisations : Les autorisations Unity Catalog sont appliquées à chaque requête, de sorte que les résultats sont limités à ce à quoi l'utilisateur peut accéder.
• Configuration : Le serveur respecte votre configuration Genie One dans Databricks. Réglez et configurez le comportement de Genie à cet endroit. Consultez Chat dans Genie One.
• Fréquence de sondage : attendez que l'appel genie_poll_response précédent soit terminé avant de sonder à nouveau.
• Taille du résultat : Pour protéger la fenêtre de contexte du modèle, genie_ask et genie_poll_response renvoient des résultats de query tronqués. Lorsqu'un agent a besoin du résultat complet, il peut appeler genie_get_query_result pour récupérer le schéma et les lignes complets. Les résultats très volumineux restent soumis à une limite de taille ; si celle-ci est dépassée, la réponse est tronquée.
• Tarifs : Le serveur Genie One MCP utilise le Chat dans Genie One. Voir les tarifs de Genie.

Connectez-vous au serveur MCP Genie One

Le serveur MCP Genie One est l'un des serveurs MCP gérés de Databricks. Pour connecter des clients externes tels que Cursor ou Claude Desktop, ou pour créer un agent qui appelle le serveur, consultez Connecter des MCP à des assistants IA et des agents de codage.

Pour afficher vos serveurs MCP et leurs URL d'Endpoint, accédez à votre workspace et sélectionnez Agents > MCPs .