Serveur MCP Genie One

Le serveur MCP Genie One est un service 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 un 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 liens profonds renvoyant 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 limiter l'analytique à un seul Genie Agent organisé, utilisez le serveur MCP Genie Agent.

Accès via Unity Gateway

Le serveur MCP Genie One est un service MCP fourni par Databricks, system.ai.genie_one_mcp, régi par Unity Gateway. Unity Catalog permet de contrôler qui peut l’invoquer, les politiques de service autorisent ou refusent les appels d’outils individuels, et chaque appel est enregistré à des fins d’utilisation et d’audit.

Appelez le service à son URL Unity Gateway, avec son nom complet Unity Catalog dans le chemin d'accès :

Text

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

Les utilisateurs du compte détiennent EXECUTE sur system.ai par default ; par conséquent, aucune attribution supplémentaire n’est généralement requise. Lors de la connexion avec l’ authentification utilisateur pour le compte de, incluez le champ d’application OAuth ai-gateway. Pour contrôler qui peut invoquer le service et les outils qu’il expose, et pour appliquer une politique de service, consultez la page Gérer un service MCP. Pour ajouter le service à un agent, consultez la page Utiliser des serveurs MCP dans des agents personnalisés. Pour connecter des clients externes tels que Cursor ou Claude Desktop, consultez la page Connecter des serveurs MCP à des assistants IA et à des agents de codage.

remarque

La version précédente du service MCP Genie One est obsolète.

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

Connecter un client tel que Claude ou ChatGPT

Pour utiliser Genie One à partir d'un client MCP tel que Claude, Claude Code, ChatGPT ou Cursor, pointez le client vers l'URL du service MCP ci-dessus et authentifiez-vous avec OAuth. Pour une configuration étape par étape par client, consultez les exemples OAuth.

Pour afficher vos services 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 queries sur un SQL warehouse spécifique, transmettez le warehouse_id _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

• Connect MCPs to AI assistants and coding agents pour connecter un client MCP tel que Claude, ChatGPT ou Cursor, avec une configuration OAuth par client.
• Use MCP servers in Custom Agents pour ajouter le service MCP Genie One à un agent que vous créez par programmation, puis déployez-le.
• Gouvernez un service MCP pour accorder l'accès, sélectionner des outils et appliquer une règle de service.
• Connectez les agents aux outils avec les services MCP pour obtenir une vue d’ensemble des services MCP sur Databricks.