Conecte o Genie Code aos servidores MCP

O Genie Code se conecta a ferramentas, documentos e dados externos por meio de servidores do Protocolo de Contexto de Modelo (MCP) e conectores nativos para o Google Drive, Gmail, Google Calendar, Microsoft 365, Atlassian, Glean, Slack e GitHub. Use os conectores nativos para fontes de SaaS comuns ou adicione seus próprios servidores MCP externos ou personalizados do workspace. Você escolhe quais ferramentas habilitar nas configurações do Genie Code.

O que é MCP?

MCP é um padrão de código aberto que conecta agentes a ferramentas, recursos, prompts e outras informações contextuais. O MCP oferece uma forma padronizada de expor ferramentas, dados e fluxos de trabalho ao Genie Code sem incorporar esse contexto diretamente em prompts ou instruções.

O MCP foi projetado para casos em que um contexto importante já existe, mas é difícil de acessar por um agente, como o Genie Code. O MCP oferece uma maneira segura de dar acesso ao Genie Code a contextos como os seguintes:

• Sistemas de documentação : As equipes geralmente mantêm manuais operacionais ou documentos operacionais em ferramentas como o Confluence. Em vez de copiar seções em prompts, esse conteúdo pode ser exposto uma vez por meio de um servidor MCP externo e referenciado quando relevante. Seus documentos também podem já estar no Databricks como um índice de Pesquisa de IA, que o Genie Code pode usar para consultar documentos relevantes.
• Ferramentas e serviços : Equipes de plataforma podem manter APIs ou scripts para configuração, validação ou implantação. O MCP disponibiliza essas capacidades diretamente ao Genie Code.
• Fontes de dados: Se você já tiver dados no Databricks, é possível conectar o Genie Code a um Genie Agent para ajudar a analisar os dados usando linguagem natural. Para dados armazenados fora do Databricks, é possível conceder ao Genie Code acesso seguro através de servidores MCP externos.
• Aplicativos personalizados : Você também pode adicionar funcionalidades personalizadas hospedadas por meio do Databricks Apps. Isso permite conectar Genie Code a ferramentas proprietárias, fluxo de trabalho ou integrações criadas especificamente para você ou sua organização, tudo gerenciado com segurança dentro do seu workspace Databricks .

Nesses casos, o MCP substitui a cópia e colagem manual por uma abordagem estruturada e reutilizável, disponibilizando o contexto correto somente quando necessário.

Você pode conectar o Genie Code a quaisquer servidores MCP em seu Workspace aos quais você tenha permissão para usar. Os administradores do Workspace controlam quais servidores estão disponíveis, enquanto os usuários podem selecionar entre as fontes aprovadas conforme necessário.

Para saber mais sobre servidores MCP no Databricks e como criar o seu próprio, consulte MCPs e ferramentas de agente.

Use conectores nativos para fontes de dados de terceiros

O Genie Code oferece conectores integrados para fontes de dados corporativas comuns:

• Google Drive : Pesquise e crie Google Docs, Planilhas e Apresentações; edite os Docs criados.
• Gmail : pesquise, leia e rascunhe email.
• Google Calendar : pesquise e crie eventos de calendário.
• Microsoft 365 : pesquise no SharePoint, Teams, Outlook e no Calendário; redija um email no Outlook.
• Atlassian : pesquise e atualize o Jira e o Confluence.
• Glean (Beta): pesquise em todos os aplicativos conectados da sua organização usando o Glean.
• Slack : Pesquise mensagens e canais do Slack e envie mensagens.
• GitHub : pesquise e atualize repository, problemas e pull requests.

A conexão a estas fontes de dados permite que o Genie Code pesquise em seus documentos e realize ações nas ferramentas conectadas ao responder a perguntas. Cada usuário se autentica individualmente, e os tokens OAuth não são compartilhados entre os usuários.

Estas conexões usam conectores MCP fornecidos pelo Databricks, portanto, não há servidor para hospedar nem aplicativo OAuth para registrar. O Databricks rege todas as conexões por meio do Unity Catalog e do Unity Gateway. O gateway autoriza cada chamada de ferramenta em relação às suas permissões do Unity Catalog, aplica políticas integradas e requisitos de aprovação, além de registrar o uso e os logs de auditoria em tabelas do sistema. Consulte Registrar um servidor MCP externo.

Para conectar uma fonte de dados de terceiros:

1. Na sua workspace, clique em Genie Code no canto superior direito para abrir um bate-papo.
2. Na barra de prompts, clique o ícone de mais.
3. Ao lado da fonte de dados à qual deseja se conectar, clique em Conectar .
4. Conclua os passos para iniciar sessão.

Após a autenticação, o Genie Code pode pesquisar seus documentos ao responder a perguntas. Os administradores do metastore e os proprietários da conexão podem gerenciar ou revogar permissões de usuário na conexão. Consulte o passo 4. Conceder acesso a um serviço MCP.

nota

As ferramentas de fonte de dados nem sempre são acionadas automaticamente. Se a pesquisa de documentos não iniciar, tente instruir explicitamente Genie Code a usar a ferramenta, por exemplo, "usar o Google Docs" ou "usar o SharePoint".

Para conectar outras fontes de dados, adicione-as manualmente ao Genie Code. Consulte Adicionar servidores MCP ao Genie Code manualmente.

Tarefas programadas e autenticação

• O Genie Code não avisa quando a autenticação de uma conexão expira. Você só pode descobrir quando uma chamada de ferramenta falhar ou quando abrir a lista de conexões. Autentique-se novamente para resolver.
• Alterar as permissões de uma conexão exige que cada usuário se autentique novamente. As tarefas agendadas que usam a conexão falham até que o usuário se autentique novamente.

