Connecter Le code Genie 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, Gmail, Google Agenda, 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 à partir de l’espace de travail. Vous choisissez les outils à activer dans les paramètres de Génie Code.

Qu’est-ce que MCP ?

MCP est une norme open source qui connecte des agents à des outils, des ressources, des invites et d’autres informations contextuelles. MCP fournit un moyen standardisé d’exposer des outils, des données et des flux de travail à Genie Code sans incorporer ce contexte directement dans des invites ou des instructions.

MCP est conçu pour les cas où un contexte important existe déjà, mais est difficile à accéder à partir d’un agent, comme Genie Code. MCP offre un moyen sécurisé d’accorder à Genie Code l’accès au contexte comme suit :

• Systèmes de documentation : Teams conserve souvent des runbooks ou des documents opérationnels dans des outils tels que Confluence. Au lieu de copier des sections dans des demandes, ce contenu peut être rendu disponible une fois par le biais d’un serveur MCP externe et référencé lorsqu’il est pertinent. Vos documents peuvent également être déjà dans Databricks en tant qu’index de recherche IA, que Genie Code peut utiliser pour interroger des documents pertinents.
• Outils et services : les équipes de plateforme peuvent gérer des API ou des scripts pour l’installation, la validation ou le déploiement. MCP met ces fonctionnalité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 Agent Genie pour vous aider à analyser les données à l’aide du langage naturel. Pour les données stockées en dehors de Databricks, vous pouvez accorder à Genie Code un accès sécurisé via des serveurs MCP externes.
• Applications personnalisées : vous pouvez également ajouter des fonctionnalités personnalisées hébergées via Databricks Apps. Cela vous permet de connecter Genie Code à des outils, workflows ou intégrations propriétaires créés spécifiquement pour vous ou votre organisation, tous gérés en toute sécurité dans votre espace de travail Databricks.

Dans ce cas, MCP remplace le collage manuel par une approche structurée et réutilisable, ce qui rend le contexte approprié disponible uniquement quand il est nécessaire.

Vous pouvez connecter Genie Code à tous les serveurs MCP de votre espace de travail que vous êtes autorisé à utiliser. Les administrateurs d’espace de travail contrôlent les serveurs disponibles, tandis que les utilisateurs peuvent choisir parmi ces sources approuvées si nécessaire.

Pour en savoir plus sur les serveurs MCP dans Databricks et comment créer les vôtres, consultez MCP et outils d’agents.

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 courantes d’entreprise :

• Google Drive : Recherchez et créez Google Docs, Sheets et Slides ; modifier les documents qu’il a créés.
• Gmail : recherchez, lisez et redécrivez les e-mails.
• Google Agenda : Recherchez et créez des événements dans le calendrier.
• Microsoft 365 : Recherchez SharePoint, Teams, Outlook et Calendrier ; rédigez un e-mail Outlook.
• Atlassian : Recherchez et mettez à jour Jira et Confluence.
• Glean (Bêta) : Recherchez dans les applications connectées de votre organisation à l’aide de Glean.
• Slack : Recherchez les messages et canaux Slack, et envoyez des messages.
• GitHub : Rechercher et mettre à jour les dépôts, les issues et les pull requests.

La connexion à ces sources de données permet à Genie Code de rechercher dans vos documents et d’effectuer des actions dans des outils connectés lorsqu’il répond à des 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, donc il n’y a pas de serveur à héberger ni d’application OAuth à enregistrer. Azure Databricks régit chaque connexion via Unity Catalog et Unity Gateway. La passerelle autorise chaque appel d’outil en fonction de vos autorisations dans Unity Catalog, applique les stratégies intégrées ainsi que les exigences d’approbation, et consigne les journaux d’utilisation et d’audit dans les tables système. Voir Enregistrer un serveur MCP externe.

Pour connecter une source de données tierce :

1. Dans votre espace de travail, cliquez sur Génie Code dans le coin supérieur droit pour ouvrir une conversation.
2. Dans la barre d’invite, cliquez sur Icône plus.
3. À côté de la source de données à laquelle vous souhaitez vous connecter, cliquez sur Connecter.
4. Effectuez les étapes de connexion.

Après vous être authentifié, Genie Code peut rechercher vos documents lors de la réponse aux questions. Les administrateurs de metastore et les propriétaires de connexions peuvent gérer ou révoquer des autorisations utilisateur sur la connexion. Voir l’étape 4. Accorder l’accès à un service MCP.

Note

