Conexión de Genie Code a servidores MCP

Genie Code se conecta a herramientas, documentos y datos externos a través de servidores Model Context Protocol (MCP) y conectores nativos para Google Drive, Gmail, Google Calendar, Microsoft 365, Atlassian, Glean, Slack y GitHub. Use los conectores nativos para orígenes saaS comunes o agregue sus propios servidores MCP externos o personalizados desde el área de trabajo. Elija las herramientas que se van a habilitar en la configuración de Genie Code.

¿Qué es MCP?

MCP es un código abierto estándar que conecta agentes a herramientas, recursos, avisos y otra información contextual. MCP proporciona una manera estandarizada de exponer herramientas, datos y flujos de trabajo a Genie Code sin insertar ese contexto directamente en indicaciones o instrucciones.

MCP está diseñado para casos en los que ya existe un contexto importante, pero es difícil acceder desde un agente, como Genie Code. MCP ofrece una manera segura de conceder acceso a Genie Code al contexto como el siguiente:

• Sistemas de documentación: Teams suele mantener runbooks o documentos operativos en herramientas como Confluence. En lugar de copiar secciones en mensajes, ese contenido se puede exponer una vez a través de un servidor MCP externo y referenciarlo cuando sea relevante. Es posible que los documentos también estén en Databricks como un índice de búsqueda de IA, que Genie Code puede usar para consultar documentos pertinentes.
• Herramientas y servicios: los equipos de plataforma pueden mantener las API o scripts para la configuración, validación o implementación. MCP hace que esas funcionalidades estén disponibles directamente para Genie Code.
• Orígenes de datos: si ya tiene datos en Databricks, puede conectar Genie Code a un agente de Genie para ayudarle a analizar los datos mediante lenguaje natural. En el caso de los datos almacenados fuera de Databricks, puede conceder acceso seguro a Genie Code a través de servidores MCP externos.
• Aplicaciones personalizadas: también puede agregar funcionalidad personalizada hospedada a través de Aplicaciones de Databricks. Esto le permite conectar Genie Code a herramientas, flujos de trabajo o integraciones propietarios creados específicamente para usted o su organización, todos administrados de forma segura dentro del área de trabajo de Databricks.

En estos casos, MCP reemplaza el pegado manual de copia por un enfoque estructurado y reutilizable, lo que hace que el contexto adecuado esté disponible solo cuando sea necesario.

Puede conectar Genie Code a cualquier servidor MCP del área de trabajo que tenga permiso para usar. Los administradores del área de trabajo controlan qué servidores están disponibles, mientras que los usuarios pueden seleccionar entre esos orígenes aprobados según sea necesario.

Para saber más sobre los servidores MCP en Databricks y cómo crear los tuyos propios, consulta MCPs y herramientas para agentes.

Uso de conectores nativos para orígenes de datos de terceros

Genie Code proporciona conectores integrados para fuentes de datos empresariales comunes:

• Google Drive: Buscar y crear Google Docs, Sheets y Slides; editar Docs que creó.
• Gmail: Buscar, leer y redactar correos electrónicos.
• Google Calendar: Busca y crea eventos en el calendario.
• Microsoft 365: Busca en SharePoint, Teams, Outlook y Calendario; redacta el correo electrónico de Outlook.
• Atlassian: Busca y actualiza Jira y Confluence.
• Glean (Beta): Busca entre las aplicaciones conectadas de tu organización usando Glean.
• Slack: Busca mensajes y canales de Slack, y envía mensajes.
• GitHub: Buscar y actualizar repositorios, incidencias y pull requests.

Conectarse a estas fuentes de datos permite a Genie Code buscar en tus documentos y tomar acciones en herramientas conectadas al responder preguntas. Cada usuario se autentica individualmente y los tokens de OAuth no se comparten entre los usuarios.

Estas conexiones usan conectores MCP proporcionados por Databricks, así que no hay servidor que alojar ni app OAuth que registrar. Azure Databricks gobierna cada conexión a través de Unity Catalog y Unity Gateway. La pasarela autoriza cada llamada a la herramienta de acuerdo con tus permisos de Unity Catalog, aplica políticas incorporadas y requisitos de aprobación, y registra registros de uso y de auditoría en las tablas del sistema. Véase Registrar un servidor MCP externo.

Para conectar un origen de datos de terceros:

1. En el área de trabajo, haga clic en Genie Code en la esquina superior derecha para abrir un chat.
2. En la barra de comandos, haga clic en , el icono de más.
3. Junto al origen de datos al que desea conectarse, haga clic en Conectar.
4. Complete los pasos para iniciar sesión.

Después de autenticarte, Genie Code puede buscar en tus documentos al responder a preguntas. Los administradores de metastore y los propietarios de conexiones pueden administrar o revocar permisos de usuario en la conexión. Ver Paso 4. Conceder acceso a un Servicio MCP.

Nota:

Las herramientas de origen de datos no siempre se desencadenan automáticamente. Si no se inicia la búsqueda de documentos, intente pedir explícitamente a Genie Code que use la herramienta, por ejemplo, "use Google Docs" o "use SharePoint".

Para conectar otros orígenes de datos, agréguelos manualmente a Genie Code. Consulte Incorporación manual de servidores MCP a Genie Code.

Tareas programadas y autenticación

• El Código Genie no te avisa cuando expira la autenticación de una conexión. Puede que solo lo descubras cuando falla una llamada a la herramienta o cuando abres la lista de conexiones. Vuelva a autenticarse para resolverlo.
• Cambiar los permisos de una conexión requiere que cada usuario se vuelva a autenticar. Las tareas programadas que usan la conexión fallan hasta que el usuario vuelve a autenticarse.

Limitaciones de Google Drive

