Serveurs MCP fournis par Databricks

Databricks fournit des MCP dans le schéma system.ai pour les données et les services externes. Choisissez un MCP ci-dessous, puis connectez votre agent. Vous n'avez pas besoin d'héberger ou d'enregistrer de serveur.

Chaque MCP system.ai est une ressource sécurisable Unity Catalog invoquée via Unity Gateway. Vous pouvez gérer qui peut les invoquer à l’aide de concessions et contrôler les appels individuels grâce à des politiques.

Les autres Endpoint MCP de Workspace, y compris le MCP de Genie Agent, utilisent les autorisations sur les Ressources sous-jacentes sans gouvernance Unity Gateway.

URL du serveur MCP

For any system.ai MCP, use this URL:

Text
https://<workspace-hostname>/ai-gateway/mcp-services/<mcp-name>

Remplacez <workspace-hostname> par le hostname de votre workspace et <mcp-name> par le nom complet des tables ci-dessous, tel que system.ai.dbsql.

Données et outils Databricks

info

Unity Gateway Beta

Pour utiliser system.ai.dbsql, system.ai.sandbox ou system.ai.web_search, un administrateur de compte doit activer la version bêta de Unity Gateway depuis la page Previews de la console du compte. Consultez Gérer les aperçus du compte.

Le serveur MCP Genie One est généralement disponible.

MCP	Description
`system.ai.genie_one_mcp`	Recommandé pour l’analytique en langage naturel dans l’ensemble de votre Workspace. Répond aux questions avec Genie One, en s’appuyant sur l’ontologie Genie.
`system.ai.dbsql`	Runs specific SQL queries for development and Data Engineering on a SQL Warehouse, using the caller's Unity Catalog and warehouse permissions.
`system.ai.web_search`	Recherche sur le Web public et renvoie une réponse synthétisée avec des citations.
`system.ai.sandbox`	Exécute du code Python, SQL ou Shell dans un environnement isolé.

MCP	Description
`system.ai.genie_one_mcp`	Recommandé pour l’analytique en langage naturel dans l’ensemble de votre Workspace. Répond aux questions avec Genie One, en s’appuyant sur l’ontologie Genie.
`system.ai.dbsql`	Runs specific SQL queries for development and Data Engineering on a SQL Warehouse, using the caller's Unity Catalog and warehouse permissions.
`system.ai.web_search`	Recherche sur le Web public et renvoie une réponse synthétisée avec des citations.
`system.ai.sandbox`	Exécute du code Python, SQL ou Shell dans un environnement isolé.

Choisissez entre les serveurs MCP Genie One, Genie Agent et Databricks SQL

Pour les cas d’usage analytiques, start avec le serveur MCP Genie One. Genie résout les termes métier, les définitions des métriques et les relations entre les tables grâce à la Genie Ontology, votre couche sémantique gouvernée. Cela produit des réponses plus précises qu'un agent écrivant du SQL directement sur des tables brutes.

Serveur MCP	Cas d'usage	Gouvernance
Genie One MCP (`system.ai.genie_one_mcp`)	Posez des questions métier en langage naturel dans votre workspace.	Autorisations et politiques Unity Gateway, ainsi que les autorisations de ressources sous-jacentes.
MCP Genie Agent	Posez des questions en langage naturel portant sur un Genie Agent organisé, à l’aide de ses tables, instructions et exemples.	Permissions sur l’agent Genie Agent et ses données. Les appels contournent Unity Gateway.
Databricks SQL MCP (`system.ai.dbsql`)	Exécutez une SQL query spécifique, telle que la validation de la syntaxe ou la création d'un pipeline.	Autorisations et politiques Unity Gateway, ainsi que les autorisations de ressources sous-jacentes.

Serveur MCP	Cas d'usage	Gouvernance
Genie One MCP (`system.ai.genie_one_mcp`)	Posez des questions métier en langage naturel dans votre workspace.	Autorisations et politiques Unity Gateway, ainsi que les autorisations de ressources sous-jacentes.
MCP Genie Agent	Posez des questions en langage naturel portant sur un Genie Agent organisé, à l’aide de ses tables, instructions et exemples.	Permissions sur l’agent Genie Agent et ses données. Les appels contournent Unity Gateway.
Databricks SQL MCP (`system.ai.dbsql`)	Exécutez une SQL query spécifique, telle que la validation de la syntaxe ou la création d'un pipeline.	Autorisations et politiques Unity Gateway, ainsi que les autorisations de ressources sous-jacentes.

