Connecter Genie Code aux serveurs MCP

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

Qu'est-ce que MCP ?

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

MCP est conçu pour les cas où un contexte important existe déjà mais est difficile d'accès pour un agent, tel que Genie Code. 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 découvrir comment créer les vôtres, consultez MCPs and agent tools.

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

Genie Code fournit des connecteurs intégrés pour les sources de données d'entreprise courantes :

• Google Drive : recherchez et créez des documents Google Docs, Google Sheets et Google Slides ; modifiez les documents créés.
• Gmail : recherche, lecture et rédaction d'e-mails.
• Google Calendar : rechercher et créer des événements de calendrier.
• Microsoft 365 : recherchez dans SharePoint, Teams, Outlook et le calendrier ; rédigez un e-mail Outlook.
• Atlassian : recherche et mise à jour dans Jira et Confluence.
• Glean (Bêta) : effectuez des recherches dans les applications connectées de votre organisation à l'aide de Glean.
• Slack : recherchez des messages et des canaux dans Slack, et envoyez des messages.
• GitHub : recherchez et mettez à jour des repositories, des problèmes (issues) et des demandes d’extraction (pull requests).

La connexion à ces sources de données permet à Genie Code de rechercher dans vos documents et d'effectuer des actions dans les outils connectés lors de la réponse aux questions. Chaque utilisateur s'authentifie individuellement, et les jetons OAuth ne sont pas partagés entre les utilisateurs.

Ces connexions utilisent des connecteurs MCP fournis par Databricks ; il n’y a donc aucun serveur à héberger ni aucune application OAuth à enregistrer. Databricks régit chaque connexion par le biais de Unity Catalog et de Unity Gateway. La passerelle autorise chaque appel d’outil par rapport à vos autorisations Unity Catalog, applique des politiques et des exigences d’approbation intégrées, et enregistre l’utilisation ainsi que les journaux d’audit dans les tables système. Consultez la page Enregistrer un serveur MCP externe.

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.

Une fois authentifié, Genie Code peut effectuer des recherches dans vos documents pour répondre aux questions. Les administrateurs de métastore et les propriétaires de connexion peuvent gérer ou révoquer les autorisations utilisateur sur la connexion. Consultez l'étape 4. Accorder l'accès à un service MCP.

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.

Tâches planifiées et authentification

• Genie Code ne vous avertit pas lorsque l’authentification d’une connexion expire. Vous ne vous en rendrez peut-être compte que lorsqu’un appel d’outil échouera ou lorsque vous ouvrirez la liste des connexions. Réauthentifiez-vous pour résoudre.
• Changer les autorisations d’une connexion oblige chaque utilisateur à s’authentifier à nouveau. Les tâches planifiées qui utilisent la connexion échouent jusqu’à ce que l’utilisateur se réauthentifie.

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 25 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.
• Genie Code peut créer des documents Google Docs, Sheets et Slides, et modifier les documents Google Docs qu’il a créés par le biais du connecteur. Il ne peut pas modifier les documents Docs créés en dehors du connecteur, ni modifier des feuilles (Sheets) ou des présentations (Slides) existantes.
• La lecture d’un document très volumineux peut s’avérer lente.

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 de Gmail

• Genie Code peut rechercher, lire et rédiger des e-mails, mais il ne peut pas envoyer d'e-mails ni modifier les messages existants.
• Genie Code ne peut pas ajouter de fichiers Drive en tant que pièces jointes Gmail natives. Par mesure de contournement, incluez des links vers les fichiers dans le corps de l'e-mail.

Limitations de Microsoft 365

• Comprend SharePoint, Teams, Outlook et le Calendrier.
• Genie Code peut rédiger un e-mail Outlook, mais ne peut pas l'envoyer.
• Maximum file size is 25 MB for SharePoint files.
• Les types de fichiers SharePoint pris en charge incluent les documents Office (.docx, .xlsx, .pptx), ainsi que les formats textuels courants tels que .txt, .csv, .json, .md et d'autres. Les fichiers PDF, les images et les autres formats binaires ne sont pas pris en charge.

Limitations de Glean (bêta)

• Glean est un outil de recherche uniquement. Impossible de lire un document à partir d’un link direct.
• Un administrateur de métastore doit d'abord configurer l'ID de tenant Glean avant que les utilisateurs non administrateurs puissent utiliser la connexion. L'administrateur peut saisir l'ID de tenant lors de la première connexion à Glean.
• Pour vous connecter à un serveur MCP Glean spécifique, un administrateur de metastore peut éventuellement définir le chemin du serveur MCP (par exemple, /mcp/eng) lors de la configuration de la connexion. Laissez ce champ vide pour utiliser le chemin par default (/mcp/default). Les utilisateurs non administrateurs ne peuvent pas spécifier ou modifier le chemin du serveur MCP Glean.

Limites de Slack

• Genie Code ne peut pas modifier ou supprimer un message après l’avoir envoyé.

Limitations de GitHub

• Les écritures sont limitées au contenu des fichiers, aux problèmes et aux demandes de tirage.
• 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.

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.