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 est un élément sécurisable Unity Catalog invoqué via Unity Gateway. Vous pouvez régir qui les invoque avec des attributions de rôles (grants) et régir les appels individuels avec des politiques.

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é.

Genie One MCP par rapport aux serveurs MCP Databricks SQL

For analytique use cases, start with the Genie One MCP server. Genie resolves business terms, metric definitions, and table relationships through Genie Ontology, your governed semantic layer. This produces more accurate answers than an agent writing SQL directly against raw tables.

Utilisez le serveur MCP Databricks SQL lorsque vous devez exécuter une query précise que vous avez déjà écrite, par exemple pour valider la syntaxe ou créer un pipeline.

Services externes

Si un outil vous demande de vous connecter, ouvrez le Link de connexion renvoyé par le MCP, autorisez l’accès à votre compte fournisseur et réessayez l’appel. Si votre organisation exige une approbation, partagez le nom de l’application de l’écran de consentement avec votre administrateur.

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.

repository privés GitHub

Par default, system.ai.github peut accéder uniquement aux repositories publics. Un administrateur de l’organisation GitHub doit :

1. Installez l'application connecteur Databricks GitHub et accordez-lui l'accès aux repository requis.

2. 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 :

• Claude Code, Codex, Cursor et autres agents de codage
• Agents Python

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

Pour les erreurs de connexion, de permissions et de connexion au réseau, consultez l’authentification et la mise en réseau 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.

Endpoints Workspace hérités

Les intégrations existantes peuvent continuer à utiliser ces Endpoint MCP du Workspace. Pour les nouvelles connexions Genie One et Databricks SQL, utilisez les MCP system.ai listés ci-dessus.

remarque

Les Endpoint du Workspace hérités contournent Unity Gateway. Leurs appels n'apparaissent pas dans les tables de traçabilité de Unity Gateway et ne prennent pas en charge les attributions, politiques ou garde-fous Unity Catalog au niveau de MCP. L’accès est contrôlé par les autorisations sur les ressources sous-jacentes, telles que les tables, les fonctions, les index et les SQL Warehouse.

Pour ces URL existantes, un administrateur du Workspace doit activer les serveurs MCP gérés sur la page d'aperçu du Workspace. Consultez la page de chaque serveur pour connaître son statut de publication.

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.
• Identifiant du Genie space : Ouvrez le Genie Agent et copiez l’identifiant du space depuis son Settings tab.
• 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.

Chemins recommandés pour les nouveaux agents

Les options du SDK et de la boîte à outils ci-dessous sont destinées aux agents Python. Pour les outils natifs dans les agents de codage, utilisez une connexion MCP.

MCP ou outil hérité	Approche recommandée	Fonctionnalités
MCP Genie Agent	Exemples d’outils AI Bridge	query le même agent Genie Agent préparé à partir de Python. Pour des analytiques plus larges, utilisez le Genie One MCP.
Databricks SQL MCP	Databricks SQL MCP (system.ai.dbsql)	Exécute du SQL via Unity Gateway.
MCP de recherche d'IA	Outils de récupérateur AI Bridge	Exécute des queries sur vos index de recherche IA directement à partir de Python.
Fonctions MCP Unity Catalog	UCFunctionToolkit	Appelle vos fonctions enregistrées directement depuis Python.
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.

MCP ou outil hérité	Approche recommandée	Fonctionnalités
MCP Genie Agent	Exemples d’outils AI Bridge	query le même agent Genie Agent préparé à partir de Python. Pour des analytiques plus larges, utilisez le Genie One MCP.
Databricks SQL MCP	Databricks SQL MCP (system.ai.dbsql)	Exécute du SQL via Unity Gateway.
MCP de recherche d'IA	Outils de récupérateur AI Bridge	Exécute des queries sur vos index de recherche IA directement à partir de Python.
Fonctions MCP Unity Catalog	UCFunctionToolkit	Appelle vos fonctions enregistrées directement depuis Python.
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.

Pour les MCP system.ai, utilisez l’ URL Unity Gateway et le champ d’application OAuth ai-gateway. Consultez les exigences d’accès du MCP avant de basculer.

Tarifs des Endpoint de Workspace

• Les fonctions Unity Catalog utilisent les Tarifs du compute Serverless général.
• Les agents Genie et Databricks SQL utilisent les tarifs de Databricks SQL.
• Les index de recherche AI utilisent les Tarifs de la recherche AI.