Serveur MCP Genie One

info

Bêta

Cette fonctionnalité est en bêta. Les administrateurs de Workspace peuvent contrôler l'accès à cette fonctionnalité à partir de la page Aperçus . Voir Gérer les prévisualisations Databricks.

Le serveur MCP Genie One est un serveur MCP géré par Databricks qui expose Genie en tant qu’outil conversationnel via le Model Context Protocol (MCP), en tirant parti de Chat in Genie One. Un client ou agent MCP envoie une question en langage naturel, et Genie effectue une recherche dans vos données d’entreprise, écrit du SQL et renvoie une réponse basée sur la Genie Ontology avec des Link profonds vers vos sources Databricks citées. [[ ## completed ##]]

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

Les autorisations de Unity Catalog sont toujours appliquées ; ainsi, les utilisateurs et les agents ne peuvent effectuer que des query sur les données auxquelles ils sont autorisés à accéder. [[ ## completed ##]]

remarque

Le serveur MCP Genie One répond aux questions sur les données de votre Workspace à l’aide de Chat in Genie One et est servi au chemin /api/2.0/mcp/genie. Il est distinct du serveur Genie par agent situé à /api/2.0/mcp/genie/{genie_space_id}, qui query un seul Genie Agent. Consultez Databricks managed MCP servers pour le serveur par agent.

Activer le serveur MCP Genie One

Le serveur MCP Genie One nécessite l’aperçu de 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 demandes doivent être authentifiées auprès de votre workspace. Lors de la connexion avec l’authentification pour le compte de l’utilisateur, incluez le champ d’application OAuth genie. Consultez Connecter des clients via l’authentification OAuth pour obtenir des instructions de configuration, et Connecter des MCP à des assistants IA et des agents de codage pour connecter des clients tels que Cursor et Claude Desktop.

Outils disponibles

Le serveur MCP Genie One expose les outils suivants. En pratique, un agent appelle genie_ask (ou view_ask sur les clients MCP Apps) pour poser une question ; l’agent gère les outils restants en votre nom pendant qu’il traite la réponse.

Outil	Description
genie_ask	Posez une question sur les données en langage naturel à Genie et start une réponse. Renvoie conversation_id, response_id et status. Transmettez 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 Link profonds vers vos sources Databricks.
genie_get_query_result	Récupérer le résultat SQL complet, y compris le schéma de colonne et les lignes, pour une query exécutée par Genie.
genie_cancel_response	Demander l’annulation d’un tour Genie en cours.
view_ask	Posez une question à Genie et ouvrez la vue interactive. Proposé à la place de genie_ask aux clients MCP Apps, et privilégié lorsqu’il est disponible.

Outil	Description
genie_ask	Posez une question sur les données en langage naturel à Genie et start une réponse. Renvoie conversation_id, response_id et status. Transmettez 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 Link profonds vers vos sources Databricks.
genie_get_query_result	Récupérer le résultat SQL complet, y compris le schéma de colonne et les lignes, pour une query exécutée par Genie.
genie_cancel_response	Demander l’annulation d’un tour Genie en cours.
view_ask	Posez une question à Genie et ouvrez la vue interactive. Proposé à la place de genie_ask aux clients MCP Apps, et privilégié 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) invoquez genie_ask avec une question ; l’agent gère ensuite le reste de l’échange automatiquement. Un flux typique se présente comme suit :

1. genie_ask start la réponse et renvoie un conversation_id et un 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, en faisant apparaître progress_steps et 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, incluant un Explore in Databricks deep link vers la conversation complète et toute visualisation produite 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 d’un 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 du déroulement de la conversation, plutôt qu’une réponse textuelle uniquement.

L’application MCP Genie One affichant un graphique à barres, 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. Clients qui ne continuent pas à recevoir des 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. Ajustez et configurez le comportement de Genie à cet endroit. Voir Chat dans Genie One.
• Cadence d’interrogation : attendez que l’appel genie_poll_response précédent soit terminé avant d’interroger à nouveau.
• Taille des résultats : 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. [[ ## completed ##]] Lorsqu’un agent a besoin du résultat complet, il peut appeler genie_get_query_result pour récupérer le schéma complet et les lignes. 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 MCP Genie One utilise Chat in Genie One. Voir les tarifs de Genie.

Se connecter au serveur MCP Genie One

Le serveur MCP Genie One est l’un des serveurs MCP gérés par 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 .