Ligue o Código Genie aos servidores MCP

O Genie Code liga-se a ferramentas externas, documentos e dados através de servidores Model Context Protocol (MCP) e conectores nativos para Google Drive, Gmail, Google Calendar, Microsoft 365, Atlassian, Glean, Slack e GitHub. Usa os conectores nativos para fontes SaaS comuns, ou adiciona os teus próprios servidores MCP externos ou personalizados a partir do espaço de trabalho. Escolhes que ferramentas ativar nas definições do Código Genie.

O que é MCP?

O MCP é um standard open source que liga agentes a ferramentas, recursos, prompts e outras informações contextuais. O MCP fornece uma forma padronizada de expor ferramentas, dados e fluxos de trabalho ao Código Genie sem incorporar esse contexto diretamente em prompts ou instruções.

O MCP foi concebido para casos em que o contexto importante já existe, mas é difícil de aceder a partir de um agente, como o Genie Code. O MCP oferece uma forma segura de dar ao Código Génio acesso a contextos como o seguinte:

• Sistemas de documentação: As equipas costumam manter livros de operações ou documentos operacionais em ferramentas como a Confluence. Em vez de copiar secções em prompts, esse conteúdo pode ser exposto uma vez através de um servidor MCP externo e referenciado quando relevante. Os seus documentos também podem já estar no Databricks como índice de IA Search, que o Genie Code pode usar para consultar documentos relevantes.
• Ferramentas e serviços: As equipas da plataforma podem manter APIs ou scripts para configuração, validação ou implementação. O MCP disponibiliza essas capacidades diretamente ao Genie Code.
• Fontes de dados: Se já tem dados no Databricks, pode ligar o Código Genie a um Agente Genie para o ajudar a analisar os dados usando linguagem natural. Para dados armazenados fora dos Databricks, pode dar acesso seguro ao Genie Code através de servidores MCP externos.
• Aplicações personalizadas: Também pode adicionar funcionalidades personalizadas alojadas através das aplicações Databricks. Isto permite-lhe ligar o Genie Code a ferramentas proprietárias, fluxos de trabalho ou integrações criadas especificamente para si ou para a sua organização, tudo gerido de forma segura dentro do seu espaço de trabalho Databricks.

Nestes casos, o MCP substitui o copiar e colar manualmente por uma abordagem estruturada e reutilizável, tornando o contexto correto disponível apenas quando necessário.

Podes ligar o Genie Code a quaisquer servidores MCP no teu espaço de trabalho que tenhas permissão para usar. Os administradores de espaços de trabalho controlam quais os servidores disponíveis, enquanto os utilizadores podem escolher entre essas fontes aprovadas conforme necessário.

Para saber mais sobre servidores MCP no Databricks e como criar os seus próprios, consulte MCPs e ferramentas de agentes.

Use conectores nativos para fontes de dados de terceiros

O Genie Code fornece conectores incorporados para fontes de dados empresariais comuns:

• Google Drive: Pesquise e crie Google Docs, Sheets e Slides; edite os Docs que criar.
• Gmail: Pesquisar, ler e redigir email.
• Google Calendário: Pesquise e crie eventos no calendário.
• Microsoft 365: Pesquisar no SharePoint, Teams, Outlook e Calendário; redigir e-mails no Outlook.
• Atlassian: Procura e atualiza Jira e Confluence.
• Glean (Beta): Pesquise entre as aplicações ligadas da sua organização usando o Glean.
• Slack: Pesquise mensagens e canais do Slack e envie mensagens.
• GitHub: Pesquisar e atualizar repositórios, problemas e pedidos de integração.

A ligação a estas fontes de dados permite ao Genie Code pesquisar os seus documentos e tomar ações em ferramentas ligadas ao responder a perguntas. Cada utilizador autentica-se individualmente, e os tokens OAuth não são partilhados entre utilizadores.

Estas ligações usam conectores MCP fornecidos pelo Databricks, por isso não há servidor para hospedar nem aplicação OAuth para registar. O Azure Databricks governa todas as ligações através do Unity Catalog e do Unity Gateway. O gateway autoriza cada chamada de ferramenta contra as permissões do seu Catálogo Unity, aplica políticas e requisitos de aprovação incorporados, e regista os registos de utilização e auditoria em tabelas do sistema. Veja Registar um servidor MCP externo.

Para ligar uma fonte de dados de terceiros:

1. No seu espaço de trabalho, clique Código Génio no canto superior direito para abrir um chat.
2. Na barra de prompts, clique no , que é o ícone de mais.
3. Ao lado da fonte de dados à qual pretende ligar-se, clique em Conectar.
4. Complete os passos para iniciar sessão.

Depois de autenticar, o Genie Code pode pesquisar os seus documentos ao responder a perguntas. Os administradores da Metastore e os proprietários da ligação podem gerir ou revogar permissões de utilizador na ligação. Ver Passo 4. Conceder acesso a um Serviço MCP.

Observação

As ferramentas de fonte de dados nem sempre ativam automaticamente. Se a pesquisa de documentos não começar, tente pedir explicitamente ao Genie Code para usar a ferramenta, por exemplo "use Google Docs" ou "use SharePoint".

Para ligar outras fontes de dados, adicione-as manualmente ao Código Genie. Veja Adicionar servidores MCP ao Código Genie manualmente.

Tarefas agendadas e autenticação

• O Código Genie não avisa quando a autenticação de uma ligação expira. Poderás só aperceber-te disso quando uma chamada de ferramenta falhar ou quando abrires a lista de ligações. É necessário reautenticar para resolver.
• Alterar as permissões de uma ligação exige que cada utilizador volte a autenticar-se. As tarefas agendadas que utilizam a ligação falham até o utilizador se voltar a autenticar.

Limitações do Google Drive

