Connecter Genie Code aux serveurs MCP

Genie Code se connecte à des outils externes, des documents et des données via des serveurs Model Context Protocol (MCP) et des connecteurs natifs pour Google Drive, SharePoint, GitHub, Glean, Atlassian et Slack. Utilisez les connecteurs natifs pour les sources SaaS courantes, ou ajoutez vos propres serveurs MCP externes ou personnalisés depuis le Workspace. Vous choisissez quels outils activer dans les paramètres de Genie Code.

Qu'est-ce que MCP ?

MCP est une norme open source qui connecte les agents d'IA aux outils, aux Ressources, aux invites et à d'autres informations contextuelles. MCP fournit un moyen standardisé d'exposer des outils, des données et des workflows à Genie Code sans intégrer ce contexte directement dans les invites ou les instructions.

Le MCP est conçu pour les cas où un contexte important existe déjà, mais est difficile d'accès depuis un agent d'IA, tel que Genie Code. Le MCP offre un moyen sécurisé de donner à Genie Code l'accès à un contexte tel que le suivant :

• Systèmes de documentation : Les équipes conservent souvent des runbooks ou des documents opérationnels dans des outils comme Confluence. Au lieu de copier des sections dans des invites, ce contenu peut être exposé une seule fois par l'intermédiaire d'un serveur MCP externe et référencé le cas échéant. Vos documents pourraient aussi déjà se trouver dans Databricks sous forme d'index de recherche d'IA, que Genie Code peut utiliser pour interroger des documents pertinents.
• Outils et services : Les équipes de la plateforme peuvent maintenir des APIs ou des scripts pour la configuration, la validation ou le déploiement. MCP met ces capacités directement à la disposition de Genie Code.
• Sources de données : Si vous avez déjà des données dans Databricks, vous pouvez connecter Genie Code à un Genie Agent pour vous aider à analyser les données en langage naturel. Pour les données stockées en dehors de Databricks, vous pouvez donner un accès sécurisé à Genie Code via des serveurs MCP externes.
• Applications personnalisées : Vous pouvez également ajouter des fonctionnalités personnalisées hébergées via des Databricks Apps. Cela vous permet de connecter Genie Code à des outils propriétaires, des workflows ou des intégrations conçus spécifiquement pour vous ou votre organisation, le tout géré en toute sécurité au sein de votre Databricks Workspace.

Dans ces cas, le MCP remplace le copier-coller manuel par une approche structurée et réutilisable, rendant le bon contexte disponible uniquement lorsqu'il est nécessaire.

Vous pouvez connecter Genie Code à n'importe quel serveur MCP de votre Workspace pour lequel vous avez l'autorisation d'utiliser. Les administrateurs du Workspace contrôlent quels serveurs sont disponibles, tandis que les utilisateurs peuvent sélectionner parmi ces sources approuvées selon leurs besoins.

Pour en savoir plus sur les serveurs MCP dans Databricks et comment créer les vôtres, consultez Model Context Protocol (MCP) sur Databricks.

Utiliser des connecteurs natifs pour les sources de données tierces

info

Aperçu

Cette fonctionnalité est en Bêta. Pour utiliser les connecteurs de sources de données tierces, un administrateur du Workspace doit activer l'aperçu Connecteurs tiers pour les agents . Consultez Gérer les aperçus Databricks.

Genie Code propose des connecteurs intégrés pour les sources de données d'entreprise courantes, notamment Google Drive, SharePoint, GitHub, Glean, Atlassian et Slack.

La connexion à ces sources de données permet à Genie Code de rechercher dans vos documents pour répondre aux questions. Chaque utilisateur s'authentifie individuellement, et les jetons OAuth ne sont pas partagés entre les utilisateurs.

Pour connecter une source de données tierce :

1. Dans votre Workspace, cliquez sur Genie Code dans le coin supérieur droit pour ouvrir un chat.
2. Dans la barre d'invite, cliquez sur l'icône plus.
3. À côté de la source de données à laquelle vous souhaitez vous connecter, cliquez sur Se connecter .
4. Terminez les étapes pour vous connecter.

Après vous être authentifié, Genie Code peut rechercher vos documents lorsqu'il répond à des questions. Les administrateurs du métastore et les propriétaires de connexion peuvent gérer ou révoquer les autorisations des utilisateurs sur la connexion. Voir Étape 4. Accorder l'accès aux coéquipiers.

remarque

Les outils de source de données ne se Trigger pas toujours automatiquement. Si la recherche de document ne démarre pas, essayez d'inviter explicitement Genie Code à utiliser l'outil, par exemple « utiliser Google Docs » ou « utiliser SharePoint ».

Pour connecter d’autres sources de données, ajoutez-les manuellement à Genie Code. Consultez Ajouter manuellement des serveurs MCP à Genie Code.

