Serveur MCP Genie One

Le serveur MCP Genie One est un MCP fourni 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.

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.

Utilisez ce serveur pour l'analytique dans votre Workspace : questions métier posées en langage naturel, où la précision dépend de la compréhension de la signification de vos données. Genie résout les termes métier, les définitions de métriques et les relations entre les tables via Genie Ontology, votre couche sémantique gouvernée, ce qui produit des réponses plus précises qu'un agent écrivant du SQL directement sur des tables brutes.

astuce

Pour query un Genie Agent spécifique à partir de Python, utilisez les exemples d’outils AI Bridge. Pour query un agent spécifique via MCP, voir le serveur MCP Genie Agent.

Accès via Unity Gateway

Le serveur MCP Genie One est un MCP fourni par Databricks, system.ai.genie_one_mcp, régi par Unity Gateway.

Appelez le MCP à son URL Unity Gateway, avec son nom Unity Catalog pleinement qualifié dans le chemin :

Text

https://<workspace-hostname>/ai-gateway/mcp-services/system.ai.genie_one_mcp

Lors de la connexion avec l’ authentification utilisateur on-behalf-of, incluez le champ d'application d'OAuth ai-gateway. Pour contrôler l'accès et appliquer des règles, consultez la page Gouverner un MCP. Pour ajouter le MCP à un agent, consultez Utiliser des outils MCP dans un agent Python. Pour connecter des clients externes tels que Cursor ou Claude Desktop, consultez la page Agents de codage pris en charge.

remarque

Le nouveau MCP Genie One, system.ai.genie_one_mcp, est généralement disponible. L'endpoint bêta précédent, https://<workspace-hostname>/api/2.0/mcp/genie, est obsolète et sera supprimé le 31 octobre 2026. Déplacez toutes les charges de travail vers le MCP d'ici là. L'endpoint obsolète utilise le champ d'application d'OAuth genie. Pour régir l'accès avec les politiques MCP, utilisez le MCP system.ai.genie_one_mcp dans Unity Gateway.

Connecter un client tel que Claude ou ChatGPT

Pointez votre client sur l'URL MCP ci-dessus et authentifiez-vous avec OAuth. Suivez la configuration pour les agents de codage ou les autres clients MCP, notamment Claude et ChatGPT.

Pour afficher vos MCP et leurs URL, accédez à votre workspace et sélectionnez Unity Gateway > MCPs .

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.
• Authentification utilisateur : l’authentification OAuth utilisateur agissant pour le compte d’un tiers (on-behalf-of) est recommandée, conformément aux meilleures pratiques de gouvernance des données et permettant une transition fluide vers les sources Genie. L’authentification par service principal est également prise en charge pour les workloads programmatiques et automatisés.
• 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. 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.
• SQL Warehouse : Pour exécuter des query sur un SQL Warehouse spécifique, transmettez warehouse_id dans les _meta parameter sur genie_ask ou view_ask.
• Tarifs : Le serveur MCP Genie One utilise Chat in Genie One. Voir les tarifs de Genie.

Ressources supplémentaires

• Agents de codage pris en charge pour connecter un agent de codage.
• Autres clients MCP pour connecter Claude, ChatGPT ou un autre client.
• Utiliser des outils MCP dans un agent Python pour ajouter le MCP Genie One à un agent que vous créez par le code, puis déployez-le.
• Gérez un MCP pour accorder l’accès et appliquer des politiques.
• MCPs pour un aperçu des MCPs sur Databricks.