Opret forbindelse til Dataverse med modelkontekstprotokol i ikke-Microsoft-klienter

Du kan oprette forbindelse til Microsoft Dataverse ved hjælp af en MCP-klient (modelkontekstprotokol), der ikke er Microsoft, f.eks. Claude Desktop eller Claude Code. Der er to metoder til at oprette forbindelse mellem ikke-Microsoft-klienter og en Dataverse MCP-server:

• Lokal proxy: Brug @microsoft/dataverse npm-pakken til at køre en lokal proxy, der opretter forbindelse til Dataverse MCP-serveren på dine vegne.
• Fjernslutpunkt: Opret direkte forbindelse til Dataverse MCP-serverens eksterne slutpunkt (/api/mcp) ved at registrere en brugerdefineret Microsoft Entra-app.

Forudsætninger

• Dataverse MCP-serveren skal være aktiveret for miljøet. Flere oplysninger: Konfigurer og administrer Dataverse MCP-serveren for et miljø
• For den lokale proxytilgang: Node.js (version 18 eller nyere) installeret på computeren.
• For tilgangen til fjernslutpunktet: Adgang til at registrere et program i Microsoft Entra-id.

Opret forbindelse ved hjælp af den lokale proxy

NPM-pakken @microsoft/dataverse indeholder en lokal proxy, der håndterer godkendelse og kommunikation med Dataverse MCP-serveren. Denne fremgangsmåde anbefales til de fleste mcp-klienter, der ikke er Microsoft, og som kan køre lokale MCP-servere.

Tildel lejeradministratorsamtykke

En lejeradministrator skal give administratorsamtykke til CLI-appen Dataverse, før brugerne kan godkende. Gå til følgende URL-adresse i en browser, hvor du erstatter {your-tenant-id} med dit Microsoft Entra-lejer-id:

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

Log på med en lejeradministratorkonto, og acceptér prompten om tilladelser. Dette trin skal kun fuldføres én gang pr. lejer.

Aktivér Dataverse CLI-klienten i Power Platform Administration

Før du kan oprette forbindelse ved hjælp af den lokale proxy, skal Dataverse CLI-klienten være aktiveret som en tilladt MCP-klient i dit miljø.

1. Gå til Power Platform Administration. Vælg Administrer>miljøer.
2. Vælg det miljø, hvor du vil aktivere klienten, og vælg derefter Indstillinger.
3. Under Indstillinger skal du vælge Produktfunktioner>. Rul ned for at finde Kontekstprotokol for dataversemodel , og vælg Avancerede indstillinger.
4. Find Dataverse CLI-klienten (app-id 0c412cc3-0dd6-449b-987f-05b053db9457), og angiv Er aktiveret til Ja.
5. Vælg Gem og luk.

Installér den lokale proxy

Du kan installere pakken @microsoft/dataverse globalt eller køre den direkte med npx.

Hvis du vil installere globalt, skal du køre følgende kommando i en terminal:

npm install -g @microsoft/dataverse

Du kan også bruge npx til at køre proxyen uden at installere den globalt:

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

Konfigurer den lokale proxy i Claude Desktop

I dette afsnit beskrives det, hvordan du konfigurerer dataverse MCP-serverens lokale proxy i Claude Desktop. Hvis du ikke allerede har gjort det, skal du downloade og installere Claude Desktop.

1. Åbn Claude Desktop, og gå til Filindstillinger>>Udvikler.

2. Vælg Rediger konfiguration for at åbne claude_desktop_config.json filen.

