Referência de ferramentas do SERVIDOR MCP do Fabric Core

Fabric Core MCP Server fornece ferramentas que os agentes de IA usam para interagir com Microsoft Fabric. Cada ferramenta é mapeada para uma operação de API REST Fabric e inclui validação de entrada e tratamento de erros.

Observação

Fabric Core MCP Server está atualmente em versão prévia. As ferramentas disponíveis e seus recursos podem mudar antes da disponibilidade geral.

Ferramentas disponíveis

Tool Descrição
list_workspaces Listar todos os workspaces aos quais você tem acesso
get_workspace Obter informações detalhadas sobre um workspace específico
create_workspace Criar um novo workspace em seu locatário Fabric
update_workspace Atualizar o nome ou a descrição de um workspace
delete_workspace Excluir um workspace existente
add_workspace_role Conceder a um usuário acesso a um workspace
list_workspace_roles Listar todas as atribuições de função para um workspace
get_workspace_role Obter detalhes sobre uma atribuição de função específica
update_workspace_role Alterar a função de um usuário em um workspace
delete_workspace_role Remover o acesso de um usuário a um workspace
list_items Listar todos os itens em um workspace
get_item Obter informações detalhadas sobre um item específico
create_item Criar um novo item em um workspace
update_item Atualizar o nome ou a descrição de um item
delete_item Excluir um item de um workspace
get_item_definition Obter o esquema ou a definição de um item
update_item_definition Atualizar a definição ou o esquema de um item
bulk_move_items Mover vários itens para uma pasta
create_folder Criar uma nova pasta em um workspace
list_folders Listar todas as pastas em um workspace
get_folder Obter detalhes sobre uma pasta específica
update_folder Renomear uma pasta
delete_folder Excluir uma pasta vazia
move_folder Mover uma pasta para uma nova pasta pai
list_capacities Listar todas as capacidades Fabric às quais você tem acesso
get_operation_state Verificar o status de uma operação de execução prolongada
get_operation_result Obter o resultado de uma operação concluída
get_knowledge Obter diretrizes e práticas recomendadas para tipos de item

Funções do espaço de trabalho

Fabric workspaces dão suporte a quatro níveis de função:

Função Permissões
Administrador Controle total, incluindo configurações de workspace, atribuições de função e exclusão
Membro Criar, editar e excluir itens; não pode gerenciar as configurações ou funções do workspace
Contributor Criar e editar itens; não é possível excluir itens
Visualizador Acesso somente leitura a workspaces e itens

Observações importantes

  • Você deve ter permissões para criar workspaces em seu locatário Fabric. Algumas organizações restringem a criação de workspace a funções específicas.
  • Excluir um workspace remove permanentemente todos os itens dentro dele. Essa operação não pode ser desfeita.
  • As pastas devem estar vazias antes da exclusão. Mova ou exclua todos os itens dentro da pasta primeiro.
  • Adicione Microsoft Graph SERVIDOR MCP para resolver endereços de email automaticamente. Sem ele, você precisa fornecer IDs de entidade de usuário para operações de função.

Exemplos de fluxos de trabalho

Fluxo de trabalho 1: Explorar seu ambiente

Descubra a quais recursos você tem acesso no Fabric.

Solicita:

  1. "Listar todos os meus workspaces Fabric"
  2. "Mostre-me todos os itens no workspace da Análise de Vendas"
  3. "Que lakehouses existem na Análise de Vendas?"
  4. "Obter a definição da lakehouse CustomerData"

Fluxo de trabalho 2: criar um ambiente de desenvolvimento

Configure um workspace de desenvolvimento completo com recursos e acesso à equipe.

Solicita:

  1. "Criar um workspace chamado Desenvolvimento da Análise de Vendas"
  2. "Criar uma lakehouse chamada CustomerData_Dev no Sales Analytics Dev"
  3. "Adicionar john@contoso.com como colaborador ao Desenvolvimento da Análise de Vendas"
  4. "Adicionar sarah@contoso.com como membro ao Desenvolvimento da Análise de Vendas"

Dica

Esse fluxo de trabalho requer Microsoft Graph MCP para resolver endereços de email. Sem o GRAPH MCP, forneça IDs de entidade de usuário em vez de emails.

Fluxo de trabalho 3: auditar e gerenciar permissões

Examine e atualize o controle de acesso do workspace.

Solicita:

  1. "Listar todas as atribuições de função para o workspace de Finanças"
  2. "Quem tem acesso de administrador a Finanças?"
  3. "Alterar john@contoso.com de Visualizador para Colaborador em Finanças"
  4. "Remover contractor@contoso.com do workspace de Finanças"

Solução de problemas

Erro de ID do workspace inválido

Problema: A mensagem de erro indica "ID de workspace inválida" quando você fornece um nome ou ID de workspace.

Solution:

  1. Execute list_workspaces para obter a ID correta do workspace.
  2. Use a ID do workspace (formato UUID) em operações subsequentes.

Falha na autenticação (erros 401 ou 403)

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

Solução para VS Code:

  1. Pressione Ctrl+Shift+P e selecione MCP: Remover Servidor, escolha malha.
  2. Pressione Ctrl+Shift+P e selecione MCP: Adicionar HTTP do servidor>.
  3. Insira https://api.fabric.microsoft.com/v1/mcp/core e conclua a autenticação do navegador.

Solução para Claude Desktop e outros clientes:

  1. Gere um novo token de acesso:

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

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

Tempo limite de operação de execução prolongada

Problema: A operação parece ter tempo limite ou não é concluída.

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

  1. Observe o operation-id retorno da operação inicial.
  2. Verificar o status: "Verificar o status da operação {operation-id}"
  3. Depois que o status for "Bem-sucedido", obtenha o resultado: "Obter o resultado da operação {operation-id}"

Detalhes da conexã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