referens för Fabric Core MCP Server-verktyg

Fabric Core MCP Server innehåller verktyg som AI-agenter använder för att interagera med Microsoft Fabric. Varje verktyg mappar till en Fabric REST API-åtgärd och innehåller indataverifiering och felhantering.

Anmärkning

Fabric Core MCP Server är för närvarande i förhandsversion. Tillgängliga verktyg och deras funktioner kan ändras före allmän tillgänglighet.

Tillgängliga verktyg

Verktyg Beskrivning
search_catalog Sök i OneLake-katalogen efter objekt mellan arbetsytor. Verktyget anropar API:et för katalogsökning.
list_workspaces Visa en lista över alla arbetsytor som du har åtkomst till
get_workspace Få detaljerad information om en specifik arbetsyta
create_workspace Skapa en ny arbetsyta i din Fabric klientorganisation
update_workspace Uppdatera en arbetsytas namn eller beskrivning
delete_workspace Ta bort en befintlig arbetsyta
add_workspace_role Ge en användare åtkomst till en arbetsyta
list_workspace_roles Visa en lista över alla rolltilldelningar för en arbetsyta
get_workspace_role Få information om en specifik rolltilldelning
update_workspace_role Ändra en användares roll i en arbetsyta
delete_workspace_role Ta bort en användares åtkomst till en arbetsyta
list_items Visa en lista över alla objekt på en arbetsyta
get_item Få detaljerad information om ett specifikt objekt
create_item Skapa ett nytt objekt på en arbetsyta
update_item Uppdatera ett objekts namn eller beskrivning
delete_item Ta bort ett objekt från en arbetsyta
get_item_definition Hämta schemat eller definitionen av ett objekt
update_item_definition Uppdatera ett objekts definition eller schema
bulk_move_items Flytta flera objekt till en mapp
create_folder Skapa en ny mapp på en arbetsyta
list_folders Visa en lista över alla mappar på en arbetsyta
get_folder Hämta information om en specifik mapp
update_folder Byt namn på en mapp
delete_folder Ta bort en tom mapp
move_folder Flytta en mapp till en ny överordnad mapp
list_capacities Visa en lista över alla Fabric kapaciteter som du har åtkomst till
get_operation_state Kontrollera statusen för en tidskrävande åtgärd
get_operation_result Hämta resultatet av en slutförd åtgärd
get_knowledge Få riktlinjer och metodtips för objekttyper

Arbetsplatsroller

Fabric arbetsytor har stöd för fyra rollnivåer:

Befattning behörigheter
Administratör Fullständig kontroll, inklusive arbetsyteinställningar, rolltilldelningar och borttagning
Medlem Skapa, redigera och ta bort objekt; kan inte hantera arbetsyteinställningar eller roller
Contributor Skapa och redigera objekt; kan inte ta bort objekt
Visare Skrivskyddad åtkomst till arbetsyta och objekt

Viktiga anteckningar

  • Du måste ha behörighet att skapa arbetsytor i din Fabric klientorganisation. Vissa organisationer begränsar skapandet av arbetsytor till specifika roller.
  • Om du tar bort en arbetsyta tas alla objekt i den bort permanent. Det går inte att ångra den här åtgärden.
  • Mapparna måste vara tomma innan de tas bort. Flytta eller ta bort alla objekt i mappen först.
  • Lägg till Microsoft Graph MCP Server för att lösa e-postadresser automatiskt. Utan det måste du ange användarens huvudnamns-ID för rollåtgärder.

Exempelarbetsflöden

Arbetsflöde 1: Utforska din miljö

Upptäck vilka resurser du har åtkomst till i Fabric.

Uppmanas:

  1. "Lista alla mina Fabric arbetsytor"
  2. "Visa alla objekt på arbetsytan Sales Analytics"
  3. "Vilka lakehouses finns i Sales Analytics?"
  4. "Hämta definitionen av CustomerData lakehouse"

Arbetsflöde 2: Skapa en utvecklingsmiljö

Konfigurera en fullständig utvecklingsarbetsyta med resurser och teamåtkomst.

Uppmanas:

  1. "Skapa en arbetsyta med namnet Sales Analytics Dev"
  2. "Skapa ett sjöhus med namnet CustomerData_Dev i Sales Analytics Dev"
  3. "Lägg till john@contoso.com som deltagare i Sales Analytics Dev"
  4. "Lägg till sarah@contoso.com som medlem i Sales Analytics Dev"

Tips/Råd

Det här arbetsflödet kräver Microsoft Graph MCP för att lösa e-postadresser. Utan Graph MCP anger du användarens huvudnamns-ID i stället för e-post.

Arbetsflöde 3: Granska och hantera behörigheter

Granska och uppdatera åtkomstkontroll för arbetsytan.

Uppmanas:

  1. "Visa en lista över alla rolltilldelningar för arbetsytan Ekonomi"
  2. "Vem har administratörsåtkomst till Ekonomi?"
  3. "Ändra john@contoso.com från visningsprogram till deltagare i ekonomi"
  4. "Ta bort contractor@contoso.com från arbetsytan Ekonomi"

Felsökning

Ogiltigt arbetsyte-ID-fel

Problem: Felmeddelandet anger "Ogiltigt arbetsyte-ID" när du anger ett arbetsytenamn eller ID.

Lösning:

  1. Kör list_workspaces för att hämta rätt arbetsyte-ID.
  2. Använd arbetsytans ID (UUID-format) i efterföljande åtgärder.

Autentiseringen misslyckades (401- eller 403-fel)

Problem: Åtgärder misslyckas med auktoriseringsfel.

Lösning för VS Code:

  1. Tryck på Ctrl+Skift+P och välj MCP: Ta bort server, välj infrastrukturresurser.
  2. Tryck på Ctrl+Skift+P och välj MCP: Lägg till SERVER>HTTP.
  3. Ange https://api.fabric.microsoft.com/v1/mcp/core och slutför webbläsarautentisering.

Lösning för Claude Desktop och andra klienter:

  1. Generera en ny åtkomsttoken:

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

  2. Uppdatera klientkonfigurationen med den nya token.

Tidsgräns för tidskrävande åtgärder

Problem: Åtgärden verkar överskrida tidsgränsen eller slutförs inte.

Lösning: Använd åtgärdsverktygen för att övervaka asynkrona åtgärder:

  1. Observera den operation-id returnerade från den första åtgärden.
  2. Kontrollera status: "Kontrollera status för åtgärden {operation-id}"
  3. När statusen är "Lyckades" får du resultatet: "Hämta resultatet av åtgärden {operation-id}"

Anslutningsinformation

  • Slutpunkt:https://api.fabric.microsoft.com/v1/mcp/core
  • Auth: OAuth 2.0 via Microsoft Entra ID
  • Omfattning:https://api.fabric.microsoft.com/.default

Relaterat innehåll

  • Last updated on