Introdução ao Fabric Core MCP Server

Conecte o agente de IA ao servidor MCP do Fabric Core remoto e use a linguagem natural para gerenciar Fabric workspaces e itens.

Tempo de conclusão: 5 a 10 minutos

Pré-requisitos

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

  • Acesso ao Microsoft Fabric — uma conta corporativa ou de estudante no Microsoft Entra ID que pode acessar pelo menos um workspace do Fabric
  • Cliente MCP — um host MCP ou seu próprio agente, que dá suporte ao transporte HTTP streamable e à entrada Microsoft Entra ID (o VS Code com GitHub Copilot é recomendado)

Adicionar Servidor MCP do Fabric Core

Selecione como você se conecta: VS Code com GitHub Copilot, outro host MCP ou seu próprio agente.

Selecione Instalar o Servidor MCP Core do Fabric no VS Code. O VS Code adiciona o servidor com o nome Fabric. Quando o servidor for iniciado, entre com sua conta Microsoft Entra ID.

Adicione o servidor por conta própria

Adicione o seguinte a .vscode/mcp.json e, em seguida, inicie o servidor Fabric e entre com sua conta Microsoft Entra ID:

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

Para obter outras maneiras de adicionar, iniciar e gerenciar servidores, consulte Usar servidores MCP no VS Code.

Verificar a conexão

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

No GitHub Copilot Chat, insira o seguinte prompt:

List all my Fabric workspaces

Copilot usa Fabric Core MCP Server e lista os workspaces que você pode acessar.

Experimentar prompts de exemplo

Importante

Alguns exemplos criam recursos ou alteram permissões de acesso. Examine as chamadas de ferramenta propostas e as configurações de aprovação do cliente antes de permitir alterações. Para obter mais diretrizes, consulte Segurança e conformidade.

Explorar recursos:

Show me all items in the Sales Analytics workspace
Show the OneLake data access roles for the Sales lakehouse. Don't change any roles.

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

Dica

Para conceder acesso por endereço de email, como no último exemplo, conecte-se também Microsoft MCP Server for Enterprise. Sem ele, forneça a ID do objeto do usuário.

Troubleshoot

No VS Code ou em outro host MCP

Problema Solução
Você não é solicitado a fazer login, ou o login falha. Verifique se o host do MCP dá suporte à entrada no Microsoft Entra ID e entre com sua conta corporativa ou de estudante. No VS Code, remova o servidor Fabric e adicione-o novamente.
O login solicita aprovação do administrador. Sua organização exige que um administrador aprove o aplicativo com o qual você entra. Peça ao administrador para aprová-lo. O nome do aplicativo aparece na tela de entrada.
O agente relata uma ID de workspace inválida. Peça ao agente para listar seus workspaces e, em seguida, consulte o workspace por sua ID.
O agente não pode encontrar um workspace ou item esperado. Verifique o nome ou a ID e verifique se você pode acessar o workspace ou item no Fabric.
Uma ferramenta que você espera não está disponível. As ferramentas podem mudar ao longo do tempo. Atualize a lista de ferramentas do servidor em seu host MCP ou veja a referência de ferramentas.

Em seu próprio agente

Quando uma chamada de ferramenta falha, o erro geralmente aparece no resultado da ferramenta, com isError definido como true, em vez de como um erro HTTP. O resultado inclui um código de erro e uma mensagem.

Erro Causa e solução
401 com "errorCode": "TokenIsMissing" e "Access token is required" A solicitação não incluiu um token de acesso. Envie o token em um Authorization: Bearer cabeçalho.
401 com JSON-RPC erro -32600 e "Unable to process the request" O token não é válido. Adquirir um novo token para https://api.fabric.microsoft.com.
"Invalid arguments for tool <name>" Verifique os argumentos em relação ao esquema de entrada da ferramenta na tools/list resposta.
"errorCode": "WorkspaceNotFound" ou "EntityNotFound" O workspace ou item não foi encontrado. Verifique se a ID está correta.
JSON-RPC erro -32602 e "Tool <name> not found" O nome da ferramenta está errado ou não existe mais. Liste as ferramentas do servidor novamente.

Se você entrar em contato com o suporte da Microsoft, inclua a hora do erro, o cliente MCP que você usa e a ID da solicitação se o erro mostrar uma.

Limpeza

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

Remova o servidor Fabric da configuração MCP do VS Code. Para obter detalhes, consulte Usar servidores MCP no VS Code.

Próximas Etapas