Aller au contenu principal

Serveur MCP Genie Agent

Le serveur MCP Genie Agent permet à un agent d'effectuer une query sur un seul Genie Agent en langage naturel, sans écrire de SQL. L'agent envoie une question en langage clair, et Genie écrit et exécute le SQL sur les tables de cet agent, puis renvoie le résultat, avec les autorisations Unity Catalog appliquées à chaque requête.

astuce

Pour query un Genie Agent à partir de Python sans MCP, utilisez les exemples d’outils AI Bridge. Pour les questions métier sur votre workspace, utilisez le Genie One MCP (system.ai.genie_one_mcp).

Un Genie Agent est un ensemble de 50 tables, vues ou vues métriques au maximum du Unity Catalog que Genie garde en contexte, de sorte que le serveur est limité à ces données sélectionnées plutôt qu’à l’ensemble de votre Workspace.

Modèle d'URL

Champ d'application d'OAuth

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

genie

Modèle d'URL

Champ d'application d'OAuth

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

genie

Pour trouver l’ID du Genie space, ouvrez le Genie Agent et copiez l’ID de l’espace depuis son Settings tab.

Les appels à cet endpoint ne transitent pas par Unity Gateway, l’accès est donc contrôlé par les autorisations sur le Genie Agent et les données sous-jacentes.

Les appels MCP Genie Agent utilisent les tarifs de Databricks SQL.

Prérequis​

Un administrateur de workspace doit activer les serveurs MCP gérés sur la page d'aperçus du workspace.

Connecter un agent​

Pour connecter un agent à un serveur MCP Genie Agent, créez un Genie Agent, partagez-le avec les utilisateurs ou les Service Principal qui ont besoin d’y accéder, et pointez votre agent vers l’URL MCP préconfigurée pour l’espace. Suivez Utiliser les outils MCP dans un agent Python, en définissant server_url sur l’URL ci-dessus.

Pour connecter des clients externes tels que Cursor ou Claude Desktop, consultez la page Agents de codage pris en charge.

Limitations​

  • Lecture seule. Le serveur MCP de Genie Agent query les données ; il n’écrit pas dans vos tables.
  • Aucun historique de conversation. Le serveur appelle Genie en tant qu’outil, de sorte qu’il ne transmet pas l’historique des conversations à l’API Genie. Pour continuer une conversation depuis Python, utilisez AI Bridge.