Referenz zu Fabric Core MCP Server Tools

Fabric Core MCP Server stellt Tools bereit, die KI-Agents für die Interaktion mit Microsoft Fabric verwenden. Jedes Tool ist einem Fabric REST-API-Vorgang zugeordnet und umfasst Eingabeüberprüfung und Fehlerbehandlung.

Hinweis

Fabric Core MCP Server befindet sich derzeit in der Vorschau. Verfügbare Tools und ihre Funktionen können sich vor der allgemeinen Verfügbarkeit ändern.

Verfügbare Tools

Werkzeug Beschreibung
search_catalog Durchsuchen Sie den OneLake-Katalog nach Elementen in arbeitsbereichsübergreifenden Arbeitsbereichen. Das Tool ruft die Katalogsuch-API auf.
list_workspaces Auflisten aller Arbeitsbereiche, auf die Sie Zugriff haben
get_workspace Abrufen detaillierter Informationen zu einem bestimmten Arbeitsbereich
create_workspace Erstellen eines neuen Arbeitsbereichs in Ihrem Fabric Mandanten
update_workspace Aktualisieren des Namens oder der Beschreibung eines Arbeitsbereichs
delete_workspace Löschen eines vorhandenen Arbeitsbereichs
add_workspace_role Gewähren des Zugriffs eines Benutzers auf einen Arbeitsbereich
list_workspace_roles Auflisten aller Rollenzuweisungen für einen Arbeitsbereich
get_workspace_role Abrufen von Details zu einer bestimmten Rollenzuweisung
update_workspace_role Ändern der Rolle eines Benutzers in einem Arbeitsbereich
delete_workspace_role Entfernen des Zugriffs eines Benutzers auf einen Arbeitsbereich
list_items Auflisten aller Elemente in einem Arbeitsbereich
get_item Abrufen detaillierter Informationen zu einem bestimmten Element
create_item Erstellen eines neuen Elements in einem Arbeitsbereich
update_item Aktualisieren des Namens oder der Beschreibung eines Elements
delete_item Löschen eines Elements aus einem Arbeitsbereich
get_item_definition Abrufen des Schemas oder der Definition eines Elements
update_item_definition Aktualisieren der Definition oder des Schemas eines Elements
bulk_move_items Verschieben mehrerer Elemente in einen Ordner
create_folder Erstellen eines neuen Ordners in einem Arbeitsbereich
list_folders Auflisten aller Ordner in einem Arbeitsbereich
get_folder Abrufen von Details zu einem bestimmten Ordner
update_folder Umbenennen eines Ordners
delete_folder Löschen eines leeren Ordners
move_folder Verschieben eines Ordners in einen neuen übergeordneten Ordner
list_capacities Auflisten aller Fabric Kapazitäten, auf die Sie Zugriff haben
get_operation_state Überprüfen des Status eines lange ausgeführten Vorgangs
get_operation_result Abrufen des Ergebnisses eines abgeschlossenen Vorgangs
get_knowledge Abrufen von Richtlinien und bewährten Methoden für Elementtypen

Rollen im Arbeitsbereich

Fabric Arbeitsbereiche unterstützen vier Rollenebenen:

Rolle Erlaubnisse
Administrator Vollzugriff, einschließlich Arbeitsbereichseinstellungen, Rollenzuweisungen und Löschen
Mitglied Erstellen, Bearbeiten und Löschen von Elementen; Arbeitsbereichseinstellungen oder Rollen können nicht verwaltet werden.
Mitwirkender Erstellen und Bearbeiten von Elementen; Elemente können nicht gelöscht werden
Betrachter Schreibgeschützter Zugriff auf Arbeitsbereiche und Elemente

Wichtige Hinweise

  • Sie müssen über Berechtigungen zum Erstellen von Arbeitsbereichen in Ihrem Fabric Mandanten verfügen. Einige Organisationen beschränken die Arbeitsbereichserstellung auf bestimmte Rollen.
  • Durch das Dauerhafte Löschen eines Arbeitsbereichs werden alle darin enthaltenen Elemente entfernt. Dieser Vorgang kann nicht rückgängig gemacht werden.
  • Ordner müssen vor dem Löschen leer sein. Verschieben oder Löschen aller Elemente innerhalb des Ordners zuerst.
  • Fügen Sie Microsoft Graph MCP Server hinzu, um E-Mail-Adressen automatisch aufzulösen. Ohne dies müssen Sie Benutzerprinzipal-IDs für Rollenvorgänge bereitstellen.

