Observação
O acesso a essa página exige autorização. Você pode tentar entrar ou alterar diretórios.
O acesso a essa página exige autorização. Você pode tentar alterar os diretórios.
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.
Instalar com um link
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.