reference til Fabric Core MCP Server-værktøjer

Fabric Core MCP Server indeholder værktøjer, som AI-agenter bruger til at interagere med Microsoft Fabric. Hvert værktøj knyttes til en Fabric REST API-handling og omfatter inputvalidering og fejlhåndtering.

Bemærkning

Fabric Core MCP Server er i øjeblikket en prøveversion. Tilgængelige værktøjer og deres funktioner kan ændres, før de er offentligt tilgængelige.

Tilgængelige værktøjer

Værktøj Beskrivelse
list_workspaces Vis alle de arbejdsområder, du har adgang til
get_workspace Få detaljerede oplysninger om et bestemt arbejdsområde
create_workspace Opret et nyt arbejdsområde i din Fabric lejer
update_workspace Opdater et arbejdsområdes navn eller beskrivelse
delete_workspace Slet et eksisterende arbejdsområde
add_workspace_role Tildel en bruger adgang til et arbejdsområde
list_workspace_roles Vis alle rolletildelinger for et arbejdsområde
get_workspace_role Få oplysninger om en bestemt rolletildeling
update_workspace_role Skift en brugers rolle i et arbejdsområde
delete_workspace_role Fjern en brugers adgang til et arbejdsområde
list_items Vis alle elementer i et arbejdsområde
get_item Få detaljerede oplysninger om et bestemt element
create_item Opret et nyt element i et arbejdsområde
update_item Opdater et elements navn eller beskrivelse
delete_item Slet et element fra et arbejdsområde
get_item_definition Hent skemaet eller definitionen af et element
update_item_definition Opdater definitionen eller skemaet for et element
bulk_move_items Flyt flere elementer til en mappe
create_folder Opret en ny mappe i et arbejdsområde
list_folders Vis alle mapper i et arbejdsområde
get_folder Få oplysninger om en bestemt mappe
update_folder Omdøb en mappe
delete_folder Slet en tom mappe
move_folder Flyt en mappe til en ny overordnet mappe
list_capacities Vis alle Fabric kapaciteter, du har adgang til
get_operation_state Kontrollér status for en handling, der har kørt i lang tid
get_operation_result Hent resultatet af en fuldført handling
get_knowledge Få retningslinjer og bedste praksis for elementtyper

Arbejdsområderoller

Fabric arbejdsområder understøtter fire rolleniveauer:

Rolle Tilladelser
Admin Fuld kontrol, herunder indstillinger for arbejdsområde, rolletildelinger og sletning
Member Opret, rediger og slet elementer. kan ikke administrere indstillinger eller roller for arbejdsområder
Contributor Opret og rediger elementer. kan ikke slette elementer
Viewer Skrivebeskyttet adgang til arbejdsområde og elementer

Vigtige noter

  • Du skal have tilladelse til at oprette arbejdsområder i din Fabric lejer. Nogle organisationer begrænser oprettelse af arbejdsområder til bestemte roller.
  • Hvis du sletter et arbejdsområde, fjernes alle elementer i det permanent. Denne handling kan ikke fortrydes.
  • Mapper skal være tomme, før de slettes. Flyt eller slet først alle elementer i mappen.
  • Tilføj Microsoft Graph MCP Server for at fortolke mailadresser automatisk. Uden den skal du angive brugerens hoved-id'er for rollehandlinger.

Eksempler på arbejdsgange

Arbejdsproces 1: Udforsk dit miljø

Find ud af, hvilke ressourcer du har adgang til i Fabric.

Beder:

  1. "Vis alle mine Fabric arbejdsområder"
  2. "Vis alle elementer i arbejdsområdet Salgsanalyse"
  3. "Hvilke lakehouses findes i Sales Analytics?"
  4. "Hent definitionen af CustomerData lakehouse"

Arbejdsproces 2: Opret et udviklingsmiljø

Konfigurer et komplet udviklingsarbejdsområde med ressourcer og teamadgang.

Beder:

  1. "Opret et arbejdsområde kaldet Sales Analytics Dev"
  2. "Opret et lakehouse med navnet CustomerData_Dev i Sales Analytics Dev"
  3. "Føj john@contoso.com som bidragyder til Salgsanalyseudvikling"
  4. "Føj sarah@contoso.com som medlem til Salgsanalyseudvikling"

Tips

Denne arbejdsproces kræver Microsoft Graph MCP for at løse mailadresser. Uden Graph MCP skal du angive brugerens hoved-id'er i stedet for mails.

Arbejdsproces 3: Overvåg og administrer tilladelser

Gennemse og opdater adgangskontrol for arbejdsområdet.

Beder:

  1. "Vis alle rolletildelinger for arbejdsområdet Økonomi"
  2. "Hvem har administratoradgang til Finance?"
  3. "Skift john@contoso.com fra Fremviser til Bidragyder i Økonomi"
  4. "Fjern contractor@contoso.com fra arbejdsområdet Finance"

Fejlfinding

Ugyldig fejl i arbejdsområde-id

Problem: Fejlmeddelelsen angiver "Ugyldigt arbejdsområde-id", når du angiver et navn eller id for arbejdsområdet.

Løsning:

  1. Kør list_workspaces for at hente det korrekte arbejdsområde-id.
  2. Brug arbejdsområde-id'et (UUID-format) i efterfølgende handlinger.

Godkendelse mislykkedes (401 eller 403 fejl)

Problem: Handlingerne mislykkes med godkendelsesfejl.

Løsning til VS Code:

  1. Tryk på Ctrl+Skift+P , og vælg MCP: Fjern server, vælg stof.
  2. Tryk på Ctrl+Skift+P, og vælg MCP: Tilføj Server>HTTP.
  3. Angiv https://api.fabric.microsoft.com/v1/mcp/core og fuldfør browsergodkendelse.

Løsning til Claude Desktop og andre klienter:

  1. Opret et nyt adgangstoken:

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

  2. Opdater klientkonfigurationen med det nye token.

Timeout for langvarig handling

Problem: Handlingen vises som timeout eller fuldføres ikke.

Løsning: Brug handlingsværktøjerne til at overvåge asynkrone handlinger:

  1. Bemærk den operation-id returnerede fra den indledende handling.
  2. Kontrollér status: "Kontrollér status for handlingen {operation-id}"
  3. Når status er "Lykkedes", skal du hente resultatet: "Hent resultatet af handlingen {operation-id}"

Forbindelsesoplysninger

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

Relateret indhold

  • Last updated on