Beispielworkflows

Workflow 1: Erkunden Ihrer Umgebung

Entdecken Sie, auf welche Ressourcen Sie in Fabric zugreifen können.

Fordert:

  1. "Alle meine Fabric Arbeitsbereiche auflisten"
  2. "Alle Elemente im Arbeitsbereich "Sales Analytics" anzeigen
  3. "Welche Seehäuser gibt es in Sales Analytics?"
  4. "Abrufen der Definition des CustomerData Lakehouse"

Workflow 2: Erstellen einer Entwicklungsumgebung

Richten Sie einen vollständigen Entwicklungsarbeitsbereich mit Ressourcen und Teamzugriff ein.

Fordert:

  1. "Erstellen eines Arbeitsbereichs namens Sales Analytics Dev"
  2. "Erstellen eines Lakehouse namens CustomerData_Dev in Sales Analytics Dev"
  3. "Als Mitwirkender zu Sales Analytics Dev hinzufügen john@contoso.com "
  4. "Als Mitglied zu Sales Analytics Dev hinzufügen sarah@contoso.com "

Tipp

Für diesen Workflow ist Microsoft Graph MCP erforderlich, um E-Mail-Adressen aufzulösen. Ohne Graph MCP stellen Sie Anstelle von E-Mails Benutzerprinzipal-IDs bereit.

Workflow 3: Überwachen und Verwalten von Berechtigungen

Überprüfen und Aktualisieren der Arbeitsbereich-Zugriffssteuerung.

Fordert:

  1. "Alle Rollenzuweisungen für den Arbeitsbereich "Finanzen" auflisten
  2. "Wer hat Administratorzugriff auf Finanzen?"
  3. "Von Viewer zu Mitwirkender in Finanzen wechseln john@contoso.com "
  4. "Aus dem Arbeitsbereich "Finanzen" entfernen contractor@contoso.com

Problembehandlung

Fehler bei ungültiger Arbeitsbereichs-ID

Problem: Fehlermeldung gibt "Ungültige Arbeitsbereichs-ID" an, wenn Sie einen Arbeitsbereichsnamen oder eine ID angeben.

Lösung:

  1. Führen Sie die Ausführung aus list_workspaces , um die richtige Arbeitsbereichs-ID abzurufen.
  2. Verwenden Sie die Arbeitsbereichs-ID (UUID-Format) in nachfolgenden Vorgängen.

Fehler bei der Authentifizierung (401- oder 403-Fehler)

Problem: Vorgänge schlagen mit Autorisierungsfehlern fehl.

Lösung für VS-Code:

  1. Drücken Sie STRG+UMSCHALT+P , und wählen Sie MCP aus: Server entfernen, Fabric auswählen.
  2. Drücken Sie STRG+UMSCHALT+P, und wählen Sie MCP aus:> hinzufügen.
  3. Geben Sie die Browserauthentifizierung ein, und schließen Sie https://api.fabric.microsoft.com/v1/mcp/core sie ab.

Lösung für Claude Desktop und andere Clients:

  1. Generieren Eines neuen Zugriffstokens:

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

  2. Aktualisieren Sie Ihre Clientkonfiguration mit dem neuen Token.

Timeout für lange Ausgeführte Vorgänge

Problem: Der Vorgang wird als Timeout angezeigt oder nicht abgeschlossen.

Lösung: Verwenden Sie die Operationstools, um asynchrone Vorgänge zu überwachen:

  1. Notieren Sie sich den operation-id vom ursprünglichen Vorgang zurückgegebenen Vorgang.
  2. Überprüfungsstatus: "Überprüfen des Vorgangsstatus "{operation-id}"
  3. Sobald der Status "Erfolgreich" ist, rufen Sie das Ergebnis ab: "Abrufen des Ergebnisses des Vorgangs {operation-id}"

Verbindungsdetails

  • Endpunkt:https://api.fabric.microsoft.com/v1/mcp/core
  • Auth: OAuth 2.0 über Microsoft Entra ID
  • Umfang:https://api.fabric.microsoft.com/.default

Verwandte Inhalte

  • Last updated on