Referência às ferramentas do Fabric Core MCP Server

O Fabric Core MCP Server fornece ferramentas que os agentes de IA utilizam para interagir com o Microsoft Fabric. Cada ferramenta corresponde a uma operação de API Fabric REST e inclui validação de entrada e gestão de erros.

Observação

O Fabric Core MCP Server está atualmente em pré-visualização. As ferramentas disponíveis e as suas capacidades podem mudar antes da disponibilidade geral.

Ferramentas disponíveis

Tool Descrição
list_workspaces Lista todos os espaços de trabalho a que tens acesso
get_workspace Obtenha informações detalhadas sobre um espaço de trabalho específico
create_workspace Crie um novo espaço de trabalho no seu tenant Fabric
update_workspace Atualize o nome ou descrição de um espaço de trabalho
delete_workspace Eliminar um espaço de trabalho existente
add_workspace_role Conceder a um utilizador acesso a um espaço de trabalho
list_workspace_roles Liste todas as atribuições de funções para um espaço de trabalho
get_workspace_role Obtenha detalhes sobre uma atribuição de função específica
update_workspace_role Alterar o papel de um utilizador num espaço de trabalho
delete_workspace_role Remover o acesso de um utilizador a um espaço de trabalho
list_items Liste todos os itens num espaço de trabalho
get_item Obtenha informações detalhadas sobre um artigo específico
create_item Crie um novo item num espaço de trabalho
update_item Atualizar o nome ou descrição de um artigo
delete_item Eliminar um item de um espaço de trabalho
get_item_definition Obtenha o esquema ou definição de um item
update_item_definition Atualizar a definição ou esquema de um item
bulk_move_items Mover vários itens para uma pasta
create_folder Crie uma nova pasta num espaço de trabalho
list_folders Liste todas as pastas num espaço de trabalho
get_folder Obtenha detalhes sobre uma pasta específica
update_folder Renomear uma pasta
delete_folder Apagar uma pasta vazia
move_folder Mover uma pasta para uma nova pasta pai
list_capacities Liste todas as capacidades de Fabric a que tem acesso
get_operation_state Verificar o estado de uma operação de longa duração
get_operation_result Obtenha o resultado de uma operação concluída
get_knowledge Obtenha orientações e boas práticas para tipos de itens

Funções do espaço de trabalho

Os espaços de trabalho Fabric suportam quatro níveis de função:

Função Permissões
Administrador Controlo total incluindo definições do espaço de trabalho, atribuição de funções e eliminação
Membro Criar, editar e eliminar itens; Não é possível gerir definições ou funções de espaço de trabalho
Contributor Criar e editar itens; Não é possível apagar itens
Visualizador Acesso apenas de leitura ao espaço de trabalho e aos itens

Observações importantes

  • Deve ter permissões para criar espaços de trabalho no seu inquilino Fabric. Algumas organizações restringem a criação de espaços de trabalho a funções específicas.
  • Eliminar um espaço de trabalho remove permanentemente todos os itens dentro dele. Esta operação não pode ser desfeita.
  • As pastas devem estar vazias antes de serem eliminadas. Mover ou apagar todos os itens dentro da pasta primeiro.
  • Adicionar Microsoft Graph MCP Server para resolver automaticamente os endereços de email. Sem isso, é necessário fornecer IDs de utilizador principal para operações de funções.

Exemplos de fluxos de trabalho

Fluxo de Trabalho 1: Explore o seu ambiente

Descubra quais os recursos a que tem acesso na Fabric.

Prompts:

  1. "Lista todos os meus espaços de trabalho Fabric"
  2. "Mostre-me todos os itens no espaço de trabalho de Análise de Vendas"
  3. "Que casas de lago existem na Análise de Vendas?"
  4. "Obtenha a definição da casa do lago CustomerData"

Fluxo de Trabalho 2: Criar um ambiente de desenvolvimento

Configura um espaço de trabalho completo de desenvolvimento, com recursos e acesso à equipa.

Prompts:

  1. "Criar um espaço de trabalho chamado Sales Analytics Dev"
  2. "Crie uma casa de lago chamada CustomerData_Dev em Desenvolvimento de Análise de Vendas"
  3. "Adicionar john@contoso.com como Contribuinte para Desenvolvimento de Análise de Vendas"
  4. "Adicionar sarah@contoso.com como Membro ao Desenvolvimento de Vendas em Análise de Vendas"

Sugestão

Este fluxo de trabalho requer Microsoft Graph MCP para resolver endereços de email. Sem o Graph MCP, forneça IDs principais de utilizador em vez de emails.

Fluxo de Trabalho 3: Auditoria e gestão de permissões

Revise e atualize o controlo de acesso ao espaço de trabalho.

Prompts:

  1. "Liste todas as atribuições de funções para o espaço de trabalho de Finanças"
  2. "Quem tem acesso de Administrador às Finanças?"
  3. "Mudança john@contoso.com de Espectador para Colaborador em Finanças"
  4. "Remover contractor@contoso.com do espaço de trabalho de Finanças"

Troubleshooting

Erro de ID de espaço de trabalho inválido

Problema: A mensagem de erro indica "ID de espaço de trabalho inválido" quando fornece o nome ou ID do espaço de trabalho.

Solution:

  1. Corre list_workspaces para obter o ID correto do espaço de trabalho.
  2. Use o ID do espaço de trabalho (formato UUID) nas operações subsequentes.

Autenticação falhada (erros 401 ou 403)

Problema: As operações falham devido a erros de autorização.

Solução para o VS Code:

  1. Prima Ctrl+Shift+P e seleciona MCP: Remover Servidor, escolhe o tecido.
  2. Pressione Ctrl+Shift+P e selecione MCP: Adicionar HTTP do Servidor>.
  3. Introduzir https://api.fabric.microsoft.com/v1/mcp/core e completar a autenticação do navegador.

Solução para Claude Desktop e outros clientes:

  1. Gerar um novo token de acesso:

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

  2. Atualize a configuração do seu cliente com o novo token.

Tempo de espera de operação de longa duração

Problema: A operação parece expirar ou não terminar.

Solução: Use as ferramentas de operações para monitorizar operações assíncronas:

  1. Note o operation-id retorno da operação inicial.
  2. Verificar estado: "Verificar o estado da operação {operation-id}"
  3. Quando o estado for "Succeeded", obtenha o resultado: "Obtenha o resultado da operação {operation-id}"

Detalhes da ligação

  • Ponto de Extremidade:https://api.fabric.microsoft.com/v1/mcp/core
  • Auth: OAuth 2.0 via Microsoft Entra ID
  • Âmbito:https://api.fabric.microsoft.com/.default

Conteúdo relacionado

  • Last updated on