Pular para o conteúdo principal
Última atualização em

Conector do GitHub para busca de código

Amplie as capacidades de busca de código do Genie e do Genie Code conectando-se ao GitHub com o conector nativo ou um servidor MCP personalizado.

nota

Os servidores MCP são suportados apenas no modo Genie Code Agent.

Utilize o conector nativo (recomendado)​

info

Visualização

Este recurso está em versão Beta. Para usar conectores de fontes de dados de terceiros, um administrador workspace deve ativar a pré-visualização de Conectores de Terceiros para Agentes . Veja as prévias do Gerenciador Databricks.

Para conectar o Genie ou o Genie Code ao 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.

Habilitar acesso ao repositório privado​

A conexão default do sistema Databricks para GitHub só pode acessar repositórios públicos. Para conceder acesso de leitura à conexão aos repositórios privados da empresa, um administrador da organização GitHub deve concluir os seguintes passos:

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

    Para o AWS GovCloud, use o aplicativo databricks-gh-connector-gov-cloud .

  2. Adicione à lista de permissões os IPs de saída serverless Databricks para cloud e região do seu workspace. Para obter a lista de endereços IP, consulte Endereços IP e domínios para Databricks serviço e ativo. Para obter instruções sobre como configurar os endereços IP permitidos para sua organização do GitHub, consulte Gerenciando endereços IP permitidos para sua organização.

Após a configuração administrativa ser concluída, os usuários da sua organização poderão acessar repositórios privados usando a conexão default do sistema Databricks .

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

Ignore esta seção se o seu workspace Databricks já tiver uma conexão com o Catálogo GitHub Unity Catalog disponível para uso. Se você precisar apenas de acesso a repositórios públicos e às informações da sua própria account, pule para o passo 3.

Siga os passos abaixo para criar um servidor GitHub MCP personalizado. Isso permite configurar o servidor de acordo com suas necessidades específicas de dados e segurança.

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

    • Acesse Perfil > Configurações > Configurações do desenvolvedor > Aplicativos do GitHub e clique em Novo aplicativo 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 GitHub se autentica com seu workspace Databricks .

      • O URL da página inicial não afeta o servidor MCP e pode ser definido com qualquer valor de sua preferência.
      • Desmarque a caixa "ativo" para tornar o URL do Webhook um campo opcional.

    • Conceda ao seu aplicativo GitHub as permissões necessárias para acessar seu repositório e sua 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 este valor.

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

    • Se o seu workspace já tiver um instalado, você pode usar o existente, desde que tenha privilégios USE CONNECTION 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 da sua própria account, selecione Github MCP aqui e ignore o resto dos passos.

      • Hospedar: 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: gerados a partir do passo 2

      • endpoint de autorização: https://github.com/login/oauth/authorize

      • endpoint de tokens: https://github.com/login/oauth/access_token

      • Caminho base: /mcp

      • É uma conexão MCP: checked

    • Clique em Criar conexão .

  4. No canto superior direito, clique em Entrar para acessar sua conexão. Isso abrirá uma nova janela solicitando que você autorize o aplicativo GitHub à sua account Databricks . Clique em "Conectar" na account GitHub à qual deseja se conectar.

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

Nesta página