Freigeben über


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, Beschreiben von Tabellenschemas und Auflisten von Tabellen. 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 dem 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.

Tipp

Wenn Sie Microsoft Copilot Studio verwenden, können Sie den MCP-Onboarding-Assistenten verwenden, um Ihren Agent mit Dataverse MCP-Servern in mehreren Umgebungen zu verbinden. Der Assistent führt Sie durch die Einrichtung der Serverkonfiguration und der Authentifizierung. Weitere Informationen: Verbinden Des Agents mit einem vorhandenen MCP-Server

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.

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

Das Suchtool ist nur verfügbar, wenn die Dataverse-Suche für Ihre Umgebung aktiviert ist. Wenn die Dataverse-Suche nicht aktiviert ist, wird das Suchtool 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, während der /api/mcp_preview-Endpunkt zusätzliche Vorschautools enthält, 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:

Betriebssystem Speicherort der Protokolldatei
Windows C:\Users\<username>\AppData\Local\Temp\
Linux /tmp/
macOS Das Verzeichnis, das durch die Umgebungsvariable angegeben wird, typischerweise $TMPDIR, ist /var/folders/.../T/. Führen Sie die Ausführung echo $TMPDIR in einem Terminal aus, um den genauen Pfad zu finden.

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