Limitações do Google Drive

• Ao autorizar o Google Drive, você poderá ver uma tela de "aplicativo não verificado". Clique em Avançado e continue o processo de autorização.
• O tamanho máximo do arquivo é de 25 MB.
• Somente arquivos nativos do Google Workspace (Documentos, Planilhas, Apresentações) são compatíveis. Arquivos PDF, imagens e outros formatos binários não são suportados.
• O Genie Code pode criar Google Docs, Sheets e Slides, e editar o Google Docs criado por ele por meio do conector. Ele não pode editar Docs criados fora do conector, nem editar Sheets ou Slides existentes.
• A leitura de um documento muito grande pode ser lenta.

nota

O uso e a transferência de dados de usuário brutos ou derivados recebidos das APIs do Google Workspace aderirão à Política de Dados de Usuário dos serviços de API do Google, incluindo os requisitos de Uso Limitado.

Limitações do Gmail

• O Genie Code pode pesquisar, ler e redigir email, mas não pode enviar email ou editar mensagens existentes.
• O Genie Code não pode adicionar arquivos do Drive como anexos nativos do Gmail. Como uma solução alternativa, inclua Link para os arquivos no corpo do email.

Limitações do Microsoft 365

• Inclui SharePoint, Teams, Outlook e Calendar.
• O Genie Code pode redigir um email do Outlook, mas não pode enviá-lo.
• O tamanho máximo do arquivo é de 25 MB para arquivos do SharePoint.
• Os tipos de arquivo do SharePoint compatíveis incluem documentos do Office (.docx, .xlsx, .pptx), assim como formatos comuns baseados em texto, como .txt, .csv, .json, .md e outros. PDFs, imagens e outros formatos binários não são compatíveis.

Limitações do Glean (Beta)

• Glean is search-only. It can't read a document from a direct link.
• Um administrador de metastore deve primeiro configurar o tenant ID do Glean antes que usuários não administradores possam usar a conexão. O administrador pode inserir o ID do tenant ao conectar-se ao Glean pela primeira vez.
• Para se conectar a um servidor MCP do Glean específico, um administrador de metastore pode, opcionalmente, definir o caminho do servidor MCP (por exemplo, /mcp/eng) ao configurar a conexão. Deixe este campo em branco para usar o caminho default (/mcp/default). Usuários não administradores não podem especificar ou alterar o caminho do servidor MCP do Glean.

Limitações do Slack

• O Genie Code não pode editar ou excluir uma mensagem depois de enviá-la.

Limitações do GitHub

• As gravações são limitadas a conteúdos de arquivos, problemas e solicitações pull.
• Por default, o conector Databricks GitHub MCP pode acessar apenas repository públicos. Para dar acesso de leitura ao conector aos seus repositories empresariais privados, um administrador da organização do GitHub deve concluir uma configuração adicional. Consulte Habilitar acesso a repository privado.
• O GitHub Enterprise Server (a versão auto-hospedada do GitHub) não é compatível.

Adicione servidores MCP ao Genie Code manualmente.

Para conectar o Genie Code a um servidor MCP, adicione-o nas configurações do Genie Code:

1. Abrir configurações do Genie Code. No painel Genie Code, clique em Configurações .

2. Em Servidores MCP , clique em Adicionar servidor .

3. Selecione os servidores MCP que deseja adicionar. Você pode selecionar servidores MCP gerenciados Databricks ou servidores MCP externos:

   • FunçãoUnity Catalog : Selecione o esquema para a função. Isso permite que Genie Code utilize funções para executar consultas SQL predefinidas.

     • Para obter ajuda na criação de um servidor MCP personalizado do GitHub, consulte Pesquisar código do GitHub com o Genie Code.

   • Pesquisa de IA : selecione o esquema para o índice. Isso permite que o Genie Code consulte o índice de Pesquisa de AI para encontrar documentos relevantes.

   • Genie Agent : Selecione o Genie Agent. O Genie MCP invoca o Genie como uma ferramenta, permitindo consultar o Genie Agent para analisar dados usando linguagem natural.

   • Servidor MCP externo : Selecione a conexão Unity Catalog a ser usada como servidor MCP externo. Você precisa log in na conexão antes de poder usá-la.

   • Servidor MCP personalizado : Selecione o aplicativo Databricks que deseja usar como servidor MCP personalizado. Isso permite que você utilize quaisquer ferramentas personalizadas. Os seguintes requisitos se aplicam:

     • Seu aplicativo deve ser implantado no mesmo workspace a partir do qual você está tentando se conectar a ele.
     • O servidor MCP deve ser acessado em https://<server-url>/mcp.
     • Seu aplicativo deve ser sem estado. Por exemplo, defina mcp_app = mcp_server.http_app(stateless_http=True).
     • Se você encontrar erros de CORS, talvez seja necessário adicionar o URL do seu Workspace à lista de origens permitidas do seu aplicativo. Por exemplo, defina app.add_middleware(CORSMiddleware, allow_origins=ALLOWED_ORIGINS, allow_credentials=True, allow_methods= ["*"], allow_headers= ["*"]).

4. Clique em Salvar .

Depois de adicionados, os servidores MCP ficam imediatamente disponíveis ao Genie Code. Você pode começar a usá-los sem alterar seus prompts ou instruções. O Genie Code utiliza automaticamente esses servidores quando relevante.

É possível escolher quais ferramentas e servidores habilitar ou desabilitar nas configurações do Genie Code.

Limitações

• Servidores MCP externos estão disponíveis apenas em regiões onde o Servindo Modelo é suportado. Consulte disponibilidade do recurso do modelo disponível.