Limitations de Google Drive

• Lorsque vous autorisez Google Drive, vous pourriez voir un écran « application non vérifiée ». Cliquez sur Avancé et continuez le processus d'autorisation.
• La taille maximale du fichier est de 10 Mo.
• Seuls les fichiers natifs Google Workspace (Docs, Sheets, Slides) sont pris en charge. Les PDF, les images et les autres formats binaires ne sont pas pris en charge.
• Des erreurs de connexion ou d’expiration de jeton peuvent apparaître dans la sortie de l’agent. Veuillez vous réauthentifier pour résoudre le problème.

remarque

L'utilisation et le transfert des données utilisateur brutes ou dérivées reçues des API Google Workspace respecteront la politique relative aux données utilisateur des services API Google, y compris les exigences d'utilisation limitée.

Limitations SharePoint

• La taille maximale du fichier est de 10 Mo.
• Les types de fichiers pris en charge incluent les documents Office (.docx, .xlsx, .pptx), ainsi que des formats textuels courants tels que .txt, .csv, .json, .md, et d'autres. Les PDF, les images et les autres formats binaires ne sont pas pris en charge.

Limitations de GitHub

• Par default, le connecteur Databricks GitHub MCP peut accéder uniquement aux repository publics. Pour donner au connecteur un accès en lecture à vos private enterprise repository, un administrateur d'organisation GitHub doit effectuer une configuration supplémentaire. Consultez Activer l'accès au repository privé.
• GitHub Enterprise Server (la version auto-hébergée de GitHub) n'est pas pris en charge.

Limitations de Glean

• Un administrateur de workspace doit d'abord configurer l'ID de tenant Glean avant que les utilisateurs non-administrateurs ne puissent utiliser la connexion. L'administrateur peut saisir l'ID du tenant lors de la première connexion à Glean.

Ajouter manuellement des serveurs MCP à Genie Code

Pour connecter Genie Code à un serveur MCP, ajoutez-le dans vos paramètres Genie Code :

1. Ouvrez les paramètres de Genie Code. Dans le volet Genie Code, cliquez sur Paramètres .

2. Sous Serveurs MCP , cliquez sur Ajouter un serveur .

3. Sélectionnez les serveurs MCP que vous souhaitez ajouter. Vous pouvez sélectionner des serveurs MCP gérés par Databricks ou des serveurs MCP externes :

   • Fonction Unity Catalog : Sélectionnez le schéma de la fonction. Cela permet à Genie Code d'utiliser des fonctions pour exécuter des requêtes SQL prédéfinies.

     • Pour obtenir de l'aide pour créer un serveur GitHub MCP personnalisé, consultez Rechercher du code GitHub avec Genie Code.

   • AI Search : sélectionnez le schéma de l'index. Ceci permet à Genie Code d'interroger l'index de recherche IA pour trouver des documents pertinents.

   • Genie Agent : Sélectionnez le Genie Agent. Le Genie MCP invoque Genie comme un outil, vous permettant de query le Genie Agent pour analyser les données à l'aide du langage naturel.

   • Serveur MCP externe : Sélectionnez la connexion Unity Catalog à utiliser comme serveur MCP externe. Vous devez vous connecter à la connexion avant de pouvoir l'utiliser.

   • Serveur MCP personnalisé : sélectionnez l'Application Databricks à utiliser comme serveur MCP personnalisé. Cela vous permet d’utiliser tous les outils personnalisés. Les exigences suivantes s'appliquent :

     • Votre application doit être déployée dans le même Workspace que celui auquel vous essayez de vous connecter.
     • Le serveur MCP doit être accessible à l'adresse https://<server-url>/mcp.
     • Votre application doit être sans état. Par exemple, définissez mcp_app = mcp_server.http_app(stateless_http=True).
     • Si vous rencontrez des erreurs CORS, vous devrez peut-être ajouter l'URL de votre Workspace à la liste des origines autorisées de votre application. Par exemple, définissez app.add_middleware(CORSMiddleware, allow_origins=ALLOWED_ORIGINS, allow_credentials=True, allow_methods= ["*"], allow_headers= ["*"]).

4. Cliquez sur Enregistrer .

Une fois ajoutés, les serveurs MCP sont immédiatement disponibles pour Genie Code. Vous pouvez start à les utiliser sans modifier vos invites ou vos instructions. Genie Code s'appuie automatiquement sur ces serveurs lorsque cela est pertinent.

Vous pouvez choisir les outils et les serveurs à activer ou à désactiver dans vos paramètres Genie Code.

Limitations

• Les serveurs MCP externes sont uniquement disponibles dans les régions où Model Serving est pris en charge. Voir la disponibilité des fonctionnalités de Model Serving.