Connettersi a Dataverse con il protocollo di contesto del modello

Il protocollo MCP (Model Context Protocol) è un protocollo aperto che consente un'integrazione senza problemi tra applicazioni LLM (Large Language Model) e origini dati esterne e strumenti. Microsoft Dataverse può fungere da server MCP, fornendo accesso intelligente a tabelle e record a vari client MCP, come gli agenti di Copilot Studio, Visual Studio Code GitHub Copilot, l'interfaccia della riga di comando di GitHub Copilot, Claude Desktop, Claude Code e molti altri. Questa integrazione standardizza e semplifica l'interazione tra modelli di intelligenza artificiale e dati Dataverse, rendendo più efficiente ed efficace per gli sviluppatori applicare le avanzate funzionalità di dati di Dataverse all'interno delle loro applicazioni basate sull'intelligenza artificiale.

Per usare Dataverse come server MCP, è necessario abilitare e configurare il server MCP e i client consentiti per l'ambiente Power Platform. Dopo la configurazione, è possibile connettersi al server MCP dataverse usando client MCP diversi. Altre informazioni: Configurare il server MCP Dataverse per un ambiente

L'URL del server MCP di Dataverse

L'URL del server remoto Dataverse MCP segue questo formato:

https://{dataverseOrgName}.crm.dynamics.com/api/mcp

Ad esempio, se il nome dell'organizzazione dataverse è contoso, l'URL del server MCP è:

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

Connetti a un server MCP Dataverse

Esistono diversi modi per connettersi a un server MCP dataverse:

Elenco degli strumenti

Dopo la connessione al server MCP dataverse, è possibile scegliere tra gli strumenti seguenti nell'ambiente Power Platform.

Strumento Description
search_data Cercare dati strutturati e non strutturati.
search Cercare schemi di tabella e competenze aziendali per parola chiave.
create_record Inserisce una nuova riga in una tabella Dataverse e restituisce il GUID.
update_record Aggiorna una riga esistente in una tabella Dataverse.
delete_record Eliminare una riga solo dopo l'approvazione esplicita dell'utente.
create_table Crea una nuova tabella con uno schema specificato.
update_table Modifica lo schema o i metadati di una tabella esistente.
delete_table Elimina una tabella da Dataverse, solo dopo l'approvazione esplicita dell'utente.
read_query Esegui query SQL supportate di Dataverse SELECT.
describe Ottenere dettagli dai risultati della ricerca per tabelle, record, schemi, competenze e app.
upsert_skill Aggiungere o aggiornare una competenza/playbook di Dataverse.
delete_skill Elimina una skill/playbook di Dataverse per nome.
init_file_upload Genera un URL SAS per il caricamento del file.
commit_file_upload Conferma il caricamento del file.
file_download Genera un URL SAS per scaricare un file.

Importante

La superficie dello strumento del server MCP di Dataverse è stata modificata. Gli strumenti seguenti sono stati rimossi e le relative funzionalità sono state sostituite dagli strumenti della tabella precedente: describe_table, list_tablese (sostituiti da fetch) e describe lo strumento precedente search che ha cercato i dati di Dataverse (rinominati in search_data). Lo strumento corrente search esegue la ricerca nei metadati. Se si mantengono elenchi di autorizzazioni consentite o negate nel client MCP in base al nome dello strumento, esaminare la configurazione in modo che i nuovi nomi degli strumenti riflettano le autorizzazioni desiderate. Altre informazioni: Connettersi a Dataverse con domande frequenti sul protocollo di contesto del modello

Note

A partire dal 15 dicembre 2025, gli strumenti MCP di Dataverse sono soggetti a tariffazione quando vengono utilizzati da agenti di IA creati al di fuori di Microsoft Copilot Studio. Se si dispone di licenze Dynamics 365 Premium (ad esempio Dynamics 365 Remote Assist Premium, Finance Premium, Supply Chain Premium e Customer Service Premium) o di una licenza di sottoscrizione utente copilot di Microsoft 365 (USL), non vengono addebitati costi per l'accesso ai dati di Dynamics 365, anche quando si accede a tali dati dall'esterno di Microsoft Copilot Studio.

Lo strumento search_data viene fatturato alla stessa tariffa di Copilot Credit del grounding del grafo del tenant. Tutti gli altri strumenti, incluso lo strumento per i metadati search, seguono la tariffa di 10 crediti Copilot per risposta degli strumenti di IA per testo e IA generativa (di base). Per informazioni sulla fatturazione di Copilot, vedere Tariffe e gestione della fatturazione.

Passaggi successivi

Configurare il server MCP Dataverse per un ambiente