Herstellen einer Verbindung zu Dataverse über das Modellkontextprotokoll in nicht von Microsoft stammenden Clients.

Sie können eine Verbindung mit Microsoft Dataverse über einen McP-Client (Non-Microsoft Model Context Protocol) herstellen, z. B. Claude Desktop oder Claude Code. Es gibt zwei Ansätze zum Verbinden von Nicht-Microsoft-Clients mit einem Dataverse MCP-Server:

• Lokaler Proxy: Verwenden Sie das @microsoft/dataverse npm-Paket, um einen lokalen Proxy auszuführen, der eine Verbindung mit dem Dataverse MCP-Server in Ihrem Auftrag herstellt.
• Remoteendpunkt: Stellen Sie eine direkte Verbindung mit dem Dataverse MCP-Server-Remoteendpunkt (/api/mcp) her, indem Sie eine benutzerdefinierte Microsoft Entra-App registrieren.

Voraussetzungen

• Der Dataverse MCP-Server muss für die Umgebung aktiviert sein. Weitere Informationen: Konfigurieren und Verwalten des Dataverse MCP-Servers für eine Umgebung
• Für den lokalen Proxyansatz: Node.js (Version 18 oder höher) auf Ihrem Computer installiert.
• Für den Ansatz mit Remote-Endpunkt: Zugriff, um eine Anwendung in Microsoft Entra ID zu registrieren.

Verbinden mit dem lokalen Proxy

Das @microsoft/dataverse npm-Paket stellt einen lokalen Proxy bereit, der die Authentifizierung und Kommunikation mit dem Dataverse MCP-Server verarbeitet. Dieser Ansatz wird für die meisten Nicht-Microsoft MCP-Clients empfohlen, die lokale MCP-Server ausführen können.

Mandantenadministratoreinwilligung erteilen

Ein Mandantenadministrator muss Administratorzustimmung für die Dataverse CLI-App erteilen, bevor Benutzer sich authentifizieren können. Navigieren Sie zu der folgenden URL in einem Browser, und ersetzen Sie {your-tenant-id} durch Ihre Microsoft Entra-Mandanten-ID.

https://login.microsoftonline.com/{your-tenant-id}/adminconsent?client_id=0c412cc3-0dd6-449b-987f-05b053db9457

Melden Sie sich mit einem Mandantenadministratorkonto an, und akzeptieren Sie die Berechtigungsaufforderung. Dieser Schritt muss nur einmal pro Mandant abgeschlossen werden.

Aktivieren des Dataverse CLI-Clients im Power Platform Admin Center

Bevor Sie eine Verbindung mit dem lokalen Proxy herstellen können, muss der Dataverse CLI-Client in Ihrer Umgebung als zulässiger MCP-Client aktiviert sein.

1. Navigieren Sie zum Power Platform Admin Center. Wählen Sie "Umgebungen> aus.
2. Wählen Sie die Umgebung aus, in der Sie den Client aktivieren möchten, und wählen Sie dann "Einstellungen" aus.
3. Wählen Sie unter "Einstellungen" die Option ">" aus. Scrollen Sie nach unten, um das Dataverse-Modellkontextprotokoll zu suchen, und wählen Sie "Erweiterte Einstellungen" aus.
4. Suchen Sie den Dataverse CLI-Client (App-ID 0c412cc3-0dd6-449b-987f-05b053db9457), und legen Sie "Ist aktiviert " auf "Ja" fest.
5. Wählen Sie "Speichern" und "Schließen" aus.

Installieren des lokalen Proxys

Sie können das @microsoft/dataverse-Paket global installieren oder es direkt mit npx ausführen.

Führen Sie zum globalen Installieren den folgenden Befehl in einem Terminal aus:

npm install -g @microsoft/dataverse

Alternativ können Sie npx verwenden, um den Proxy auszuführen, ohne ihn global zu installieren.

npx @microsoft/dataverse mcp https://yourorg.crm.dynamics.com

Konfigurieren des lokalen Proxys in Claude Desktop

In diesem Abschnitt wird beschrieben, wie Sie den lokalen Dataverse MCP-Serverproxy in Claude Desktop konfigurieren. Falls noch nicht geschehen, laden Sie Claude Desktop herunter, und installieren Sie sie.

1. Öffnen Sie Claude Desktop und gehen Sie zu Datei>Einstellungen>Entwickler.

2. Wählen Sie "Konfiguration bearbeiten" aus, um die claude_desktop_config.json Datei zu öffnen.

