Pesquisar código no GitHub com o Genie Code

O Genie Code pode pesquisar repositórios do GitHub quando você o conecta por meio do conector nativo do GitHub do Databricks ou por meio de um servidor MCP personalizado do GitHub. Use o conector nativo para a maioria dos casos. O acesso a repositórios privados requer que um administrador da organização no GitHub instale o aplicativo conector do GitHub da Databricks.

Usar o conector nativo (recomendado)

Para conectar o Genie ou o Genie Code a GitHub, use o conector nativo de terceiros do Databricks. Consulte Usar conectores nativos para fontes de dados de terceiros e Adicionar uma fonte de dados a uma conversa. Para repositórios privados, os administradores precisam habilitar o acesso.

• O conector nativo usa a conexão padrão do sistema Databricks. Para usar um servidor MCP personalizado do GitHub em vez disso, adicione-o manualmente. Consulte Adicionar servidores MCP ao Genie Code manualmente.
• Para melhorar as respostas, adicione contexto pessoal para cada repositório para ajudar GitHub ferramentas de pesquisa a entender sua base de código.

Habilitar o acesso ao repositório privado

A conexão do sistema databricks padrão para GitHub pode acessar somente repositórios públicos. Para conceder à conexão acesso de leitura a repositórios de empresas privadas, um administrador da organização GitHub deve concluir as seguintes etapas:

1. Instale o aplicativo conector do GitHub da Databricks na sua organização do GitHub para que tenha acesso de leitura aos seus repositórios privados.

2. Adicione os IPs de saída do Databricks Serverless à lista de permissões da nuvem e da região do seu workspace. Para ver a lista de endereços IP, consulte endereços IP e domínios para serviços e ativos do Azure Databricks. Para obter instruções sobre como configurar endereços IP permitidos para sua organização no GitHub, consulte Gerenciar endereços IP permitidos para sua organização.

Depois que a instalação do administrador for concluída, os usuários em sua organização poderão acessar repositórios privados usando a conexão do sistema databricks padrão.

Criar um servidor MCP GitHub personalizado (não recomendado)

Pule esta seção se o seu workspace do Databricks já tiver uma conexão do GitHub para o Unity Catalog disponível para você usar. Se você precisar apenas de acesso a repositórios públicos e informações de sua própria conta, pule para a etapa 3.

Siga as etapas abaixo para criar um servidor MCP GitHub personalizado. Isso permite que você configure o servidor para suas necessidades de segurança e dados específicos.

1. Na sua conta GitHub, crie um aplicativo GitHub. Para as bases de código corporativas, um administrador da organização GitHub deve concluir esta etapa.

   • Navegue até Profile > Settings > Developer settings > GitHub Apps e clique em New GitHub App.
   • Preencha os campos solicitados. A URL de retorno de chamada deve ser https://<your-databricks-workspace-url>/login/oauth/http.html. É assim que o GitHub se autentica no seu espaço de trabalho do Databricks.
     • A URL da home page não afeta o servidor MCP e pode ser definida como qualquer valor que você preferir
     • Desmarque a caixa "ativa" para tornar a URL do Webhook um campo opcional
   • Conceda ao aplicativo GitHub as permissões necessárias para acessar o repositório e a organização.
   • Clique em Criar Aplicativo do GitHub.

2. No aplicativo recém-criado, em Segredos do cliente, clique em Gerar um novo segredo do cliente. Copie esse valor.

3. Crie uma nova conexão do Unity Catalog para o GitHub. Você deve ter CREATE CONNECTION privilégios.

   • Se o workspace já tiver um instalado, você poderá usar o existente desde que tenha USE CONNECTION privilégios nele.
   • Preencha estes campos:
     • Tipo de conexão: HTTP
     • Tipo de autenticação: OAuth User to Machine
     • Provedor OAuth: Manual configuration
       • Se você precisar apenas de acesso a repositórios públicos e às informações de sua própria conta, selecione Github MCP aqui e ignore o restante das etapas.
     • Anfitrião: https://api.githubcopilot.com
     • Escopo OAuth: os escopos do seu aplicativo. Por exemplo, mcp:access read:user user:email repo read:org
     • Segredo do cliente e ID do cliente: gerado da Etapa 2
     • Ponto de extremidade de autorização: https://github.com/login/oauth/authorize
     • Ponto de extremidade de token: https://github.com/login/oauth/access_token
     • Caminho base: /mcp
     • É a conexão mcp: checked
   • Clique em Criar conexão.

4. No canto superior direito, clique em Logon para fazer logon na conexão. Isso abre uma nova janela solicitando que você autorize o aplicativo GitHub para sua conta do Databricks. Clique em conect na conta de GitHub à qual você deseja se conectar.

Seu MCP GitHub agora está pronto para uso. Adicione-o ao Genie Code como um servidor MCP externo.