Pesquise código do GitHub com código Genie

O Genie Code pode pesquisar em repositórios do GitHub quando o liga através do conector nativo da Databricks para o GitHub ou de um servidor MCP do GitHub personalizado. Usa o conector nativo na maioria dos casos. O acesso a repositórios privados requer que um administrador da organização GitHub instale a aplicação conector Databricks GitHub.

Use o conector nativo (recomendado)

Para ligar o Genie One ou o Genie Code ao GitHub, use o conector de terceiros Databricks. Veja Utilizar conectores nativos para fontes de dados de terceiros e Ligar a ferramentas e fontes externas. Para repositórios privados, os administradores precisam de ativar o acesso.

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

Permitir o acesso a repositórios privados

A ligação padrão do sistema Databricks para o GitHub só pode aceder a repositórios públicos. Para conceder à conexão acesso de leitura a repositórios empresariais privados, um administrador de uma organização do GitHub deve concluir os passos seguintes:

1. Instala a aplicação GitHub conector Databricks na tua organização GitHub para que tenha acesso de leitura aos teus repositórios privados.

2. Permita listar os IPs de saída serverless do Databricks para a cloud e região do seu espaço de trabalho. Para a lista de endereços IP, veja endereços e domínios para serviços e ativos Azure Databricks. Para instruções sobre como configurar endereços IP permitidos para a sua organização GitHub, consulte Gestão de endereços IP permitidos para a sua organização.

Após a conclusão da configuração de administrador, os utilizadores da sua organização podem aceder a repositórios privados usando a ligação padrão do sistema Databricks.

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

Salta esta secção se o teu espaço de trabalho Databricks já tiver uma ligação ao Catálogo Unity do GitHub disponível para usares. Se só precisas de acesso a repositórios públicos e à informação da tua própria conta, salta para o passo 3.

Siga os passos abaixo para criar um servidor GitHub MCP personalizado. Isto permite-lhe configurar o servidor para as suas necessidades específicas de dados e segurança.

1. A partir da sua conta no GitHub, crie uma aplicação no GitHub. Para bases de código empresariais, um administrador de organização GitHub deve completar este passo.

   • Navegue até Perfil > Definições > Definições de programador > GitHub Apps e clique em Aplicação Nova GitHub.
   • Preencha os campos pedidos. O URL de Callback deve ser https://<your-databricks-workspace-url>/login/oauth/http.html. É assim que o GitHub autentica com o seu espaço de trabalho Databricks.
     • A URL da página inicial não afeta o servidor MCP e pode ser definida para qualquer valor que prefira
     • Desmarque a caixa "ativo" para tornar o Webhook URL um campo opcional
   • Conceda à sua aplicação GitHub as permissões necessárias para aceder ao seu repositório e organização.
   • Clica em Criar Aplicação no GitHub.

2. Na aplicação recém-criada, em Segredos do cliente, clique em Gerar um novo segredo do cliente. Copiar este valor.

3. Crie uma nova ligação ao Catálogo Unity para o GitHub. Deve ter CREATE CONNECTION privilégios.

   • Se o teu espaço de trabalho já tiver um instalado, podes usar o existente desde que tenhas USE CONNECTION privilégios nele.
   • Preencha estes campos:
     • Tipo de ligação: HTTP
     • Tipo de autenticação: OAuth User to Machine
     • Fornecedor OAuth: Manual configuration
       • Se só precisar de acesso a repositórios públicos e à informação da sua própria conta, selecione Github MCP aqui e pule os restantes passos.
     • Anfitrião: https://api.githubcopilot.com
     • Escopo OAuth: Os escopos da sua aplicação. Por exemplo, mcp:access read:user user:email repo read:org
     • Segredo do cliente e ID do cliente: gerados a partir do Step 2
     • Ponto final de autorização: https://github.com/login/oauth/authorize
     • Endpoint do token: https://github.com/login/oauth/access_token
     • Caminho base: /mcp
     • É a ligação MCP: checked
   • Clique em Criar conexão.

4. No canto superior direito, clique em Iniciar sessão para iniciar sessão na sua ligação. Isto abre uma nova janela que o convida a autorizar a aplicação GitHub para a sua conta Databricks. Clique em conectar na conta GitHub à qual pretende ligar-se.

O seu MCP no GitHub já está pronto para usar. Adiciona-o ao Genie Code como um servidor MCP externo.