Les outils de source de données ne se déclenchent pas toujours automatiquement. Si la recherche de documents ne démarre pas, essayez explicitement d'inviter Génie 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 quand l’authentification d’une connexion expire. Vous ne le découvrirez peut-être que lorsqu’un appel d’outil échoue ou lorsque vous ouvrez la liste des connexions. Authentifiez-vous à nouveau pour résoudre.
• Modifier les permissions d’une connexion nécessite que chaque utilisateur se réauthentifie. Les tâches planifiées qui utilisent la connexion échouent tant que l’utilisateur ne se réauthentifie pas.

Limitations de Google Drive

• Lorsque vous autorisez Google Drive, vous pouvez voir un écran « application non vérifiée ». Cliquez sur Avancé et poursuivez le processus d’autorisation.
• La taille maximale du fichier est de 25 Mo.
• Seuls les fichiers Google Workspace natifs (Docs, Sheets, Slides) sont pris en charge. Les fichiers PDF, les images et d’autres formats binaires ne sont pas pris en charge.
• Genie Code peut créer des Google Docs, des feuilles et des diapositives, et modifier les Google Docs qu’il a créés via le connecteur. Il ne peut pas modifier la documentation créée en dehors du connecteur, ni modifier les feuilles ou diapositives existantes.
• Lire un document très volumineux peut être lent.

Note

L’utilisation et le transfert de données utilisateur brutes ou dérivées reçues des API Google Workspace respecteront la stratégie de données utilisateur des services d’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 pièces jointes natives de Gmail. Comme solution de contournement, incluez des liens vers les fichiers dans le corps de l’email.

Limitations de Microsoft 365

• Inclut SharePoint, Teams, Outlook et Calendrier.
• Genie Code peut rédiger un e-mail Outlook mais ne peut pas l'envoyer.
• La taille maximale des fichiers SharePoint est de 25 Mo.
• Les types de fichiers SharePoint 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 fichiers PDF, les images et d’autres formats binaires ne sont pas pris en charge.

Limitations de Glean (Beta)

• Glean est uniquement un moteur de recherche. Il ne peut pas lire un document depuis un lien direct.
• Un administrateur de metastore doit d’abord configurer l’ID de locataire Glean avant que les utilisateurs non administrateurs puissent utiliser la connexion. L’administrateur peut entrer l’ID de locataire lors de la première connexion à Glean.
• Pour se connecter à un serveur MCP Glean spécifique, un administrateur de metastore peut optionnellement définir le chemin du serveur MCP (par exemple, /mcp/eng) lors de la mise en place de la connexion. Laissez ce champ vide pour utiliser le chemin par défaut (/mcp/default). Les utilisateurs non administrateurs ne peuvent pas spécifier ni modifier le chemin du serveur MCP de Glean.

Limitations de Slack

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

limitations de GitHub

• L’écriture est limitée au contenu des fichiers, aux tickets et aux pull requests.
• Par défaut, le connecteur Databricks GitHub MCP ne peut accéder qu’aux référentiels publics. Pour permettre au connecteur d’accéder en lecture à vos référentiels d’entreprise privés, un administrateur de l’organisation GitHub doit effectuer une configuration supplémentaire. Consultez Activer l’accès au référentiel privé.
• GitHub Enterprise Server (la version auto-hébergée de GitHub) n’est pas prise en charge.

Ajouter manuellement des serveurs MCP à Genie Code

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

1. Ouvrez les paramètres de Génie Code. Dans le volet Génie 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 catalogue Unity : 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 sur la création d’un serveur MCP GitHub personnalisé, consultez Search GitHub code avec Genie Code.
   • Recherche IA : sélectionnez le schéma de l’index. Cela permet à Genie Code d’interroger l’index de recherche IA pour rechercher des documents pertinents.
   • Agent Genie : sélectionnez l’agent Genie. Genie MCP invoque Genie comme outil, ce qui vous permet d’interroger l’agent Genie pour analyser des données en langage naturel.
   • Serveur MCP externe : sélectionnez la connexion de catalogue Unity à utiliser en tant que serveur MCP externe. Vous devez d’abord 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 n’importe quel outil défini sur mesure. Les conditions suivantes s’appliquent :
     • Votre application doit être déployée dans le même espace de travail que celui à partir duquel vous essayez de vous y 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 espace de travail à 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 qu’ils ont été ajoutés, les serveurs MCP sont immédiatement disponibles pour Genie Code. Vous pouvez commencer à les utiliser sans modifier vos prompts ou vos instructions. Génie Code s’appuie automatiquement sur ces serveurs en cas de pertinence.

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

Limitations

• Les serveurs MCP externes sont disponibles uniquement dans les régions où Model Serving est pris en charge. Consultez Disponibilité des fonctionnalités de service de modèles.