3. Fügen Sie der Datei den folgenden JSON-Codeausschnitt hinzu. Ersetzen Sie <friendly name> durch einen Namen, den Sie sich leicht merken können (z. B. MyDataverseMCPServer), und ersetzen Sie <your org URL> durch Ihre Dataverse-Umgebungs-URL (z. B. https://contoso.crm.dynamics.com).

   {
     "mcpServers": {
       "<friendly name>": {
         "command": "npx",
         "args": [
           "-y",
           "@microsoft/dataverse",
           "mcp",
           "<your org URL>"
         ]
       }
     }
   }
   

4. Speichern Sie die Datei.

Überprüfen Sie die Verbindung in Claude Desktop

1. Beenden Sie Claude Desktop, indem Sie "Datei>beenden" auswählen und dann erneut öffnen, um die Änderungen anzuwenden.
2. Melden Sie sich mit Ihren Anmeldeinformationen an, wenn Sie aufgefordert werden, sich bei Ihrer Dataverse-Umgebung zu authentifizieren.
3. Wählen Sie "Suchen" und "Tools " aus, um zu überprüfen, ob der Dataverse MCP-Server und seine Tools verfügbar sind. Der von Ihnen konfigurierte Anzeigename (z. B. MyDataverseMCPServer) sollte angezeigt werden.
4. Wählen Sie den MCP-Servernamen aus, um die Liste der Tools anzuzeigen, die vom Server unterstützt werden.

Konfigurieren des lokalen Proxys in Claude Code

In diesem Abschnitt wird beschrieben, wie Sie den lokalen Dataverse MCP-Serverproxy in Claude Code konfigurieren. Falls noch nicht geschehen, laden Sie Claude Code herunter, und installieren Sie sie.

Führen Sie den folgenden Befehl aus, um den Dataverse MCP-Server hinzuzufügen. Ersetzen Sie https://yourorg.crm.dynamics.com durch die URL Ihrer Dataverse-Umgebung.

claude mcp add dataverse -t stdio -- npx -y @microsoft/dataverse mcp https://yourorg.crm.dynamics.com

Überprüfen und Interagieren mit der Verbindung in Claude Code

1. Starten Sie Claude Code neu, um die Änderungen anzuwenden.
2. Melden Sie sich mit Ihren Anmeldeinformationen an, wenn Sie aufgefordert werden, sich bei Ihrer Dataverse-Umgebung zu authentifizieren.
3. Stellen Sie sicher, dass der Dataverse MCP-Server und seine Tools verfügbar sind. Der von Ihnen konfigurierte Anzeigename (z. B. MyDataverseMCPServer) sollte angezeigt werden.
4. Wählen Sie den MCP-Servernamen aus, um die Liste der Tools anzuzeigen, die vom Server unterstützt werden.

Wenn Sie Daten in der Dataverse-Umgebung haben, können Sie das Setup testen, indem Sie Tabellen in Dataverse auflisten, die Tabelle 'Konto' beschreiben oder wie viele Konten habe ich fragen. Weitere Informationen: Hinzufügen oder Entfernen von Beispieldaten

Verbindung zum Remote-Endpunkt herstellen

Sie können Nicht-Microsoft MCP-Clients direkt mit dem Dataverse MCP-Server-Remoteendpunkt verbinden, ohne einen lokalen Proxy zu verwenden. Bei diesem Ansatz müssen Sie eine benutzerdefinierte Anwendung in der Microsoft Entra-ID registrieren und der Liste der zulässigen Clients im Power Platform Admin Center die Client-ID hinzufügen.

Registrieren einer benutzerdefinierten Microsoft Entra-App

Registrieren Sie eine Anwendung in der Microsoft Entra-ID für die Authentifizierung beim Herstellen einer Verbindung mit dem Dataverse MCP-Server. Allgemeine Informationen zur App-Registrierung finden Sie unter Register an application with the Microsoft identity platform.

Führen Sie die folgenden Schritte aus, um eine App für die Verwendung mit dem Dataverse MCP-Server zu registrieren:

1. Melden Sie sich beim Microsoft Entra Admin Center an.
2. Wechseln Sie zu "Identity>Applications>App-Registrierungen", und wählen Sie dann "Neue Registrierung" aus.
3. Geben Sie einen Namen für Ihre Anwendung ein (z. B. Dataverse MCP-Client), konfigurieren Sie die unterstützten Kontotypen für Ihr Szenario, und wählen Sie dann "Registrieren" aus.
4. Notieren Sie sich auf der Seite "Übersicht" die Anwendungs-ID (Client-ID). Sie benötigen diesen Wert, um den zulässigen Client im Power Platform Admin Center zu konfigurieren und Ihren MCP-Client zu konfigurieren.

Konfigurieren von API-Berechtigungen für den Dataverse MCP-Server

Nachdem Sie die App registriert haben, müssen Sie ihm Berechtigungen für den Zugriff auf den Dataverse MCP-Server erteilen.

1. Wählen Sie in der App-Registrierung API-Berechtigungen im linken Navigationsbereich aus.
2. Wählen Sie "Berechtigung hinzufügen" aus.
3. Wählen Sie Microsoft-APIs und dann Dynamics CRM aus.
4. Wählen Sie die Berechtigung "mcp.tools " und dann " Berechtigungen hinzufügen" aus.

Hinzufügen der benutzerdefinierten App zur Liste der zulässigen Clients

Nachdem Sie die Entra-App registriert haben, fügen Sie die Client-ID der Liste der zulässigen MCP-Clients für Ihre Umgebung hinzu.

1. Navigieren Sie zum Power Platform Admin Center. Wählen Sie "Umgebungen> aus.
2. Wählen Sie die Umgebung aus, in der Sie den Client zulassen möchten, und wählen Sie dann "Einstellungen" aus.
3. Wählen Sie unter "Einstellungen" die Option ">" aus. Scrollen Sie nach unten, um das Dataverse-Modellkontextprotokoll zu suchen, und wählen Sie "Erweiterte Einstellungen" aus.
4. Fügen Sie einen neuen Kundeneintrag hinzu. Geben Sie einen Namen für den Client ein, und geben Sie die Anwendungs-ID (Client) aus Ihrer Entra-App-Registrierung an.
5. Setzen Sie Ist aktiv auf Ja.
6. Wählen Sie "Speichern" und "Schließen" aus.

Herstellen einer Verbindung mit dem Remoteendpunkt

Konfigurieren Sie Ihren MCP-Client so, dass eine Verbindung mit dem Dataverse MCP-Server unter der folgenden URL hergestellt wird:

https://<your org URL>/api/mcp

Beispiel: https://contoso.crm.dynamics.com/api/mcp

Verwenden Sie die Anwendungs-ID (Client-ID) aus Ihrer Entra-App-Registrierung für die Authentifizierung. Spezifische Konfigurationsschritte finden Sie in der Dokumentation Ihres MCP-Clients.

Verwandte Artikel

Herstellen einer Verbindung mit Dataverse mit dem Modellkontextprotokoll