Services externes

Si un outil vous demande de vous connecter, ouvrez le Link de connexion renvoyé par le MCP, autorisez l'accès au compte de votre fournisseur et réessayez l'appel. Si votre organisation nécessite une approbation, partagez le nom de l’application depuis l’écran de consentement avec votre administrateur. Pour vous connecter avant votre premier appel, vous reconnecter ou vous déconnecter, consultez la section Gérer la connexion du fournisseur.

MCP	Se connecte à
`system.ai.slack`	Serveur MCP Slack
`system.ai.github`	Serveur GitHub MCP
`system.ai.atlassian`	Jira et Confluence via le serveur MCP Atlassian Rovo
`system.ai.google_drive`	APIs Google Drive, Docs, Sheets et Slides
`system.ai.google_calendar`	API Google Calendar
`system.ai.gmail`	API Gmail
`system.ai.microsoft_365`	SharePoint, Outlook, et Teams via Microsoft Graphe

MCP	Se connecte à
`system.ai.slack`	Serveur MCP Slack
`system.ai.github`	Serveur GitHub MCP
`system.ai.atlassian`	Jira et Confluence via le serveur MCP Atlassian Rovo
`system.ai.google_drive`	APIs Google Drive, Docs, Sheets et Slides
`system.ai.google_calendar`	API Google Calendar
`system.ai.gmail`	API Gmail
`system.ai.microsoft_365`	SharePoint, Outlook, et Teams via Microsoft Graphe

Pour connaître les autorisations demandées par chaque MCP, consultez la page Fournisseurs OAuth gérés. Vérifiez que le fournisseur et votre utilisation prévue répondent aux exigences de conformité de votre organisation.

Activer l’accès en écriture GitHub et l’accès aux repository privés

Par default, system.ai.github ne peut lire que les repositories publics. Pour accéder à des repositories privés, ou pour effectuer des modifications telles que le commit de fichiers ou la création de problèmes et de demandes de tirage, le propriétaire du repository ou un administrateur d'organisation GitHub doit :

Installez l'application connecteur Databricks GitHub et accordez-lui l'accès aux repository requis.
Si l'organisation utilise une liste d'autorisation IP, ajoutez les adresses IP sortantes serverless Databricks pour le cloud et la région de votre workspace.

Connectez votre agent

Ouvrez Unity Gateway dans votre workspace et sélectionnez MCP . Copiez le nom MCP, tel que system.ai.github, et suivez votre guide de configuration :

Pour les clients qui nécessitent une URL de serveur, utilisez le modèle d'URL ci-dessus.

Pour les erreurs de connexion, d'autorisations et de connexion, voir Authentification MCP.

Limitations

system.ai.web_search n’est pas disponible dans les Workspace avec la conformité HIPAA/BAA activée. Il est disponible dans les régions américaines prises en charge ou dans les workspaces qui autorisent le traitement inter-géographique.
system.ai.sandbox ne dispose pas de sortie réseau.
system.ai.web_search et system.ai.sandbox ne sont pas disponibles pour les utilisateurs qui ont uniquement le droit d'accès Consommateur.

Endpoint non régis par Unity Gateway

Ces Endpoint MCP de Workspace utilisent des autorisations sur les Ressources sous-jacentes, telles que les agents Genie, les tables, les fonctions, les index et les SQL Warehouse.

Les appels contournent Unity Gateway et n’apparaissent donc pas dans ses tables de suivi et ne prennent pas en charge les autorisations, les politiques ou les garde-fous au niveau MCP. Pour les nouvelles intégrations, Databricks recommande les MCP system.ai dans Données et outils Databricks et Services externes lorsqu’ils prennent en charge votre cas d’utilisation.

Ces Endpoint sont en préversion publique. Utilisez l’Endpoint Genie Agent pour query un agent unique sélectionné, et l’Endpoint AI Search ou functions lorsque votre client requiert un accès MCP à ces Ressources.

Pour ces URLs, un administrateur de workspace doit activer Managed MCP Servers sur la page des previews du workspace.

Utilisez l'URL complète du serveur ci-dessous dans votre client MCP. Lors de l'utilisation d'OAuth, demandez la portée répertoriée.

