Aller au contenu principal

Rechercher du code GitHub avec Genie Code

Genie Code peut rechercher des repository GitHub lorsque vous le connectez via le connecteur Databricks GitHub natif ou un serveur GitHub MCP personnalisé. Utilisez le connecteur natif dans la plupart des cas. L'accès aux repository privés nécessite qu'un administrateur de l'organisation GitHub installe l'application de connecteur Databricks GitHub.

Utiliser le connecteur natif (recommandé)​

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.

Pour connecter Genie One ou Genie Code à GitHub, utilisez le connecteur tiers Databricks. Consultez Utiliser les connecteurs natifs pour les sources de données tierces et Se connecter aux outils et sources externes. Pour les private repository, les administrateurs doivent activer l'accès.

Enregistrer un serveur GitHub MCP personnalisé (déconseillé)​

Ignorez cette section si votre Workspace Databricks dispose déjà d'un service MCP Unity Catalog GitHub que vous pouvez utiliser. Si vous avez uniquement besoin d'accéder à des repositories publics et aux informations de votre propre compte, utilisez l'authentification OAuth gérée et passez directement à Enregistrer une connexion Unity Catalog en tant que service MCP.

Suivez les étapes ci-dessous pour enregistrer un serveur GitHub MCP personnalisé en tant que service MCP pour vos besoins spécifiques en matière de données et de sécurité. Tout d’abord, choisissez le mode d’authentification de votre service MCP :

  • OAuth géré : Databricks gère l’application et les identifiants OAuth GitHub. Ignorez les étapes relatives à l’application GitHub et au secret du client ci-dessous, puis choisissez le fournisseur géré lorsque vous créez la connexion.
  • OAuth personnalisé : créez votre propre application GitHub et fournissez ses identifiants lorsque vous créez la connexion.

Créer une application GitHub (OAuth personnalisé uniquement)​

  1. Créez une application GitHub. Pour les bases de code d’entreprise, un administrateur de l’organisation GitHub doit effectuer cette étape.

    • Accédez à **Profil > Paramètres > Paramètres du développeur > Applications GitHub** et cliquez sur **Nouvelle application GitHub**.

    • Remplissez les champs demandés. L' URL de rappel doit être https://<your-databricks-workspace-url>/login/oauth/http.html. Voici comment GitHub s'authentifie auprès de votre Workspace Databricks.

      • L'URL de la page d'accueil n'affecte pas le serveur MCP et peut être définie à la valeur que vous préférez.
      • Décochez la case à cocher Active pour rendre l'URL du webhook un champ facultatif.
    • Accordez à votre application GitHub les autorisations nécessaires pour accéder à votre repository et à votre organisation.

    • Cliquez sur Create GitHub App .

  2. Dans l'application nouvellement créée, sous Secrets du client , cliquez sur Générer un nouveau secret du client . Copiez cette valeur.

Enregistrer une connexion Unity Catalog en tant que service MCP​

  1. Créez ou réutilisez une connexion HTTP Unity Catalog pour GitHub. Vous devez disposer des privilèges CREATE CONNECTION sur le schéma pour en créer un. Si vous réutilisez une connexion existante, vous devez y disposer de USE CONNECTION. Continuez à enregistrer cette connexion en tant que service MCP lors de la prochaine étape. Pour une nouvelle connexion, utilisez l’une des options d’authentification suivantes :

    • OAuth managé : sélectionnez le type d'authentification OAuth User to Machine Per User et le fournisseur d'identité GitHub . Databricks fournit l'hôte GitHub, le chemin de base et les identifiants OAuth.

    • Custom OAuth : sélectionnez le type d'authentification OAuth User to Machine Per User et le fournisseur OAuth Manual configuration . Veuillez saisir les valeurs suivantes :

      • Hôte : https://api.githubcopilot.com
      • Champ d'application OAuth : les champs d'application de votre application. Par exemple, mcp:access read:user user:email repo read:org
      • Secret du client et ID client : générés lors des étapes de l’application GitHub ci-dessus
      • Endpoint d'autorisation : https://github.com/login/oauth/authorize
      • Endpoint de jeton : https://github.com/login/oauth/access_token
      • Chemin de base : /mcp
    • Cliquez sur Créer une connexion .

  2. Enregistrez un service MCP qui utilise la connexion HTTP. Pour connaître les autorisations requises, consultez Enregistrer un serveur MCP externe.

    • Dans votre workspace Databricks, accédez à Catalog , sélectionnez un schéma, puis cliquez sur Create > MCP Service .
    • Saisissez le catalogue, le schéma et le nom du service MCP.
    • Sélectionnez la connexion HTTP que vous avez créée ou réutilisée, sélectionnez les outils à exposer, puis cliquez sur Create .
  3. Si vous avez choisi l’authentification OAuth par utilisateur, ouvrez le service MCP dans l’Explorateur de catalogues et cliquez sur Login pour autoriser votre compte GitHub.

  4. Accordez aux utilisateurs ou aux groupes EXECUTE sur le service MCP, ainsi que USE CATALOG et USE SCHEMA sur son catalogue et son schéma parents. N'accordez pas aux utilisateurs finaux USE CONNECTION. Consultez Étape 4. Accorder l'accès à un service MCP.

Votre service MCP GitHub est prêt à être utilisé. Ajoutez-le à Genie Code.