Connecteu-vos al Dataverse amb el protocol de context de model Preguntes freqüents

En aquest article es proporcionen respostes a les preguntes més freqüents sobre l'ús del Microsoft Dataverse amb un servidor de protocol de context de model (MCP).

No puc autenticar-me. Quin és el problema?

Verifica que l'URL de l'entorn Dataverse a la configuració del client MCP sigui correcta. Ves a Power Apps, selecciona l'entorn correcte i després selecciona Configuració (icona d'engranatge) >Detalls de la sessió per confirmar la URL de la teva instància.

També comprova que el client MCP que estàs utilitzant estigui activat al centre d'administració de Power Platform. Més informació: Configurar i administrar el servidor MCP del Dataverse per a un entorn

Quines eines MCP estan disponibles i què fan?

El servidor MCP de Dataverse proporciona eines per a operacions de dades comunes com consultar registres, crear i actualitzar files, i descriure esquemes de taula. Per a la llista completa d'eines i descripcions, aneu a Connectar a Dataverse amb Model Context Protocol.

Puc restringir quines taules o registres són accessibles a través del servidor MCP?

Sí. El servidor MCP de Dataverse respecta els rols de seguretat de Dataverse i la seguretat a nivell de fila. Els usuaris només poden accedir a taules i registres que el seu paper de seguretat permeti. No es necessiten controls d'accés específics addicionals per a MCP més enllà de la configuració estàndard de seguretat de Dataverse.

Hi ha costos associats a utilitzar el servidor MCP de Dataverse?

A partir del 15 de desembre de 2025, les eines MCP de Dataverse es carreguen quan hi accedeixen agents d'IA creats fora de Microsoft Copilot Studio. Si tens llicències Dynamics 365 Premium qualificades o una Microsoft 365 Copilot User Subscription License (USL), no se't cobra per accedir a les dades de Dynamics 365. Per a informació sobre les tarifes de facturació, aneu a Connectar a Dataverse amb Model Context Protocol.

Puc utilitzar el servidor MCP de Dataverse amb diversos entorns?

Sí. Cada entorn Dataverse pot tenir la seva pròpia configuració de servidor MCP. Pots connectar-te a diversos entorns configurant entrades separades del servidor MCP al teu client, cadascuna apuntant a una URL diferent de l'entorn.

Propina

Si utilitzes Microsoft Copilot Studio, pots utilitzar l'assistent d'incorporació MCP per connectar el teu agent als servidors MCP de Dataverse en diversos entorns. L'assistent et guia durant la configuració del servidor i la configuració de l'autenticació. Més informació: Connecta el teu agent a un servidor MCP existent

Què hauria de fer si una eina MCP de Dataverse retorna un error?

Si una eina retorna un error, prova de reformular el teu prompt i enviar-lo de nou. Utilitza un llenguatge més específic per descriure què vols aconseguir. Si l'error persisteix, verifica que tens els permisos adequats de Dataverse per a l'operació que estàs intentant.

Què va passar amb les describe_table, list_tables, i fetch les eines?

La superfície de l'eina servidor MCP de Dataverse s'actualitza. Les eines anteriors describe_table, list_tables, i fetch s'eliminen i la seva funcionalitat és proporcionada per altres eines:

Eina eliminada	Substitució
describe_table	describe
list_tables	describe
fetch	describe

L'eina anterior search que cercava dades de Dataverse va ser rebatejada com search_dataa . L'eina actual search cerca metadades de Dataverse per ajudar els agents a trobar taules i aplicacions rellevants.

Si el teu client MCP manté llistes de permís o denegació per nom d'eina, revisa i actualitza la teva configuració perquè els noms de les noves eines reflecteixin els permisos que vols fer.

Per a la llista completa d'eines, aneu a Connectar a Dataverse amb Model Context Protocol.

Per què no veig l'eina search_data al servidor MCP de Dataverse?

L'eina search_data només està disponible quan la cerca de Dataverse està habilitada per al teu entorn. Si la cerca de Dataverse no està activada, l'eina search_data no apareix a la llista d'eines MCP disponibles. Per activar la cerca de Dataverse, ves a Configurar la cerca de Dataverse per al teu entorn.

Per què veig diferents eines als punts finals /api/mcp i /api/mcp_preview?

L'endpoint /api/mcp proporciona el conjunt generalment disponible d'eines MCP de Dataverse. L'endpoint /api/mcp_preview inclou eines addicionals de previsualització que s'avaluen abans de la disponibilitat general. Les eines de previsualització poden canviar o ser eliminades sense avisar. Per accedir a les eines de previsualització, un administrador ha d'activar la configuració de funcions de previsualització al centre d'administració de Power Platform. Més informació: Utilitza eines de previsualització i les properes funcionalitats al servidor MCP de Dataverse

Com puc activar el registre de depuració per al proxy local?

Si tens problemes amb el proxy local (@microsoft/dataverse), pots activar el registre de depuració per capturar una sortida detallada per a la resolució de problemes. Afegeix els --log-level arguments i --log-file a la comanda proxy:

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

El fitxer de registre s'escriu al directori temporal del sistema. La ubicació per defecte depèn del teu sistema operatiu:

Sistema operatiu	Ubicació del fitxer de registre
Windows	C:\Users\<username>\AppData\Local\Temp\
Linux	/tmp/
macOS	El directori especificat per la variable d'entorn $TMPDIR , típicament /var/folders/.../T/. Entra echo $TMPDIR en un terminal per trobar el camí exacte.

Pots compartir el fitxer de registre de sortida amb Microsoft quan obres un incident de suport per ajudar a diagnosticar el problema.