Compartir a través de

Conexión de Genie Code a servidores MCP

Conecte Genie Code a herramientas externas y orígenes de datos a través del Protocolo de contexto de modelo (MCP). Genie Code puede usar cualquier servidor MCP que se haya agregado al área de trabajo y que tenga permiso para usar.

Nota:

Los servidores MCP solo se admiten en Agent mode del Genie Code.

¿Qué es MCP?

MCP es un estándar código abierto que conecta los agentes de IA 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 de IA, 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 vectorial, 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 espacio 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 más información sobre los servidores MCP en Databricks y cómo crear sus propios, consulte Model Context Protocol (MCP) en Databricks.

Conexión a orígenes de datos de terceros

Importante

Esta característica se encuentra en su versión beta. Para usar conectores de origen de datos de terceros, un administrador del área de trabajo debe habilitar los conectores de terceros para agentes en modo de vista previa. Consulte Administrar Azure Databricks versiones preliminares.

Genie Code proporciona conectores integrados para orígenes de datos empresariales comunes, como Google Drive y SharePoint.

La conexión a estos orígenes de datos permite a Genie Code buscar documentos al responder a preguntas. Cada usuario se autentica individualmente y los tokens de OAuth no se comparten entre los usuarios.

Para conectar un origen de datos de terceros:

  1. En el área de trabajo, haga clic en el icono de código de Sparkle genie. Genie Code en la esquina superior derecha para abrir un chat.
  2. En la barra de comandos, haga clic en Nuevo icono, 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. Consulte Uso compartido de la conexión del servidor 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.

Limitaciones de Google Drive

  • El tamaño máximo de archivo es de 10 MB.
  • Solo se admiten archivos nativos de Google Workspace (Docs, Sheets, Slides). No se admiten archivos PDF, imágenes y otros formatos binarios.
  • Los errores de expiración del token o de conexión pueden aparecer en la salida del agente. Vuelva a autenticarse para resolverlo.

limitaciones de SharePoint

  • El tamaño máximo de archivo es de 10 MB.
  • Los tipos de archivo admitidos incluyen documentos de Office (.docx, .xlsx, .pptx), así como formatos basados en texto comunes, como .txt, .csv, .json, .mdy otros. No se admiten archivos PDF, imágenes y otros formatos binarios.

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, haga clic en Icono de engranaje. Configuración.
  2. En Servidores MCP, haga clic en nuevo icono. 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.
    • Búsqueda de vectores: seleccione el esquema del índice. Esto permite que Genie Code consulte el índice de búsqueda vectorial para buscar documentos relevantes.
    • Espacio de Genie: seleccione el espacio de Genie. Genie MCP invoca a Genie como una herramienta, lo que le permite consultar el espacio 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 stateless. 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 en modo agente sin cambiar las indicaciones ni las instrucciones. Genie Code utilizará automáticamente estos servidores cuando sea pertinente.

Actualmente, el acceso a MCP está limitado a 20 herramientas en todos los servidores. Puede elegir qué herramientas y servidores habilitar o deshabilitar en la configuración de Genie Code.

  • Last updated on