• Al autorizar Google Drive, es posible que vea una pantalla de "aplicación no verificada". Haga clic en Avanzadas y continúe con el proceso de autorización.
• El tamaño máximo de archivo es de 25 MB.
• Solo se admiten archivos nativos de Google Workspace (Docs, Sheets, Slides). No se admiten archivos PDF, imágenes y otros formatos binarios.
• Genie Code puede crear Documentos, Hojas de cálculo y Presentaciones de Google, y editar los Documentos de Google que ha creado a través del conector. No puede editar documentos creados fuera del conector, ni editar hojas o diapositivas existentes.
• Leer un documento muy grande puede ser lento.

Nota:

El uso y transferencia de datos de usuario sin procesar o derivados recibidos de las API de Google Workspace se adhiere a la Directiva de datos de usuario de los servicios de API de Google, incluidos los requisitos de uso limitado.

Limitaciones de Gmail

• Genie Code puede buscar, leer y redactar correos electrónicos, pero no puede enviar correos ni editar mensajes existentes.
• Genie Code no puede añadir archivos de Drive como archivos adjuntos nativos de Gmail. Como solución alternativa, incluye enlaces a los archivos en el cuerpo del correo.

Limitaciones de Microsoft 365

• Incluye SharePoint, Teams, Outlook y Calendario.
• Genie Code puede redactar el correo de Outlook pero no puede enviarlo.
• El tamaño máximo de archivo es de 25 MB para archivos SharePoint.
• Los tipos de archivo SharePoint compatibles incluyen documentos de Office (.docx, .xlsx, .pptx), así como formatos comunes basados en texto como .txt, .csv, .json, .md, y otros. No se admiten archivos PDF, imágenes y otros formatos binarios.

Limitaciones de Glean (Beta)

• Glean solo permite búsquedas. No puede leer un documento desde un enlace directo.
• Un administrador de metastore debe configurar primero el ID de tenant de Glean antes de que los usuarios no administradores puedan usar la conexión. El administrador puede introducir el ID del tenant al conectarse por primera vez a Glean.
• Para conectarse a un servidor MCP específico de Glean, un administrador de metastore puede opcionalmente establecer la ruta del servidor MCP (por ejemplo, /mcp/eng) al configurar la conexión. Deja este campo en blanco para usar la ruta predeterminada (/mcp/default). Los usuarios no administradores no pueden especificar ni cambiar la ruta del servidor MCP de Glean.

Limitaciones de Slack

• Genie Code no puede editar ni borrar un mensaje después de enviarlo.

limitaciones de GitHub

• La escritura se limita al contenido de los archivos, las incidencias y las pull requests.
• De forma predeterminada, el conector de Databricks GitHub MCP solo puede acceder a repositorios públicos. Para conceder al conector acceso de lectura a los repositorios privados de empresa, un administrador de la organización de GitHub debe completar una configuración adicional. Consulte Habilitación del acceso al repositorio privado.
• GitHub Enterprise Server (la versión autohospedada de GitHub) no se admite.

Adición manual de servidores MCP a Genie Code

Para conectar Genie Code a un servidor MCP, agréguelo en la configuración de Genie Code:

1. Abra la configuración de Genie Code. En el panel Genie Code (Código de Genie), haga clic en Configuración.
2. En Servidores MCP, haga clic en Agregar servidor.
3. Seleccione los servidores MCP que desea agregar. Puede seleccionar Servidores MCP administrados de Databricks o servidores MCP externos:
   • Función catálogo de Unity: seleccione el esquema de la función. Esto permite que Genie Code use funciones para ejecutar consultas SQL predefinidas.
     • Para obtener ayuda para crear un servidor MCP personalizado de GitHub, consulte Buscar código en GitHub con Genie Code.
   • Búsqueda de IA: seleccione el esquema del índice. Esto permite que Genie Code consulte el índice de búsqueda de IA para buscar documentos relevantes.
   • Agente de Genie: seleccione el Agente de Genie. Genie MCP invoca a Genie como una herramienta, lo que le permite consultar al agente de Genie para analizar datos mediante lenguaje natural.
   • Servidor MCP externo: seleccione la conexión del catálogo de Unity que se usará como servidor MCP externo. Debe iniciar sesión primero en la conexión para poder usarla.
   • Servidor MCP personalizado: seleccione la aplicación databricks que se usará como un servidor MCP personalizado. Esto le permite usar cualquier herramienta personalizada. Se aplican los siguientes requisitos:
     • La aplicación debe implementarse en la misma área de trabajo desde la que intenta conectarse.
     • Se debe tener acceso al servidor MCP en https://<server-url>/mcp.
     • La aplicación debe ser sin estado. Por ejemplo, establezca mcp_app = mcp_server.http_app(stateless_http=True).
     • Si se producen errores de CORS, es posible que tenga que agregar la dirección URL del área de trabajo a la lista de orígenes permitidos de la aplicación. Por ejemplo, establezca app.add_middleware(CORSMiddleware, allow_origins=ALLOWED_ORIGINS, allow_credentials=True, allow_methods= ["*"], allow_headers= ["*"]).
4. Haz clic en Guardar.

Una vez agregados, los servidores MCP están disponibles inmediatamente para Genie Code. Puede empezar a usarlos sin cambiar las indicaciones ni las instrucciones. Genie Code utiliza automáticamente estos servidores cuando corresponde.

Puede elegir qué herramientas y servidores habilitar o deshabilitar en la configuración de Genie Code.

Limitaciones

Para orientaciones de cumplimiento para aplicaciones conectadas, consulte Limitaciones del servicio MCP proporcionado por Databricks.

• Los servidores MCP externos solo están disponibles en las regiones en las que se admite Model Serving. Consulte Disponibilidad de características de modelo de servicio.