MCP Dataverse

Der vollständigste MCP-Server für Microsoft Dataverse.

79 Tools · 4 Ressourcen · 10 geführte Workflows · Drei Authentifizierungsmodi

npm npm downloads Node 20+ TypeScript License: MIT

Warum MCP Dataverse?

KI-Agenten halluzinieren Schemata, raten Spaltennamen und erstellen fehlerhafte OData-Abfragen. Dieser Server bietet ihnen Echtzeitzugriff auf Ihre Dataverse-Umgebung – Schema, Datensätze, Metadaten, Lösungen – über das Model Context Protocol.

Drei Authentifizierungsmodi – Gerätecode (lokal), Client-Anmeldeinformationen (CI/CD), verwaltete Identität (Azure-gehostet)
Funktioniert mit jedem MCP-Client – VS Code, Claude, Cursor, Windsurf, Gemini, Codex CLI
Atomare Tools – jedes Tool erledigt eine Aufgabe gut; die KI wählt das richtige aus
Strukturierte Ausgaben – jede Antwort liefert {summary, data, suggestions}
Leitplanken – destruktive Vorgänge erfordern eine explizite Bestätigung
Verschlüsselte Token – AES-256-GCM zwischengespeicherte Anmeldeinformationen, werden niemals protokolliert

Installation

npx mcp-dataverse install

Der interaktive Assistent konfiguriert Ihre Umgebung, registriert den Server in VS Code und authentifiziert Ihr Microsoft-Konto in unter 2 Minuten.

Erfordert Node.js 20+. Für andere Clients (Claude, Cursor, Windsurf…) siehe Multi-Client-Einrichtung.

Authentifizierung

Drei Modi – wählen Sie basierend darauf, wo der Server ausgeführt wird:

Modus	Wann zu verwenden
Gerätecode (Standard)	Lokale Entwicklung – interaktive Microsoft-Anmeldung, Token auf Festplatte zwischengespeichert
Client-Anmeldeinformationen	Unbeaufsichtigt: CI/CD, Docker, Azure-Dienste – `authMethod: "client-credentials"` + App-Registrierung
Verwaltete Identität	Azure-gehostet (App Service, Container Apps) – keine Geheimnisse, `authMethod: "managed-identity"`

Schnellstart für Gerätecode: Die Authentifizierung wird beim ersten Tool-Aufruf ausgelöst.

Öffnen Sie View → Output → MCP – ein Anmeldecode erscheint
Gehen Sie zu https://microsoft.com/devicelogin, geben Sie den Code ein und melden Sie sich mit Ihrem Arbeitskonto an
Das Token wird verschlüsselt zwischengespeichert – alle zukünftigen Starts erfolgen lautlos

Für die Einrichtung von Client-Anmeldeinformationen und verwalteter Identität siehe Authentifizierungs-Dokumentation.

Funktionen

Kategorie	Anzahl	Beschreibung
Metadaten	9	Tabellen, Schema, Beziehungen, Optionssätze, Entitätsschlüssel
Abfrage	3	OData, FetchXML, paginierter Abruf
CRUD	6	Abrufen, erstellen, aktualisieren, löschen, upsert, zuweisen
Beziehungen	4	Verknüpfen, Massenverknüpfung, Verknüpfung aufheben, Verknüpfungen abfragen
Aktionen & Funktionen	6	Gebundene/ungebundene Dataverse-Aktionen und -Funktionen
Batch	1	Bis zu 1000 Vorgänge atomar
Lösungen	2	Anpassungen veröffentlichen, Sitemap erstellen
Suche	1	Volltext-Relevanzsuche
Benutzer & Teams	4	Benutzer, Rollen, Teams, Rollenzuweisung
RBAC	7	Rollenberechtigungen: auflisten, zuweisen, entfernen, hinzufügen, ersetzen, abrufen, Team
Dateien	2	Datei- und Bildspalten hochladen/herunterladen
Audit & Trace	3	Audit-Protokoll, Plugin-Trace-Protokolle, Workflow-Trace-Protokolle
Anmerkungen	2	Notizen und Dateianhänge
Anpassung	4	Benutzerdefinierte Aktionen, Plugins, Umgebungsvariablen, Verbindungsreferenzen
Attribute	4	Spalten erstellen, aktualisieren, löschen; Spaltentyp nachschlagen
Schema (Schreiben)	2	Benutzerdefinierte Tabellen und Beziehungen erstellen
Datensatzzugriff	4	Datensatzfreigabe prüfen, gewähren, widerrufen; Datensätze zusammenführen
Unterstützung	2	Tool-Router, Tool-Tags
+ mehr	…	Delta-Synchronisierung, Identitätswechsel, Ansichten, Geschäftsbereiche, Duplikaterkennung

→ Vollständige Referenz der Funktionen

HTTP-Transport

Ausführung als HTTP-Server für die Nutzung durch mehrere Clients:

MCP_TRANSPORT=http MCP_HTTP_PORT=3000 MCP_HTTP_SECRET=mysecret node dist/server.js

Verbindung herstellen mit VS Code / Copilot über:

{
  "servers": {
    "dataverse": {
      "type": "http",
      "url": "http://localhost:3000/mcp",
      "headers": {
        "Authorization": "Bearer mysecret"
      }
    }
  }
}

Fehlerbehebung

Symptom	Lösung
Keine Anmeldeaufforderung	Öffnen Sie View → Output → MCP – der Gerätecode wird dort angezeigt
`No MSAL accounts found`	Führen Sie `npx mcp-dataverse-auth` aus und starten Sie den Server neu
`Authentication timed out`	Starten Sie den MCP-Server neu – ein neuer Code wird automatisch generiert
Server erscheint nicht im Agent-Modus	Führen Sie `npx mcp-dataverse install` oder `npx mcp-dataverse doctor` aus
HTTP-Fehler	Führen Sie `npx mcp-dataverse doctor` aus, um Konfiguration und Konnektivität zu diagnostizieren

Leistungstipp

MCP Dataverse ist so konzipiert, dass es umfassend ist, aber die meisten KI-Modelle arbeiten am besten mit weniger Tools im Kontext. Deaktivieren Sie die Tools, die Sie nicht benötigen, in der Tool-Auswahl Ihres Clients (z. B. VS Code Chat-Panel), um den Agenten fokussiert und reaktionsschnell zu halten.

Roadmap

Version	Funktion	Status
v0.4	HTTP-Transport + Attributverwaltung + Schema-Konsistenz	✅ Veröffentlicht
v0.5	Unternehmens-Authentifizierung (Client-Anmeldeinformationen, verwaltete Identität, Entra JWT)	✅ Veröffentlicht
v0.6	MCP-Prompts (5 Vorlagen) + MCP-Ressourcen (4)	✅ Veröffentlicht
v0.7	Schema-Schreiben (Tabelle/Beziehung erstellen) + Datensatzzugriff (teilen, zusammenführen)	✅ Veröffentlicht (v0.7.5)

→ Vollständige Roadmap

MCP Dataverse

MCP Dataverse

Warum MCP Dataverse?

Installation

Authentifizierung

Funktionen

HTTP-Transport

Fehlerbehebung

Leistungstipp

Roadmap

Lizenz

Resources

Latest Blog Posts

MCP directory API