Vanliga frågor och svar om att ansluta till Dataverse med modellkontextprotokoll

Den här artikeln innehåller svar på vanliga frågor om hur du använder Microsoft Dataverse med en MCP-server (Model Context Protocol).

Jag kan inte autentisera. Vad är problemet?

Kontrollera att URL:en för Dataverse-miljön i MCP-klientkonfigurationen är korrekt. Gå till Power Apps, välj rätt miljö och välj sedan Inställningar (kugghjulsikon) >Sessionsinformation för att bekräfta din instans-URL.

Kontrollera också att MCP-klienten som du använder är aktiverad i administrationscentret för Power Platform. Mer information: Konfigurera och hantera Dataverse MCP-servern för en miljö

Vilka MCP-verktyg är tillgängliga och vad gör de?

Dataverse MCP-servern innehåller verktyg för vanliga dataåtgärder som att fråga efter poster, skapa och uppdatera rader och beskriva tabellscheman. Den fullständiga listan över verktyg och beskrivningar finns i Ansluta till dataversum med Model Context Protocol.

Kan jag begränsa vilka tabeller eller poster som är tillgängliga via MCP-servern?

Ja. Dataverse MCP-servern respekterar Dataverse-säkerhetsroller och säkerhet på radnivå. Användare kan bara komma åt tabeller och poster som deras säkerhetsroll tillåter. Inga ytterligare MCP-specifika åtkomstkontroller behövs utöver standardsäkerhetskonfigurationen för Dataverse.

Finns det kostnader för att använda Dataverse MCP-servern?

Från och med den 15 december 2025 debiteras Dataverse MCP-verktyg när de används av AI-agenter som skapats utanför Microsoft Copilot Studio. Om du har kvalificerande Dynamics 365 Premium-licenser eller en Microsoft 365 Copilot-användarprenumerationslicens (USL) debiteras du inte för åtkomst till Dynamics 365-data. Information om faktureringspriser finns i Anslut till dataversum med Model Context Protocol.

Kan jag använda Dataverse MCP-servern med flera miljöer?

Ja. Varje Dataverse-miljö kan ha en egen MCP-serverkonfiguration. Du kan ansluta till flera miljöer genom att konfigurera separata MCP-serverposter i klienten, var och en pekar på en annan miljö-URL.

Tips/Råd

Om du använder Microsoft Copilot Studio kan du använda registreringsguiden för MCP för att ansluta din agent till Dataverse MCP-servrar i flera miljöer. Guiden vägleder dig genom konfiguration och autentisering av servrar. Mer information: Ansluta din agent till en befintlig MCP-server

Vad ska jag göra om ett Dataverse MCP-verktyg returnerar ett fel?

Om ett verktyg returnerar ett fel kan du försöka omformulera prompten och skicka den igen. Använd ett mer specifikt språk för att beskriva vad du vill åstadkomma. Om felet kvarstår kontrollerar du att du har rätt Dataverse-behörigheter för den åtgärd som du försöker utföra.

Vad hände med verktygen describe_table, list_tablesoch fetch ?

Dataverse MCP-serververktygets yta uppdateras. De tidigare describe_tableverktygen , list_tablesoch fetch tas bort och deras funktioner tillhandahålls av andra verktyg:

Verktyget har tagits bort Replacement
describe_table describe
list_tables describe
fetch describe

Det tidigare search verktyget som sökte efter Dataverse-data bytte namn till search_data. Det aktuella search verktyget söker igenom Dataverse-metadata för att hjälpa agenter att hitta relevanta tabeller och appar.

Om MCP-klienten underhåller tillåt eller neka listor efter verktygsnamn granskar och uppdaterar du konfigurationen så att de nya verktygsnamnen återspeglar dina avsedda behörigheter.

Den fullständiga listan över verktyg finns i Ansluta till dataversum med Model Context Protocol.

Varför ser search_data jag inte verktyget på Dataverse MCP-servern?

Verktyget search_data är bara tillgängligt när Dataverse-sökning är aktiverat för din miljö. Om Dataverse-sökning inte är aktiverat search_data visas inte verktyget i listan över tillgängliga MCP-verktyg. Om du vill aktivera Dataverse-sökning går du till Konfigurera Dataverse-sökning för din miljö.

Varför ser jag olika verktyg på slutpunkterna /api/mcp och /api/mcp_preview?

Slutpunkten /api/mcp tillhandahåller den allmänt tillgängliga uppsättningen Dataverse MCP-verktyg. Slutpunkten /api/mcp_preview innehåller ytterligare förhandsgranskningsverktyg som utvärderas före allmän tillgänglighet. Förhandsgranskningsverktyg kan ändras eller tas bort utan föregående meddelande. För att få åtkomst till förhandsgranskningsverktygen måste en administratör aktivera inställningen för förhandsversionsfunktioner i administrationscentret för Power Platform. Mer information: Använda förhandsgranskningsverktyg och kommande funktioner i Dataverse MCP-server

Hur aktiverar jag felsökningsloggning för den lokala proxyn?

Om du har problem med den lokala proxyn (@microsoft/dataverse) kan du aktivera felsökningsloggning för att samla in detaljerade utdata för felsökning. Lägg till argumenten --log-level och --log-file i proxykommandot:

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

Loggfilen skrivs till systemets temporära katalog. Standardplatsen beror på operativsystemet:

Operativsystem Loggfilens sökväg
Windows C:\Users\<username>\AppData\Local\Temp\
Linux /tmp/
macOS Katalogen som anges av $TMPDIR miljövariabeln, vanligtvis /var/folders/.../T/. Kör echo $TMPDIR i en terminal för att hitta den exakta sökvägen.

Du kan dela utdataloggfilen med Microsoft när du öppnar en supportincident för att diagnostisera problemet.