• Ao autorizar o Google Drive, pode ver um ecrã de "aplicação não verificada". Clique em Avançado e continue o processo de autorização.
• O tamanho máximo do ficheiro é de 25 MB.
• Apenas os ficheiros nativos do Google Workspace (Docs, Sheets, Slides) são suportados. PDFs, imagens e outros formatos binários não são suportados.
• O Genie Code pode criar documentos no Google Docs, folhas de cálculo no Google Sheets e apresentações no Google Slides, bem como editar os documentos do Google Docs que criou por meio do conector. Não pode editar documentos criados fora do conector, nem editar Sheets ou Slides existentes.
• Ler um documento muito grande pode ser lento.

Observação

A utilização e transferência de dados brutos ou derivados de utilizadores recebidos das APIs do Google Workspace irá cumprir a Política de Dados de Utilizador dos serviços da Google API, incluindo os requisitos de Uso Limitado.

Limitações do Gmail

• O Genie Code pode pesquisar, ler e redigir emails, mas não pode enviar emails nem editar mensagens existentes.
• O Genie Code não pode adicionar ficheiros do Drive como anexos nativos do Gmail. Como solução alternativa, inclua ligações para os ficheiros no corpo do email.

Limitações do Microsoft 365

• Inclui SharePoint, Teams, Outlook e Calendário.
• O Genie Code pode redigir mensagens de email no Outlook, mas não as pode enviar.
• O tamanho máximo do ficheiro é de 25 MB para ficheiros SharePoint.
• Tipos de ficheiros SharePoint suportados incluem documentos do Office (.docx, .xlsx, .pptx), bem como formatos comuns baseados em texto como .txt, .csv, .json, .md, e outros. PDFs, imagens e outros formatos binários não são suportados.

Limitações do Glean (Beta)

• O Glean serve apenas para pesquisa. Não consegue ler um documento a partir de um link direto.
• Um administrador da metastore deve primeiro configurar o ID do tenant Glean antes que utilizadores não administradores possam usar a ligação. O administrador pode introduzir o ID do inquilino ao ligar-se pela primeira vez ao Glean.
• Para se ligar a um servidor MCP Glean específico, um administrador da metastore pode opcionalmente definir o caminho do servidor MCP (por exemplo, /mcp/eng) ao configurar a ligação. Deixe este campo em branco para usar o caminho padrão (/mcp/default). Os utilizadores não administradores não podem especificar ou alterar o caminho do servidor Glean MCP.

Limitações de folga

• O Código Genie não pode editar ou apagar uma mensagem depois de a enviar.

Limitações do GitHub

• A escrita está limitada ao conteúdo de ficheiros, issues e pull requests.
• Por defeito, o conector GitHub MCP do Databricks só pode aceder a repositórios públicos. Para dar ao conector acesso de leitura aos seus repositórios empresariais privados, um administrador de uma organização do GitHub tem de concluir uma configuração adicional. Ver Ativar acesso a repositórios privados.
• O GitHub Enterprise Server (a versão auto-hospedada do GitHub) não é suportado.

Adicionar manualmente servidores MCP ao Genie Code

Para ligar o Código Genie a um servidor MCP, adicione-o nas suas definições do Código Genie:

1. Abrir as definições do Código Genie. No painel do Código Génio, clica Definições.
2. Em Servidores MCP, clique no ícone
3. Seleciona os servidores MCP que queres adicionar. Pode selecionar servidores MCP geridos Databricks ou servidores MCP externos:
   • Função do Catálogo Unity: Selecione o esquema da função. Isto permite ao Genie Code usar funções para executar consultas SQL pré-definidas.
     • Para obter ajuda para criar um servidor MCP do GitHub personalizado, veja Pesquisar código do GitHub com o Genie Code.
   • Pesquisa por IA: Selecione o esquema para o índice. Isto permite ao Genie Code consultar o índice de AI Search para encontrar documentos relevantes.
   • Agente Génio: Selecione o Agente Génio. O Genie MCP invoca o Genie como uma ferramenta, permitindo consultar o Agente Genie para analisar dados usando linguagem natural.
   • Servidor MCP externo: Selecione a ligação ao Catálogo Unity para usar como servidor MCP externo. Deve iniciar sessão na ligação antes de poder ser utilizada.
   • Servidor MCP personalizado: Selecione a aplicação Databricks para usar como servidor MCP personalizado. Isto permite-lhe usar quaisquer ferramentas definidas à medida. Aplicam-se os seguintes requisitos:
     • A sua aplicação deve ser implementada no mesmo espaço de trabalho de onde está a tentar ligar-se a ela.
     • O servidor MCP deve ser acedido em https://<server-url>/mcp.
     • A tua aplicação tem de ser sem estado. Por exemplo, defina mcp_app = mcp_server.http_app(stateless_http=True).
     • Se encontrares erros de CORS, podes precisar de adicionar o URL do teu espaço de trabalho à lista de origens permitidas da tua app. Por exemplo, defina app.add_middleware(CORSMiddleware, allow_origins=ALLOWED_ORIGINS, allow_credentials=True, allow_methods= ["*"], allow_headers= ["*"]).
4. Clique em Salvar.

Depois de serem adicionados, os servidores MCP ficam imediatamente disponíveis para o Genie Code. Podes começar a usá-los sem mudar os teus prompts ou instruções. O Código Genie recorre automaticamente a estes servidores quando relevante.

Podes escolher quais ferramentas e servidores ativar ou desativar nas definições do Código Genie.

Limitações

Para orientações de conformidade para aplicações conectadas, consulte limitações do serviço MCP fornecido pela Databricks.

• Servidores MCP externos estão disponíveis apenas em regiões onde o Model Serving é suportado. Consulte Disponibilidade de funcionalidades de serviço de modelos.