Comece com o Fabric Core MCP Server

Ligue o seu agente de IA ao servidor remoto Fabric Core MCP e depois use linguagem natural para gerir os espaços de trabalho e itens do Fabric.

Tempo para concluir: 5–10 minutos

Pré-requisitos

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

  • Acesso Microsoft Fabric — Uma conta de trabalho ou escola no Microsoft Entra ID que pode aceder a pelo menos um espaço de trabalho Fabric
  • Cliente MCP — Um host MCP, ou o seu próprio agente, que suporta transporte HTTP Streamable e login do Microsoft Entra ID (recomenda-se o VS Code com GitHub Copilot)

Adicionar Fabric Core MCP Server

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

Selecione Instalar Fabric Core MCP Server em VS Code. O VS Code adiciona o servidor com o nome fabric. Quando o servidor iniciar, inicie sessão com a sua conta Microsoft Entra ID.

Adicione você mesmo o servidor

Adicione o seguinte a .vscode/mcp.json, e depois inicie o servidor Fabric e inicie sessão com a sua conta Microsoft Entra ID:

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

Para outras formas de adicionar, iniciar e gerir servidores, veja Usar servidores MCP no VS Code.

Verificar a ligação

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

No GitHub Copilot Chat, introduza o seguinte prompt:

List all my Fabric workspaces

O Copilot usa o Fabric Core MCP Server e lista os espaços de trabalho a que pode aceder.

Experimente exemplos de prompts

Importante

Alguns exemplos criam recursos ou alteram permissões de acesso. Revise as chamadas de ferramenta propostas e as definições de aprovação do seu cliente antes de permitir alterações. Para mais orientações, 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.

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

Sugestão

Para conceder acesso por endereço de email, como no último exemplo, ligue também o Microsoft MCP Server for Enterprise. Sem isso, fornece o ID do objeto do utilizador.

Troubleshoot

No VS Code ou noutro host MCP

Problem Solução
Não te pedem para iniciar sessão, ou o início de sessão falha. Certifique-se de que o seu host MCP suporta o início de sessão com o Microsoft Entra ID e inicie sessão com a sua conta profissional ou escolar. No VS Code, remova o servidor Fabric e adicione-o novamente.
O login pede aprovação do administrador. A sua organização exige que um administrador aprove a aplicação com a qual inicia sessão. Pede ao teu administrador para aprovar isso. O nome da aplicação aparece no ecrã de iniciação de sessão.
O agente reporta um ID de espaço de trabalho inválido. Pede ao agente para listar os teus espaços de trabalho e depois refere-te ao espaço pelo seu ID.
O agente não consegue encontrar um espaço de trabalho ou item que esperas. Verifica o nome ou ID e confirma se consegues aceder ao espaço de trabalho ou item no Fabric.
Uma ferramenta que esperas que esteja disponível não está disponível. As ferramentas podem mudar ao longo do tempo. Atualiza a lista de ferramentas do servidor no teu host MCP ou consulta a referência às ferramentas.

No seu próprio agente

Quando uma chamada de ferramenta falha, o erro normalmente aparece no resultado da ferramenta, com isError definido para true, em vez de 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" O pedido não incluía um token de acesso. Envie o token num Authorization: Bearer cabeçalho.
401 com erro -32600 JSON-RPC e "Unable to process the request" O token não é válido. Adquira 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 resposta tools/list.
"errorCode": "WorkspaceNotFound" ou "EntityNotFound" O espaço de trabalho ou item não foi encontrado. Verifique se o ID está correto.
JSON-RPC erro -32602 e "Tool <name> not found" O nome da ferramenta está errado ou já não existe. Liste novamente as ferramentas do servidor.

Se contactares o suporte da Microsoft, inclui a hora do erro, o cliente MCP que usas e o ID do pedido caso o erro apresente um.

Limpeza

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

Remove o servidor de Fabric da tua configuração MCP do VS Code. Para detalhes, veja Usar servidores MCP no VS Code.

Passos seguintes