Herstellen einer Verbindung zu Dataverse: FAQ zum Modellkontextprotokoll

Dieser Artikel enthält Antworten auf häufig gestellte Fragen zur Verwendung von Microsoft Dataverse mit einem MCP-Server (Model Context Protocol).

Ich kann mich nicht authentifizieren. Was ist das Problem?

Stellen Sie sicher, dass die Dataverse-Umgebungs-URL in Ihrer MCP-Clientkonfiguration korrekt ist. Wechseln Sie zu Power Apps, wählen Sie die richtige Umgebung aus, und wählen Sie dann > (Zahnradsymbol) aus, um Ihre Instanz-URL zu bestätigen.

Stellen Sie außerdem sicher, dass der verwendete MCP-Client im Power Platform Admin Center aktiviert ist. Weitere Informationen: Konfigurieren und Verwalten des Dataverse MCP-Servers für eine Umgebung

Welche MCP-Tools sind verfügbar und was tun sie?

Der Dataverse MCP-Server stellt Tools für allgemeine Datenvorgänge bereit, z. B. Abfragen von Datensätzen, Erstellen und Aktualisieren von Zeilen und Beschreiben von Tabellenschemas. Die vollständige Liste der Tools und Beschreibungen finden Sie unter Verbindung zu Dataverse mit dem Modellkontextprotokoll herstellen.

Kann ich einschränken, auf welche Tabellen oder Datensätze über den MCP-Server zugegriffen werden kann?

Ja. Der Dataverse MCP-Server berücksichtigt die Sicherheitsrollen und die Sicherheit auf Zeilenebene von Dataverse. Benutzer können nur auf Tabellen und Datensätze zugreifen, die ihre Sicherheitsrolle zulässt. Über die standardmäßige Dataverse-Sicherheitskonfiguration hinaus sind keine zusätzlichen MCP-spezifischen Zugriffssteuerungen erforderlich.

Gibt es Kosten für die Verwendung des Dataverse MCP-Servers?

Ab 15. Dezember 2025 werden Dataverse MCP-Tools in Rechnung gestellt, wenn auf KI-Agents zugegriffen wird, die außerhalb von Microsoft Copilot Studio erstellt wurden. Wenn Sie über qualifizierende Dynamics 365 Premium-Lizenzen oder eine Microsoft 365 Copilot-Benutzerabonnement-Lizenz (USL) verfügen, fallen keine Kosten für den Zugriff auf Dynamics 365-Daten an. Informationen zu Abrechnungssätzen finden Sie unter Connect to Dataverse with Model Context Protocol.

Kann ich den Dataverse MCP-Server mit mehreren Umgebungen verwenden?

Ja. Jede Dataverse-Umgebung kann über eine eigene MCP-Serverkonfiguration verfügen. Sie können eine Verbindung mit mehreren Umgebungen herstellen, indem Sie separate MCP-Servereinträge in Ihrem Client konfigurieren, die jeweils auf eine andere Umgebungs-URL verweisen.

Was sollte ich tun, wenn ein Dataverse MCP-Tool einen Fehler zurückgibt?

Wenn ein Tool einen Fehler zurückgibt, versuchen Sie, die Eingabeaufforderung erneut zu erstellen und erneut zu übermitteln. Verwenden Sie eine spezifischere Sprache, um zu beschreiben, was Sie erreichen möchten. Wenn der Fehler weiterhin besteht, stellen Sie sicher, dass Sie über die entsprechenden Dataverse-Berechtigungen für den Vorgang verfügen, den Sie versuchen.

Was ist mit den describe_table, list_tables und fetch-Tools passiert?

Die Dataverse MCP-Servertooloberfläche wird aktualisiert. Die vorherigen describe_table, list_tablesund fetch Tools werden entfernt, und ihre Funktionalität wird von anderen Tools bereitgestellt:

Das vorherige search Tool, mit dem Dataverse-Daten durchsucht wurden, wurde umbenannt in search_data. Das aktuelle search Tool durchsucht Dataverse-Metadaten, um Agents beim Auffinden relevanter Tabellen und Apps zu unterstützen.

Wenn Ihr MCP-Client Zulassungs- oder Sperrlisten nach Toolnamen führt, überprüfen und aktualisieren Sie Ihre Konfiguration, sodass die neuen Toolnamen Ihren beabsichtigten Berechtigungen entsprechen.

Die vollständige Liste der Tools finden Sie unter Herstellen einer Verbindung mit Dataverse über Model Context Protocol.

Warum wird das search_data Tool nicht auf dem Dataverse MCP-Server angezeigt?

Das search_data Tool ist nur verfügbar, wenn die Dataverse-Suche für Ihre Umgebung aktiviert ist. Wenn die Dataverse-Suche nicht aktiviert ist, wird das search_data Tool nicht in der Liste der verfügbaren MCP-Tools angezeigt. Um die Dataverse-Suche zu aktivieren, wechseln Sie zur Konfiguration der Dataverse-Suche für Ihre Umgebung.

Warum werden unterschiedliche Tools auf den Endpunkten /api/mcp und /api/mcp_preview angezeigt?

Der /api/mcp Endpunkt stellt die allgemein verfügbaren Dataverse MCP-Tools bereit. Der /api/mcp_preview Endpunkt enthält zusätzliche Vorschautools, die vor der allgemeinen Verfügbarkeit ausgewertet werden. Vorschautools können ohne Ankündigung geändert oder entfernt werden. Um auf die Vorschautools zuzugreifen, muss ein Administrator die Einstellung der Vorschaufeatures im Power Platform Admin Center aktivieren. Weitere Informationen: Verwenden von Vorschautools und bevorstehenden Features auf dem Dataverse MCP-Server

Wie aktiviere ich die Debugprotokollierung für den lokalen Proxy?

Wenn Probleme mit dem lokalen Proxy auftreten (@microsoft/dataverse), können Sie die Debugprotokollierung aktivieren, um eine detaillierte Ausgabe zur Problembehandlung zu erfassen. Fügen Sie dem Proxybefehl die --log-level Argumente und --log-file Argumente hinzu:

npx @microsoft/dataverse mcp https://yourorg.crm.dynamics.com --log-level Debug --log-file

Die Protokolldatei wird in das temporäre Systemverzeichnis geschrieben. Der Standardspeicherort hängt vom Betriebssystem ab:

Sie können die Ausgabeprotokolldatei beim Öffnen eines Supportvorfalls für Microsoft freigeben, um das Problem zu diagnostizieren.