Naslaginformatie over Fabric Core MCP Server-hulpprogramma's

Fabric Core MCP Server biedt hulpprogramma's die AI-agents gebruiken om te communiceren met Microsoft Fabric. Elk hulpprogramma wordt toegewezen aan een Fabric REST API-bewerking en bevat invoervalidatie en foutafhandeling.

Opmerking

Fabric Core MCP Server is momenteel in preview. Beschikbare hulpprogramma's en hun mogelijkheden kunnen veranderen vóór algemene beschikbaarheid.

Beschikbare hulpmiddelen

Tool Beschrijving
search_catalog Zoek in de OneLake-catalogus naar items in werkruimten. Het hulpprogramma roept de Cataloguszoekopdrachten-API aan.
list_workspaces Alle werkruimten weergeven die u toegang hebt
get_workspace Gedetailleerde informatie over een specifieke werkruimte ophalen
create_workspace Een nieuwe werkruimte maken in uw Fabric-tenant
update_workspace De naam of beschrijving van een werkruimte bijwerken
delete_workspace Een bestaande werkruimte verwijderen
add_workspace_role Een gebruiker toegang verlenen tot een werkruimte
list_workspace_roles Alle roltoewijzingen voor een werkruimte weergeven
get_workspace_role Meer informatie over een specifieke roltoewijzing
update_workspace_role De rol van een gebruiker in een werkruimte wijzigen
delete_workspace_role De toegang van een gebruiker tot een werkruimte verwijderen
list_items Alle items in een werkruimte weergeven
get_item Gedetailleerde informatie over een specifiek item ophalen
create_item Een nieuw item maken in een werkruimte
update_item De naam of beschrijving van een item bijwerken
delete_item Een item uit een werkruimte verwijderen
get_item_definition Het schema of de definitie van een item ophalen
update_item_definition De definitie of het schema van een item bijwerken
bulk_move_items Meerdere items naar een map verplaatsen
create_folder Een nieuwe map maken in een werkruimte
list_folders Alle mappen in een werkruimte weergeven
get_folder Details over een specifieke map ophalen
update_folder De naam van een map wijzigen
delete_folder Een lege map verwijderen
move_folder Een map verplaatsen naar een nieuwe bovenliggende map
list_capacities Geef alle Fabric capaciteiten weer waar u toegang toe hebt
get_operation_state De status van een langdurige bewerking controleren
get_operation_result Het resultaat van een voltooide bewerking ophalen
get_knowledge Richtlijnen en aanbevolen procedures voor itemtypen ophalen

Werkruimterollen

Fabric werkruimten ondersteunen vier rolniveaus:

Rol toestemmingen
admin Volledig beheer, inclusief werkruimte-instellingen, roltoewijzingen en verwijdering
Lid Items maken, bewerken en verwijderen; kan werkruimte-instellingen of -rollen niet beheren
Contributor Items maken en bewerken; items kunnen niet worden verwijderd
Kijker Alleen-lezentoegang tot werkruimte en items

Belangrijke opmerkingen

  • U moet machtigingen hebben om werkruimten te maken in uw Fabric-tenant. Sommige organisaties beperken het maken van werkruimten tot specifieke rollen.
  • Als u een werkruimte verwijdert, worden alle items daarin definitief verwijderd. Deze bewerking kan niet ongedaan worden gemaakt.
  • Mappen moeten leeg zijn voordat ze worden verwijderd. Verplaats of verwijder eerst alle items in de map.
  • Voeg Microsoft Graph MCP Server toe om e-mailadressen automatisch op te lossen. Zonder dit moet u principal-id's voor gebruikers opgeven voor rolbewerkingen.

Voorbeeldwerkstromen

Werkstroom 1: Uw omgeving verkennen

Ontdek tot welke resources u toegang hebt in Fabric.

Gevraagd:

  1. 'Alle Fabric werkruimten weergeven'
  2. 'Alle items weergeven in de werkruimte Sales Analytics'
  3. "Welke lakehouses bestaan er in Sales Analytics?"
  4. "Haal de definitie van de CustomerData lakehouse op"

Werkstroom 2: Een ontwikkelomgeving maken

Stel een volledige ontwikkelwerkruimte in met resources en teamtoegang.

Gevraagd:

  1. 'Maak een werkruimte met de naam Sales Analytics Dev'
  2. "Maak een lakehouse met de naam CustomerData_Dev in Sales Analytics Dev"
  3. "Toevoegen john@contoso.com als inzender aan Sales Analytics Dev"
  4. "Toevoegen sarah@contoso.com als lid aan Sales Analytics Dev"

Aanbeveling

Deze werkstroom vereist Microsoft Graph MCP om e-mailadressen op te lossen. Zonder Graph MCP geeft u principal-id's van gebruikers op in plaats van e-mailberichten.

Werkstroom 3: Machtigingen controleren en beheren

Toegangsbeheer voor werkruimten controleren en bijwerken.

Gevraagd:

  1. "Alle roltoewijzingen voor de werkruimte Financiën weergeven"
  2. Wie heeft beheerderstoegang tot Financiën?
  3. "Wijzigen john@contoso.com van Kijker in Inzender in Financiën"
  4. "Verwijderen contractor@contoso.com uit de werkruimte Financiën"

Troubleshooting

Ongeldige werkruimte-id-fout

Probleem: In het foutbericht wordt 'Ongeldige werkruimte-id' weergegeven wanneer u een werkruimtenaam of -id opgeeft.

Solution:

  1. Voer deze opdracht uit list_workspaces om de juiste werkruimte-id op te halen.
  2. Gebruik de werkruimte-id (UUID-indeling) in volgende bewerkingen.

Verificatie is mislukt (401- of 403-fouten)

Probleem: Bewerkingen mislukken met autorisatiefouten.

Oplossing voor VS Code:

  1. Druk op Ctrl+Shift+P en selecteer MCP: Server verwijderen, fabric kiezen.
  2. Druk op Ctrl+Shift+P en selecteer MCP:> toevoegen.
  3. Voer browserverificatie in https://api.fabric.microsoft.com/v1/mcp/core en voltooi deze.

Oplossing voor Claude Desktop en andere klanten:

  1. Een nieuw toegangstoken genereren:

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

  2. Werk de clientconfiguratie bij met het nieuwe token.

Time-out voor langdurige bewerking

Probleem: Er wordt een time-out van de bewerking weergegeven of de bewerking is niet voltooid.

Oplossing: Gebruik de hulpprogramma's voor bewerkingen om asynchrone bewerkingen te bewaken:

  1. Noteer het operation-id resultaat van de initiële bewerking.
  2. Status controleren: 'Controleer de status van bewerking {operation-id}'
  3. Zodra de status Geslaagd is, haalt u het resultaat op: 'Het resultaat van de bewerking {operation-id} ophalen'

Verbindingsdetails

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

Verwante inhoud

  • Last updated on