Comece com o Fabric Core MCP Server

Ligue o seu agente de IA ao Microsoft Fabric usando o Core MCP Server alojado na cloud e comece a gerir espaços de trabalho com linguagem natural. Este guia de início rápido orienta-o na configuração e na sua primeira interação.

Tempo para completar: 5-10 minutos

Observação

O Fabric Core MCP Server está em prévia atualmente. As funcionalidades e a configuração podem mudar antes da disponibilidade geral.

Sugestão

Quer perceber primeiro a arquitetura e o modelo de segurança? Consulte a visão geral do Servidor MCP Núcleo Fabric. Ou compare com Fabric Pro-Dev MCP Server para desenvolvimento local.

Pré-requisitos

Antes de começar, certifique-se de que tem:

  • Acesso ao Microsoft Fabric — Um locatário Fabric ativo com pelo menos um espaço de trabalho ao qual você pode aceder
  • agente compatível com MCP — VS Code com GitHub Copilot (recomendado) ou Claude Desktop
  • Conta Microsoft Entra ID — A sua conta Microsoft de trabalho ou escola com permissões *Fabric*

Adicionar Fabric Core MCP Server

Selecione o seu agente de IA para ver as instruções de configuração:

Configurar VS Code

  1. No VS Code, pressione Ctrl+Shift+P (ou Cmd+Shift+P no macOS) para abrir a paleta de comandos.

  2. Escreve MCP: Add Server e seleciona HTTP da lista.

  3. Insira a URL do Fabric Core MCP Server:

    https://api.fabric.microsoft.com/v1/mcp/core
    
  4. Quando solicitado o nome do servidor, introduza fabric.

  5. O VS Code abre o seu navegador para autenticação. Inicie sessão com a sua conta Microsoft Entra ID.

    A janela do navegador fecha automaticamente após a autenticação bem-sucedida.

Alternativa: Configuração manual

Também pode configurar o Fabric Core MCP Server editando diretamente o ficheiro de definições do VS Code.

Adicione o seguinte a .vscode/mcp.json:

{
  "servers": {
    "fabric": {
      "type": "http",
      "url": "https://api.fabric.microsoft.com/v1/mcp/core"
    }
  }
}

Verificar a ligação

Depois de configurar o seu agente de IA, verifique se o Fabric Core MCP Server está ligado:

  1. No VS Code, abre o Copilot Chat do GitHub pressionando Ctrl+Alt+I (ou Cmd+Alt+I no macOS).

  2. Digite o seguinte prompt:

    List all my Fabric workspaces
    
  3. O Copilot utiliza o Fabric Core MCP Server para recuperar os seus espaços de trabalho.

    Deves ver uma lista de nomes de espaços de trabalho a que tens acesso.

Sugestão

Se a ligação falhar, desligue e volte a ligar o servidor MCP nas definições do seu agente de IA. Certifique-se de que tem pelo menos acesso de Visualizador a um espaço de trabalho Fabric no seu locatário.

Experimente exemplos de prompts

Agora que estás ligado, experimenta estas operações comuns:

Explore recursos:

Show me all items in the Sales Analytics workspace
What lakehouses exist in my development environment?

Crie recursos:

Create a workspace called Sales Analytics Dev
Create a lakehouse named CustomerData in the Dev workspace

Gerir permissões:

List all role assignments for the Finance workspace
Add john@contoso.com as a Contributor to my Dev workspace

Opcional: Adicionar integração com Microsoft Graph MCP

Para permitir a resolução de utilizadores e grupos por endereço de email, pode também ligar o Microsoft Graph MCP Server. Esta melhoria permite-lhe conceder acesso usando endereços de email em vez de consultar manualmente os IDs de utilizador.

Por que adicionar o Graph MCP

Sem Graph MCP:

Add user {uuid-guid} as Contributor to Sales Analytics

Com o Graph MCP:

Add john@contoso.com as Contributor to Sales Analytics

O agente de inteligência artificial resolve automaticamente endereços de email para IDs principais de utilizador.

Comandos de exemplo com Graph MCP

  • Adicionar a equipa de Marketing ao espaço de trabalho de Análise de Vendas como Visualizadores
  • "Conceder john@contoso.com acesso a Contribuidor ao meu espaço de trabalho de desenvolvimento"
  • "Quem são os membros do grupo de Administradores Financeiros?"

Setup Graph MCP

Siga as instruções de configuração em Comece a usar Microsoft MCP Server for Enterprise.

Limpeza

Para remover a ligação ao servidor Fabric Core MCP:

  1. Pressiona Ctrl+Shift+P (ou Cmd+Shift+P no macOS).
  2. Escreve MCP: Remove Server e selecioná-lo.
  3. Selecione tecido da lista.

Passos seguintes