Nota
O acesso a esta página requer autorização. Pode tentar iniciar sessão ou alterar os diretórios.
O acesso a esta página requer autorização. Pode tentar alterar os diretórios.
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.
Instalar com um único link
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.