MCPs proporcionados por Databricks

Azure Databricks proporciona MCPs en el system.ai esquema para datos y servicios externos. Elige un MCP a continuación y luego conecta tu agente. No necesitas alojar ni registrar un servidor.

Cada MCP es un elemento protegible de Unity Catalog invocado a través de Unity Gateway. Puedes controlar quién los invoca con permisos y controlar las llamadas individuales con políticas.

URL del servidor MCP

Para cualquier system.ai MCP, usa esta URL:

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

Sustituye <workspace-hostname> por el nombre de host de tu espacio de trabajo y <mcp-name> por el nombre completo de las tablas siguientes, como system.ai.dbsql.

Datos y herramientas de Databricks

Importante

Para usar system.ai.dbsql, system.ai.sandbox, o system.ai.web_search, un administrador de cuenta debe habilitar la beta Unity Gateway desde la página de Previews de la consola de cuentas. Consulta Administrar vistas previas de la cuenta.

El Genie One MCP está generalmente disponible.

MCP Description
system.ai.genie_one_mcp Recomendado para análisis de lenguaje natural en todo tu espacio de trabajo. Responde preguntas con Genie One, que se basa en la ontología de Genie.
system.ai.dbsql Ejecuta consultas SQL específicas para desarrollo e ingeniería de datos en un almacén SQL, usando el Unity Catalog del llamador y los permisos del almacén.
system.ai.sandbox Ejecuta Python, SQL o código shell en un entorno aislado.

Elige entre los servidores Genie One, Genie Agent y Databricks SQL MCP

Para casos de uso analíticos, empieza por el servidor MCP de Genie One. Genie resuelve términos de negocio, definiciones métricas y relaciones de tablas a través de Genie Ontology, tu capa semántica gobernada. Esto produce respuestas más precisas que un agente que escribe SQL directamente sobre tablas en bruto.

Servidor MCP Caso de uso
Genie One MCP (system.ai.genie_one_mcp) Haz preguntas empresariales en lenguaje natural en todo tu espacio de trabajo.
Genie Agent MCP Haz preguntas en lenguaje natural limitadas a un único Genie Agent seleccionado, utilizando las tablas, instrucciones y ejemplos que sus autores han configurado.
Databricks SQL MCP (system.ai.dbsql) Ejecuta una consulta SQL específica que ya hayas escrito, como validar la sintaxis o crear una pipeline.

Servicios externos

Si una herramienta te pide iniciar sesión, abre el enlace de inicio de sesión que te devuelve el MCP, autoriza el acceso a tu cuenta de proveedor y vuelve a intentar la llamada. Si tu organización necesita aprobación, comparte el nombre de la aplicación desde la pantalla de consentimiento con tu administrador.

MCP Se conecta a
system.ai.slack Servidor MCP de Slack
system.ai.github Servidor MCP de GitHub
system.ai.atlassian Jira y Confluence a través del servidor MCP Atlassian Rovo
system.ai.google_drive APIs de Google Drive, Docs, Sheets y Slides
system.ai.google_calendar API de Calendario de Google
system.ai.gmail Gmail API
system.ai.microsoft_365 SharePoint, Outlook y Teams a través de Microsoft Graph

Para los permisos que solicita cada MCP, véase Proveedores OAuth gestionados. Verifica que el proveedor y tu uso previsto cumplan con los requisitos de cumplimiento de tu organización.

Repositorios privados de GitHub

Por defecto, system.ai.github solo puede acceder a repositorios públicos. Un administrador de organización de GitHub debe:

  1. Instala la aplicación conector de Databricks para GitHub y concédele acceso a los repositorios necesarios.

  2. Si la organización utiliza una lista de direcciones IP permitidas, añade las IP de salida sin servidor de Azure Databricks para la nube y región de tu espacio de trabajo.

Conectar su agente

Abre Unity Gateway en tu espacio de trabajo y selecciona MCPs. Copia el nombre MCP, como system.ai.github, y sigue tu guía de configuración:

Para clientes que requieren una URL de servidor, utilice el patrón de URL anterior.

Para iniciar sesión, permisos y errores de conexión, véase autenticación MCP y redes.

Limitaciones

  • system.ai.sandbox no tiene salida a la red.
  • system.ai.web_search y system.ai.sandbox no están disponibles para los usuarios que solo tienen derecho al acceso del consumidor .

Puntos de conexión de espacios de trabajo heredados

Las integraciones existentes pueden seguir utilizando estos endpoints MCP de espacio de trabajo. Para nuevas conexiones SQL de Genie One y Databricks, utiliza los system.ai MCPs mencionados arriba.

Note

Los endpoints de workspace heredados eluden Unity Gateway. Sus llamadas no aparecen en las tablas de trazado de Unity Gateway y no admiten concesiones, políticas ni protecciones a nivel de MCP del Catálogo de Unity. El acceso se controla mediante permisos sobre los recursos subyacentes, como tablas, funciones, índices y almacenes SQL.

Para estas URLs heredadas, un administrador de espacio de trabajo debe habilitar los Servidores MCP Gestionados en la página de Previsualizaciones del espacio de trabajo. Consulta la página de cada servidor para ver el estado de publicación.

Utiliza la URL completa del servidor que aparece a continuación en tu cliente MCP. Al usar OAuth, solicita el scope indicado.

Server Dirección URL del servidor Ámbito de OAuth
Búsqueda de 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
Funciones de Unity Catalog https://<workspace-hostname>/api/2.0/mcp/functions/{catalog}/{schema}/{function_name} unity-catalog

Sustituye los marcadores de posición por valores de tu espacio de trabajo:

  • Nombre de host del espacio de trabajo: Abre tu espacio de trabajo y copia el nombre del host desde la barra de direcciones del navegador, sin https://, la ruta o los parámetros de consulta. Consulta Encontrar la URL de tu espacio de trabajo.
  • Catálogo, esquema e índice o nombre de la función: Abre Catálogo y encuentra el índice o función. Utiliza las partes de su nombre completo en la URL. Por ejemplo, main.tools.lookup_customer se convierte en main/tools/lookup_customer.

Las opciones del SDK y el kit de herramientas que aparecen a continuación son para agentes en Python. Para herramientas nativas en agentes de codificación, usa una conexión MCP.

MCP o herramienta heredada Enfoque recomendado Qué hace
Databricks SQL MCP Databricks SQL MCP (system.ai.dbsql) Ejecuta SQL a través de Unity Gateway.
AI Search MCP Herramientas de recuperación de AI Bridge Consulta tus índices de búsqueda de IA directamente desde Python.
Funciones MCP de Unity Catalog UCFunctionToolkit Llama a tus funciones registradas directamente desde Python.
Intérprete de código (system.ai.python_exec) a través de las funciones MCP system.ai.sandbox (Unity Gateway Beta) Ejecuta Python, SQL o código shell a través de MCP.

Para los system.ai MCP, utiliza la URL de Unity Gateway y el ai-gateway alcance OAuth. Revisa los requisitos de acceso del MCP antes de cambiar.

Precios de los endpoints del workspace

  • Se actualizó por última vez el