Fabric MCP Server einrichten

Dieser Ratgeber zeigt, wie der Fabric MCP Server (lokal) auf einer Entwicklungsmaschine eingerichtet wird. Der Server läuft als Subprocess und verbindet einen MCP-fähigen KI-Agenten mit Fabric-API-Dokumentation, OneLake-Dateioperationen und Item-Erstellungswerkzeugen.

Voraussetzungen

Vor der Installation folgende Punkte prüfen:
MCP-kompatibler KI-Client (VS Code mit GitHub Copilot Chat empfohlen)
Für npx: Node.js 20 LTS oder neuer (node --version)
Für Build aus Quellcode: .NET 9 SDK (dotnet --version)
Microsoft-Fabric-Zugangsdaten (für OneLake-Operationen und Item-Erstellung)

Option 1: VS-Code-Erweiterung (empfohlen)

Schnellster Einstieg ohne manuelle Konfiguration:
GitHub Copilot Chat Extension in VS Code installieren
Fabric MCP Server Extension aus dem VS Code Marketplace installieren
Die Erweiterung registriert den Server automatisch – keine weitere Konfiguration nötig
In GitHub Copilot auf Agent-Modus wechseln und die Tool-Liste aktualisieren

Option 2: npm/npx (beliebiger MCP-Client)

Folgende Konfiguration in der mcp.json des Clients eintragen:

{
    "mcpServers": {
        "fabric-mcp-server": {
            "command": "npx",
            "args": [
                "-y",
                "@microsoft/fabric-mcp@latest",
                "server",
                "start",
                "--mode",
                "all"
            ]
        }
    }
}

Bei manueller VS-Code-Konfiguration servers statt mcpServers als Stamm-Schlüssel verwenden.

Option 3: Build aus dem Quellcode (.NET)

git clone https://github.com/microsoft/mcp.git
cd mcp
dotnet build servers/Fabric.Mcp.Server/src/Fabric.Mcp.Server.csproj --configuration Release

Anschließend in der mcp.json:

{
    "mcpServers": {
        "Fabric MCP Server": {
            "command": "/pfad/zum/repo/servers/Fabric.Mcp.Server/src/bin/Release/fabmcp",
            "args": ["server", "start"],
            "type": "stdio"
        }
    }
}

Unter Windows: Backslashes und .exe-Erweiterung verwenden.

Installation überprüfen

Nach der Installation in GitHub Copilot auf Agent-Modus wechseln, die Tool-Liste aktualisieren und folgenden Testprompt verwenden:

What Fabric workload types are available?

Gibt der Agent eine Liste von Fabric-Workload-Typen zurück, ist der Server aktiv.

Erste Prompts

Nach erfolgreicher Installation können diese Beispielprompts ausprobiert werden:
„Show me the OpenAPI operations for 'notebook' and give a sample creation body"
„Show me the JSON schema for a Data Pipeline item definition"
„List my Fabric workspaces"
„Download the config.json file from my Sales lakehouse"
„Create a new Lakehouse called CustomerData in my dev workspace"

Sicherheitshinweise

Credentials schützen – Zugriffstoken und lokale Fabric-Credentials niemals als Klartext in Konfigurationsdateien speichern. Kurz gültige Tokens und separate Entwicklungsidentitäten verwenden.

Dateisystemzugriff begrenzen – Den Server nur auf explizit benötigte Verzeichnisse konfigurieren; keine unbeschränkten Pfad-Wildcards verwenden.

Prompt Injection beachten – API-Dokumentation und OneLake-Dateiinhalte können präparierte Steueranweisungen enthalten. Dateiinhalte aus unbekannten Quellen vor der Agentenverarbeitung prüfen.

Entwicklungs-Workspace nutzen – Item-Erstellungsoperationen in separate Entwicklungs-Workspaces isolieren, damit Produktionsdaten nicht versehentlich verändert werden.

Monorepo-Sterne verstehen – Die GitHub-Sterne beziehen sich auf das gesamte microsoft/mcp-Monorepo, nicht isoliert auf den Fabric-Server.

Fehlerbehebung

Server erscheint nicht in der Tool-Liste – In GitHub Copilot auf Agent-Modus wechseln und die Aktualisierungsschaltfläche der Tool-Liste drücken. Falls der Server weiterhin fehlt, VS Code neu starten und die Erweiterung im Extensions-Panel als aktiviert prüfen.

Node.js-Version zu alt – node --version ausführen; das Ergebnis muss v20.x.x oder höher sein. Node.js 20 LTS von der offiziellen Website herunterladen und installieren.

OneLake-Authentifizierungsfehler – Sicherstellen, dass die verwendeten Zugangsdaten ausreichende Fabric-Berechtigungen haben. Für OneLake-Leseoperationen ist mindestens die Viewer-Rolle im Ziel-Workspace erforderlich; für Schreiboperationen Contributor oder höher.

Manuelle VS-Code-Konfiguration schlägt fehl – Prüfen, ob in der mcp.json servers statt mcpServers als Stamm-Schlüssel verwendet wird. Microsoft dokumentiert diesen Unterschied explizit für VS-Code-Konfigurationen.

Tipps für den Entwicklungsalltag

Der Fabric MCP Server (lokal) lässt sich gut mit dem Fabric Core MCP Server (Remote) kombinieren: Den lokalen Server für API-Dokumentation und OneLake-Dateioperationen nutzen, den Remote-Server für Workspace-Management und Permissions. Beide Server können gleichzeitig in der Client-Konfiguration aktiv sein.