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 exige que um administrador da organização no GitHub instale o aplicativo do conector do Databricks para GitHub.

Usar o conector nativo (recomendado)

Para conectar o Genie One ou o Genie Code a GitHub, use o conector de terceiros do Databricks. Veja : Use conectores nativos para fontes de dados de terceiros e conecte o Genie One a ferramentas e fontes externas. 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.

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

Pule esta seção se seu espaço de trabalho no Azure Databricks já tiver um serviço MCP do GitHub Unity Catalog disponível para você usar. Se você só precisa de acesso a repositórios públicos e às informações da sua própria conta, use OAuth gerenciado e pule para Registrar uma conexão do Unity Catalog como um Serviço MCP.

Siga os passos abaixo para registrar um servidor MCP personalizado no GitHub como um Serviço MCP para suas necessidades específicas de dados e segurança. Primeiro, escolha como seu Serviço MCP se autentica:

• OAuth gerenciado: O Databricks gerencia o aplicativo OAuth do GitHub e suas credenciais. Pule o aplicativo GitHub e as etapas de segredo do cliente abaixo, depois escolha o provedor gerenciado ao criar a conexão.
• OAuth Personalizado: Crie seu próprio aplicativo no GitHub e forneça suas credenciais ao criar a conexão.

Crie um aplicativo no GitHub (apenas OAuth personalizado)

1. Crie um app do GitHub. Para as bases de código corporativas, um administrador da organização GitHub deve concluir esta etapa.

   • Acesse Perfil > Configurações > Configurações do desenvolvedor > Apps do GitHub e clique em Novo app do GitHub.
   • 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 de seleção 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.

Registre uma conexão do Unity Catalog como um Serviço MCP

1. Crie ou reutilize uma conexão HTTP do Unity Catalog para o GitHub. Você precisa ter privilégios no CREATE CONNECTION esquema para criar um. Se você reutilizar uma conexão existente, ela deve estar com USE CONNECTION habilitado. Continue a registrar essa conexão como um Serviço MCP na próxima etapa. Para uma nova conexão, use uma das seguintes opções de autenticação:

   • OAuth Gerenciado: Selecione o tipo de autenticação OAuth User to Machine Per User e o provedor OAuth do GitHub. O Databricks fornece o host do GitHub, o caminho da base e as credenciais OAuth.
   • OAuth Personalizado: Selecione o tipo de autenticação OAuth User to Machine Per User e o provedor OAuth Manual configuration. Insira os seguintes valores:
     • Anfitrião: https://api.githubcopilot.com
     • Escopo do OAuth: os escopos do seu aplicativo. Por exemplo, mcp:access read:user user:email repo read:org
     • Segredo do cliente e ID do cliente: gerados nas etapas do aplicativo do GitHub acima
     • Ponto de extremidade de autorização: https://github.com/login/oauth/authorize
     • Ponto de extremidade do token: https://github.com/login/oauth/access_token
     • Caminho base: /mcp
   • Clique em Criar conexão.

2. Registre um Serviço MCP que use a conexão HTTP. Para as permissões necessárias, veja Servidores MCP externos.

   • No seu espaço de trabalho do Azure Databricks, vá em Catálogo, selecione um esquema e clique em Criar>Serviço MCP.
   • Insira o catálogo, o esquema e o nome do Serviço MCP.
   • Selecione a conexão HTTP que você criou ou reutilizou, selecione as ferramentas a expor e clique em Criar.

3. Se você escolheu OAuth por usuário, abra o Serviço MCP no Explorador de Catálogos e clique em Login para autorizar sua conta no GitHub.

4. Conceda a usuários ou grupos EXECUTE no Serviço MCP, além de USE CATALOG e USE SCHEMA em seu catálogo e esquema pai. Não conceda aos usuários finais USE CONNECTION. Veja Compartilhe um MCP.

Seu serviço GitHub MCP está pronto para uso. Adicione isso ao Genie Code.