Introdução ao Fabric Core MCP Server

Conecte seu agente de IA a Microsoft Fabric usando o Servidor MCP Core hospedado na nuvem e comece a gerenciar workspaces com linguagem natural. Este guia de início rápido orienta você pela configuração e pela primeira interação.

Tempo de conclusão: 5 a 10 minutos

Observação

Fabric Core MCP Server está atualmente em versão prévia. Os recursos e a configuração podem ser alterados antes da disponibilidade geral.

Dica

Deseja entender primeiro o modelo de arquitetura e segurança? Consulte a visão geral do Fabric Core MCP Server. Ou compare com Fabric Pro-Dev MCP Server para desenvolvimento local.

Pré-requisitos

Antes de começar, verifique se você tem:

Acesso ao Microsoft Fabric — um inquilino do Fabric ativo com pelo menos um espaço de trabalho que você pode acessar
agente compatível comMCP — VS Code com GitHub Copilot (recomendado) ou Claude Desktop
Conta Microsoft Entra ID — sua conta de trabalho ou de estudante da Microsoft com permissões de Fabric

Adicionar Servidor MCP do Fabric Core

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

Configurar VS Code

No VS Code, pressione Ctrl+Shift+P (ou Cmd+Shift+P no macOS) para abrir a paleta de comandos.
Digite MCP: Adicione o Servidor e selecione HTTP na lista.
Insira a URL do servidor MCP Principal do Fabric:
```
https://api.fabric.microsoft.com/v1/mcp/core
```
Quando solicitado um nome de servidor, insira fabric.
O VS Code abre seu navegador para autenticação. Entre com sua conta Microsoft Entra ID.

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

Alternativa: configuração manual

Você também pode configurar Fabric Core MCP Server editando diretamente o arquivo de configurações do VS Code.

Adicione o seguinte a .vscode/mcp.json:

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

Configurar o Claude Desktop

Localize o arquivo de configuração do Claude Desktop:
- macOS:~/Library/Application Support/Claude/claude_desktop_config.json
- Windows:%APPDATA%\Claude\claude_desktop_config.json
Abra o arquivo de configuração em um editor de texto.

Adicione a configuração Fabric Core MCP Server:

{
  "mcpServers": {
    "fabric": {
      "type": "http",
      "url": "https://api.fabric.microsoft.com/v1/mcp/core",
      "headers": {
        "Authorization": "Bearer YOUR_TOKEN"
      }
    }
  }
}

Substitua YOUR_TOKEN por um token de acesso.

Obter um token de acesso

Para obter um token de acesso para Fabric:

Abra um terminal ou prompt de comando.

Execute o seguinte comando CLI do Azure:

az account get-access-token --resource https://api.fabric.microsoft.com

Copie o accessToken valor da resposta.
Cole-o no arquivo de configuração do Claude Desktop substituindo YOUR_TOKEN.

Importante

Os tokens de acesso expiram após um período de tempo (normalmente uma hora). Se a autenticação falhar, gere um novo token e atualize sua configuração.

Configuração genérica do cliente MCP

Para clientes MCP personalizados ou outros agentes de IA que dão suporte ao MCP:

Detalhes da conexão:

Propriedade	Valor
URL do Ponto de Extremidade	`https://api.fabric.microsoft.com/v1/mcp/core`
Tipo de autenticação	Token de portador OAuth 2.0
Escopo de autenticação	`https://api.fabric.microsoft.com/.default`
Provedor de identidade	Microsoft Entra ID

Implementação:

Configure seu cliente MCP para se conectar à URL do servidor MCP do Fabric Core.
Implemente o fluxo de autenticação do OAuth 2.0 usando Microsoft Entra ID.
Inclua o token de acesso no Authorization cabeçalho:
```
Authorization: Bearer {access_token}
```
Defina o escopo do token como https://api.fabric.microsoft.com/.default.

Consulte a documentação de configuração do MCP do agente de IA para obter etapas de instalação específicas.

Verificar a conexão

Depois de configurar o agente de IA, verifique se Fabric Servidor MCP Principal está conectado:

No VS Code, abra o GitHub Copilot Chat pressionando Ctrl+Alt+I (ou Cmd+Alt+I no macOS).
Insira o seguinte prompt:
```
List all my Fabric workspaces
```
Copilot usa o Fabric Core MCP Server para recuperar seus espaços de trabalho.

Você deve ver uma lista de nomes de workspace aos quais você tem acesso.

Abra uma conversa no Claude Desktop.
Insira o seguinte prompt:
```
List all my Fabric workspaces
```
Claude usa o Fabric Core MCP Server para recuperar seus espaços de trabalho.

Você deve ver uma lista de nomes de workspace aos quais você tem acesso.

Dica

Se a conexão falhar, desconecte e reconecte o servidor MCP nas configurações do agente de IA. Verifique se você tem pelo menos acesso do Visualizador a um workspace Fabric em seu locatário.

Experimentar prompts de exemplo

Agora que você está conectado, experimente estas operações comuns:

Explorar recursos:

Show me all items in the Sales Analytics workspace

What lakehouses exist in my development environment?

Criar recursos:

Create a workspace called Sales Analytics Dev

Create a lakehouse named CustomerData in the Dev workspace

Gerenciar 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 do Microsoft Graph MCP

Para habilitar a resolução de usuários e grupos por endereço de email, você também pode conectar o servidor MCP Microsoft Graph. Esse aprimoramento permite que você conceda acesso usando endereços de email em vez de procurar IDs de usuário manualmente.

Por que adicionar o MCP do Graph

Sem o MCP do Graph:

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

Com o MCP do Graph:

Add john@contoso.com as Contributor to Sales Analytics

O agente de IA resolve automaticamente endereços de email para identidades principais de usuário.

Comandos de exemplo com o GRAPH MCP

Adicionar a equipe de Marketing ao espaço de trabalho no Sales Analytics como Visualizadores
Conceder john@contoso.com acesso de colaborador ao meu ambiente de desenvolvimento.
"Quem são os membros do grupo administradores financeiros?"

Configurar o MCP do Graph

Siga as instruções de configuração em Introdução ao Microsoft MCP Server for Enterprise.

Limpeza

Para remover a conexão do Fabric Core MCP Server:

Pressione Ctrl+Shift+P (ou Cmd+Shift+P no macOS).
Digite MCP: Remova o Servidor e selecione-o.
Selecione a malha na lista.

Próximas Etapas

Last updated on 2026-04-13