Ligue o Código Genie aos servidores MCP

O Genie Code liga-se a ferramentas, documentos e dados externos através de servidores Model Context Protocol (MCP) e conectores nativos para Google Drive, SharePoint, GitHub, Glean, Atlassian e Slack. 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. O acesso ao MCP está limitado a 20 ferramentas em todos os servidores; escolhes quais as ferramentas a ativar nas definições do Código Genie.

O que é MCP?

MCP é um standard open source que liga agentes de IA 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 de IA, 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 Genie Code a um Genie Space 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 do espaço 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 o seu próprio, consulte Model Context Protocol (MCP) no Azure Databricks.

Use conectores nativos para fontes de dados de terceiros

O Genie Code fornece conectores integrados para fontes de dados empresariais comuns, incluindo Google Drive, SharePoint, GitHub, Glean, Atlassian e Slack.

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

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. Veja Conceder acesso aos colegas de equipa.

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

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 10 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.
• Erros de expiração de sessão ou de token podem aparecer na saída do agente. É necessário reautenticar para resolver.

Limitações do SharePoint

• O tamanho máximo do ficheiro é de 10 MB.
• Os tipos de ficheiros 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 GitHub

• Por defeito, o conector GitHub MCP do Databricks só pode aceder a repositórios públicos. Para dar ao conector acesso de leitura aos repositórios privados da sua empresa, um administrador da organização do GitHub tem de concluir passos de configuração adicionais. Ver Ativar acesso a repositórios privados.
• O GitHub Enterprise Server (a versão auto-hospedada do GitHub) não é suportado.

Limitações de Glean

• Um administrador de espaço de trabalho deve primeiro configurar o ID do tenant Glean antes de utilizadores não administradores poderem usar a ligação. O administrador pode introduzir o ID do inquilino ao ligar-se pela primeira vez ao Glean.

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 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.
   • Espaço Génio: Selecione o Espaço Génio. O Genie MCP invoca o Genie como ferramenta, permitindo-te consultar o Genie Space 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 encontrar erros no CORS, pode ser necessário adicionar o URL do seu espaço de trabalho à lista de origens permitidas da sua aplicação. 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 Genie Code irá automaticamente usar estes servidores quando relevante.

Atualmente, o acesso ao MCP está limitado a 20 ferramentas em todos os servidores. Podes escolher quais ferramentas e servidores ativar ou desativar nas definições do Código Genie.

Limitações

• 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.