3. Føj følgende JSON-kodestykke til filen. Erstat <friendly name> med et navn, du nemt kan huske (f.eks . MyDataverseMCPServer), og erstat <your org URL> med URL-adressen til dit Dataverse-miljø (f.eks. https://contoso.crm.dynamics.com).

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

4. Gem filen.

Kontrollér forbindelsen i Claude Desktop

1. Afslut Claude Desktop ved at vælgeFilafslutning>, og åbn den derefter igen for at anvende ændringerne.
2. Log på med dine legitimationsoplysninger, når du bliver bedt om at godkende i dit Dataverse-miljø.
3. Vælg Søg og værktøjer for at kontrollere, at Dataverse MCP-serveren og dens værktøjer er tilgængelige. Du bør kunne se det fulde navn, du har konfigureret (f.eks . MyDataverseMCPServer).
4. Vælg navnet på MCP-serveren for at få vist listen over værktøjer, der understøttes af serveren.

Konfigurer den lokale proxy i Claude Code

I dette afsnit beskrives det, hvordan du konfigurerer den lokale Dataverse MCP-serverproxy i Claude Code. Hvis du ikke allerede har gjort det, skal du downloade og installere Claude Code.

Kør følgende kommando for at tilføje Dataverse MCP-serveren. Erstat https://yourorg.crm.dynamics.com med URL-adressen til dit Dataverse-miljø.

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

Bekræft og interager med forbindelsen i Claude Code

1. Genstart Claude Code for at anvende ændringerne.
2. Log på med dine legitimationsoplysninger, når du bliver bedt om at godkende i dit Dataverse-miljø.
3. Kontrollér, at Dataverse MCP-serveren og dens værktøjer er tilgængelige. Du bør kunne se det fulde navn, du har konfigureret (f.eks . MyDataverseMCPServer).
4. Vælg navnet på MCP-serveren for at få vist listen over værktøjer, der understøttes af serveren.

Hvis du har data i Dataverse-miljøet, kan du teste konfigurationen ved at spørge listetabeller i Dataverse, beskrive tabelkontoen, eller hvor mange konti jeg har. Flere oplysninger: Tilføjelse og fjernelse af eksempeldata

Opret forbindelse ved hjælp af fjernslutpunktet

Du kan oprette forbindelse fra ikke-Microsoft MCP-klienter direkte til dataverse MCP-serverens eksterne slutpunkt uden at bruge en lokal proxy. Denne fremgangsmåde kræver, at du registrerer et brugerdefineret program i Microsoft Entra ID og føjer dets klient-id til listen over tilladte klienter i Power Platform Administration.

Registrer en brugerdefineret Microsoft Entra-app

Registrer et program i Microsoft Entra ID, der skal bruges til godkendelse, når der oprettes forbindelse til Dataverse MCP-serveren. Du kan få generelle oplysninger om appregistrering ved at gå til Registrer et program med Microsoft-identitetsplatformen.

Følg disse trin for at registrere en app til brug sammen med Dataverse MCP-serveren:

1. Log på Microsoft Entra-administrationscenter.
2. Gå til Registreringer>>, og vælg derefter Ny registrering.
3. Angiv et navn til dit program (f.eks . Dataverse MCP Client), konfigurer de understøttede kontotyper for dit scenarie, og vælg derefter Registrer.
4. Bemærk program-id'et (klient)på siden Oversigt. Du skal bruge denne værdi for at konfigurere den tilladte klient i Power Platform Administration og for at konfigurere din MCP-klient.

Konfigurer API-tilladelser for Dataverse MCP-serveren

Når du har registreret appen, skal du give den tilladelser til at få adgang til Dataverse MCP-serveren.

1. I appregistreringen skal du vælge API-tilladelser i venstre navigationsrude.
2. Vælg Tilføj en tilladelse.
3. Vælg Microsoft API'er, og vælg derefter Dynamics CRM.
4. Vælg tilladelsen mcp.tools , og vælg derefter Tilføj tilladelser.

Føj den brugerdefinerede app til listen over tilladte klienter

Når du har registreret Entra-appen, skal du føje klient-id'et til listen over tilladte MCP-klienter for dit miljø.

1. Gå til Power Platform Administration. Vælg Administrer>miljøer.
2. Vælg det miljø, hvor du vil tillade klienten, og vælg derefter Indstillinger.
3. Under Indstillinger skal du vælge Produktfunktioner>. Rul ned for at finde Kontekstprotokol for dataversemodel , og vælg Avancerede indstillinger.
4. Tilføj en ny klientpost. Angiv et navn til klienten, og angiv program-id'et (klient) fra registreringen af din Entra-app.
5. Angiv er aktiveret til Ja.
6. Vælg Gem og luk.

Opret forbindelse til fjernslutpunktet

Konfigurer din MCP-klient for at oprette forbindelse til Dataverse MCP-serveren på følgende URL-adresse:

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

For eksempel: https://contoso.crm.dynamics.com/api/mcp

Brug program-id'et (klient) fra registreringen af din Entra-app til godkendelse. Se din MCP-klients dokumentation for at få specifikke konfigurationstrin.

Relaterede artikler

Opret forbindelse til Dataverse med modelkontekstprotokol