Serveur	URL du serveur	Champ d’application d’OAuth
Genie Agent	`https://<workspace-hostname>/api/2.0/mcp/genie/{genie_space_id}`	`genie`
Recherche IA	`https://<workspace-hostname>/api/2.0/mcp/ai-search/{catalog}/{schema}/{index_name}`	`ai-search`
Databricks SQL	`https://<workspace-hostname>/api/2.0/mcp/sql`	`sql`
Fonctions Unity Catalog	`https://<workspace-hostname>/api/2.0/mcp/functions/{catalog}/{schema}/{function_name}`	`unity-catalog`

Serveur	URL du serveur	Champ d’application d’OAuth
Genie Agent	`https://<workspace-hostname>/api/2.0/mcp/genie/{genie_space_id}`	`genie`
Recherche IA	`https://<workspace-hostname>/api/2.0/mcp/ai-search/{catalog}/{schema}/{index_name}`	`ai-search`
Databricks SQL	`https://<workspace-hostname>/api/2.0/mcp/sql`	`sql`
Fonctions Unity Catalog	`https://<workspace-hostname>/api/2.0/mcp/functions/{catalog}/{schema}/{function_name}`	`unity-catalog`

Remplacez les espaces réservés par les valeurs de votre workspace :

Hostname du Workspace : Ouvrez votre workspace et copiez le Hostname depuis la barre d’adresse du navigateur, sans https://, le chemin ou les parameter de query. Voir Trouver l’URL de votre workspace.
Nom de catalogue, de schéma et d'index ou de fonction : Ouvrez Catalog et recherchez l'index ou la fonction. Utilisez les parties de son nom complet dans l'URL. Par exemple, main.tools.lookup_customer devient main/tools/lookup_customer.
Identifiant du Genie space : Ouvrez le Genie Agent et copiez l’identifiant du space depuis son Settings tab.

Utiliser des serveurs MCP de Unity Gateway

Ces serveurs MCP fonctionnent avec des agents de codage, des clients MCP de bureau et des agents Python. Utilisez l'URL de la passerelle Unity et la portée OAuth ai-gateway. Examinez les exigences d'accès du MCP avant de basculer.

Workspace MCP ou outil	Unity Gateway MCP	Fonctionnalités
Databricks SQL MCP (`/api/2.0/mcp/sql`)	Databricks SQL MCP (`system.ai.dbsql`)	Exécute du SQL via Unity Gateway.
Interpréteur de code (`system.ai.python_exec`) via les fonctions MCP	`system.ai.sandbox` (Unity Gateway bêta)	Exécute du code Python, SQL ou Shell via MCP.

Workspace MCP ou outil	Unity Gateway MCP	Fonctionnalités
Databricks SQL MCP (`/api/2.0/mcp/sql`)	Databricks SQL MCP (`system.ai.dbsql`)	Exécute du SQL via Unity Gateway.
Interpréteur de code (`system.ai.python_exec`) via les fonctions MCP	`system.ai.sandbox` (Unity Gateway bêta)	Exécute du code Python, SQL ou Shell via MCP.

Appeler des ressources directement à partir d’agents Python

Pour les agents Python, Databricks recommande ces bibliothèques pour appeler les ressources directement sans MCP. Ces bibliothèques ne routent pas les appels via Unity Gateway.

Ressource	Bibliothèque Python	Guide de mise en œuvre
Index de recherche IA	Outils de récupérateur AI Bridge	Query des index de recherche IA.
Fonctions Unity Catalog	`UCFunctionToolkit`	Appeler des fonctions inscrites.
Genie Agent	Outils AI Bridge	query un Genie Agent.

Ressource	Bibliothèque Python	Guide de mise en œuvre
Index de recherche IA	Outils de récupérateur AI Bridge	Query des index de recherche IA.
Fonctions Unity Catalog	`UCFunctionToolkit`	Appeler des fonctions inscrites.
Genie Agent	Outils AI Bridge	query un Genie Agent.

Tarifs des Endpoint de Workspace

Les fonctions Unity Catalog utilisent les Tarifs du compute Serverless général.
Databricks SQL utilise la Tarifs Databricks SQL.
Les index de recherche AI utilisent les Tarifs de la recherche AI.

URL du serveur MCP​

Données et outils Databricks​

Choisissez entre les serveurs MCP Genie One, Genie Agent et Databricks SQL​

Services externes​

Activer l’accès en écriture GitHub et l’accès aux repository privés​

Connectez votre agent​

Limitations​

Endpoint non régis par Unity Gateway​

Utiliser des serveurs MCP de Unity Gateway​

Appeler des ressources directement à partir d’agents Python​

Tarifs des Endpoint de Workspace​