Cerca il codice su GitHub con Genie Code

Genie Code può cercare nei repository GitHub quando lo colleghi tramite il connettore GitHub nativo di Databricks o un server MCP GitHub personalizzato. Usare il connettore nativo per la maggior parte dei casi. L'accesso al repository privato richiede che un amministratore dell'organizzazione GitHub installi l'app connettore Databricks GitHub.

Usare il connettore nativo (scelta consigliata)

Per connettere Genie o Genie Code a GitHub, usare il connettore nativo di Databricks di terze parti. Vedere Usare connettori nativi per origini dati di terze parti e Aggiungere un'origine dati a una conversazione. Per i repository privati, gli amministratori devono abilitare l'accesso.

• Il connettore nativo usa la connessione di sistema predefinita di Databricks. Per utilizzare un server MCP di GitHub personalizzato invece, aggiungilo manualmente. Vedere Aggiungere manualmente server MCP a Genie Code.
• Per migliorare le risposte, aggiungi informazioni contestuali personali per ogni repository, per aiutare gli strumenti di ricerca di GitHub a comprendere la tua base di codice.

Abilitare l'accesso al repository privato

La connessione di sistema predefinita di Databricks per GitHub può accedere solo ai repository pubblici. Per concedere alla connessione l'accesso in lettura ai repository aziendali privati, un amministratore dell'organizzazione GitHub deve completare i passaggi seguenti:

1. Installa l'app connettore GitHub di Databricks nella tua organizzazione GitHub in modo che abbia accesso in lettura ai tuoi repository privati.

2. Aggiungi gli indirizzi IP serverless in uscita di Databricks all'elenco consentito per il cloud e la regione dell'area di lavoro. Per l'elenco degli indirizzi IP, vedere Indirizzi IP e domini per i servizi e gli asset di Azure Databricks. Per istruzioni sulla configurazione degli indirizzi IP consentiti per l'organizzazione GitHub, vedere Gestione degli indirizzi IP consentiti per l'organizzazione.

Al termine dell'installazione dell'amministratore, gli utenti dell'organizzazione possono accedere ai repository privati usando la connessione di sistema predefinita di Databricks.

Creare un server MCP GitHub personalizzato (non consigliato)

Ignorare questa sezione se l'area di lavoro di Databricks dispone già di una connessione a Unity Catalog GitHub disponibile per l'uso. Se è sufficiente accedere ai repository pubblici e alle informazioni del proprio account, andare al passaggio 3.

Seguire questa procedura per creare un server MCP personalizzato GitHub. In questo modo è possibile configurare il server in base alle esigenze specifiche di dati e sicurezza.

1. Dall'account GitHub creare un'app GitHub. Per le codebase aziendali, un amministratore dell'organizzazione GitHub deve completare questo passaggio.

   • Passare a Profile > Settings > Developer settings > GitHub Apps e fare clic su New GitHub App.
   • Compilare i campi richiesti. L'URL di callback deve essere https://<your-databricks-workspace-url>/login/oauth/http.html. Questo è il modo in cui GitHub esegue l'autenticazione con l'area di lavoro di Databricks.
     • L'URL della home page non influisce sul server MCP e può essere impostato su qualsiasi valore preferito
     • Deselezionare la casella "attivo" per impostare l'URL del webhook come campo facoltativo
   • Concedere all'app GitHub le autorizzazioni necessarie per accedere al repository e all'organizzazione.
   • Fare clic su Crea app GitHub.

2. Nell'app appena creata, in Segreti client, fare clic su Genera un nuovo segreto client. Copiare questo valore.

3. Creare una nuova connessione al catalogo Unity per GitHub. È necessario disporre dei privilegi CREATE CONNECTION.

   • Se l'area di lavoro ne ha già una installata, è possibile utilizzare quella esistente purché si dispongano dei privilegi appropriati.
   • Compilare questi campi:
     • Tipo di connessione: HTTP
     • Tipo di autenticazione: OAuth User to Machine
     • Provider OAuth: Manual configuration
       • Se è sufficiente accedere ai repository pubblici e alle informazioni del proprio account, selezionare qui e ignorare Github MCP il resto dei passaggi.
     • Host: https://api.githubcopilot.com
     • Ambito OAuth: ambiti di accesso dell'app. Ad esempio, mcp:access read:user user:email repo read:org
     • Segreto client e ID client: generato dal passaggio 2
     • Endpoint di autorizzazione: https://github.com/login/oauth/authorize
     • Endpoint del token: https://github.com/login/oauth/access_token
     • Percorso di base: /mcp
     • Connessione MCP: checked
   • Fai clic su Crea connessione.

4. Nell'angolo in alto a destra fare clic su Accedi per accedere alla connessione. Verrà visualizzata una nuova finestra che richiede di autorizzare l'app GitHub all'account Databricks. Fare clic su connect nell'account GitHub a cui connettersi.

La GitHub MCP è ora pronta per l'uso. Aggiungerlo a Genie Code come server MCP esterno.