Buscar GitHub código con Genie Code

Genie Code puede buscar repositorios de GitHub al conectarlo a través del conector nativo de Databricks para GitHub o de un servidor MCP de GitHub personalizado. Use el conector nativo para la mayoría de los casos. El acceso a repositorios privados requiere que un administrador de la organización de GitHub instale la aplicación del conector de GitHub de Databricks.

Uso del conector nativo (recomendado)

Para conectar Genie o Genie Code a GitHub, use el conector nativo de terceros de Databricks. Consulte Uso de conectores nativos para orígenes de datos de terceros y Adición de un origen de datos a una conversación. En el caso de los repositorios privados, los administradores deben habilitar el acceso.

• El conector nativo usa la conexión predeterminada del sistema de Databricks. Para usar un servidor MCP de GitHub personalizado en su lugar, agréguelo manualmente. Consulte Incorporación manual de servidores MCP a Genie Code.
• Para mejorar las respuestas, agregue contexto personal para cada repositorio para ayudar a GitHub herramientas de búsqueda a comprender el código base.

Habilitación del acceso al repositorio privado

La conexión predeterminada del sistema de Databricks para GitHub solo puede acceder a repositorios públicos. Para conceder a la conexión acceso de solo lectura a los repositorios privados de la empresa, un administrador de una organización de GitHub debe seguir estos pasos:

1. Instale la aplicación de conector de GitHub de Databricks en su organización de GitHub para que tenga acceso de lectura a sus repositorios privados.

2. Permite incluir en la lista las direcciones IP salientes sin servidor de Databricks para la nube y la región del área de trabajo. Para obtener la lista de direcciones IP, vea IP addresses and domains for Azure Databricks services and assets. Para obtener instrucciones sobre cómo configurar las direcciones IP permitidas para su organización de GitHub, consulte Administrar direcciones IP permitidas para su organización.

Una vez completada la configuración del administrador, los usuarios de su organización pueden acceder a repositorios privados mediante la conexión predeterminada del sistema de Databricks.

Crear un servidor MCP personalizado de GitHub (no recomendado)

Omita esta sección si el área de trabajo de Databricks ya tiene una conexión de catálogo de Unity GitHub disponible para su uso. Si solo necesita acceso a repositorios públicos y a la información de su propia cuenta, vaya al paso 3.

Siga los pasos siguientes para crear un servidor MCP de GitHub personalizado. Esto le permite configurar el servidor a sus necesidades de seguridad y datos específicos.

1. En la cuenta de GitHub, cree una aplicación de GitHub. Para las bases de código empresariales, un administrador de una organización de GitHub debe completar este paso.

   • Vaya a Profile > Settings > Developer settings > GitHub Apps y haga clic en New GitHub App.
   • Rellene los campos solicitados. La dirección URL de devolución de llamada debe ser https://<your-databricks-workspace-url>/login/oauth/http.html. Así es como GitHub autentica con el área de trabajo de Databricks.
     • La dirección URL de la página principal no afecta al servidor MCP y puede establecerse en cualquier valor que prefiera.
     • Desactive el cuadro "activo" para convertir la dirección URL del webhook en un campo opcional.
   • Conceda a la aplicación GitHub los permisos necesarios para acceder al repositorio y la organización.
   • Haga clic en Crear aplicación de GitHub.

2. En la aplicación recién creada, en Secretos de cliente, haga clic en Generar un nuevo secreto de cliente. Copie este valor.

3. Cree una conexión de Unity Catalog para GitHub. Debe tener CREATE CONNECTION privilegios.

   • Si el área de trabajo ya tiene una instalada, puede usar la existente siempre que tenga USE CONNECTION privilegios en ella.
   • Rellene estos campos:
     • Tipo de conexión: HTTP
     • Tipo de autenticación: OAuth User to Machine
     • Proveedor de OAuth: Manual configuration
       • Si solo necesita acceso a repositorios públicos y a la información de su propia cuenta, seleccione Github MCP aquí y omita el resto de los pasos.
     • Anfitrión: https://api.githubcopilot.com
     • Ámbito de OAuth: los ámbitos de la aplicación. Por ejemplo: mcp:access read:user user:email repo read:org
     • Secreto de cliente e identificador de cliente: generado a partir del paso 2
     • Punto de conexión de autorización: https://github.com/login/oauth/authorize
     • Punto de conexión del token: https://github.com/login/oauth/access_token
     • Ruta de acceso base: /mcp
     • Es la conexión mcp: checked
   • Haga clic en Crear conexión.

4. En la esquina superior derecha, haga clic en Iniciar sesión para iniciar sesión en la conexión. Se abrirá una nueva ventana en la que se le pedirá que autorice la aplicación de GitHub a su cuenta de Databricks. Haga clic en connect en la cuenta de GitHub a la que desea conectarse.

Su GitHub MCP ya está listo para usarse. Agréguelo a Genie Code como servidor MCP externo.