Conectar-se ao Dataverse com o Model Context Protocol

O Model Context Protocol (MCP) é um protocolo aberto que permite a integração perfeita entre aplicativos LLM (modelo de linguagem grande) e fontes de dados e ferramentas externas. O Microsoft Dataverse pode funcionar como servidor MCP, fornecendo acesso inteligente a tabelas e registos a vários clientes MCP como agentes Copilot Studio, Visual Studio (VS) Code, GitHub Copilot, GitHub Copilot CLI, Claude desktop, Claude Code, entre muitos outros. Esta integração padroniza e simplifica a interação entre os modelos de IA e os dados do Dataverse, tornando-a mais eficiente e eficaz para os programadores aplicarem as capacidades ricas de dados do Dataverse dentro das respetivas aplicações condicionadas por IA.

Para usar o Dataverse como um servidor MCP, você precisa habilitar e configurar o servidor MCP e os clientes permitidos para seu ambiente Power Platform. Uma vez configurado, você pode se conectar ao servidor Dataverse MCP usando diferentes clientes MCP. Para obter mais informações: Configurar o servidor Dataverse MCP para um ambiente

URL do servidor MCP do Dataverse

A URL remota do servidor MCP do Dataverse segue este formato:

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

Por exemplo, se o nome da sua organização Dataverse for contoso, a URL do servidor MCP é:

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

Liga-te a um servidor MCP do Dataverse

Há várias maneiras de se conectar a um servidor Dataverse MCP:

Lista de ferramentas

Uma vez ligado ao Servidor MCP Dataverse, pode escolher entre as seguintes ferramentas no ambiente Power Platform.

Ferramenta Description
search_data Pesquise dados estruturados e não estruturados.
search Pesquise esquemas de tabelas e competências de negócio por palavra-chave.
create_record Insere uma nova linha em uma tabela Dataverse e retorna o GUID.
update_record Atualiza uma linha existente em uma tabela Dataverse.
delete_record Apague uma linha apenas após aprovação explícita do utilizador.
create_table Cria uma nova tabela com um esquema especificado.
update_table Modifica o esquema ou metadados de uma tabela existente.
delete_table Apaga uma tabela do Dataverse, apenas após aprovação explícita do utilizador.
read_query Executar consultas SQL SELECT do Dataverse suportadas.
describe Obtenha detalhes dos resultados de pesquisa para tabelas, registos, esquemas, competências e aplicações.
upsert_skill Adiciona ou atualiza uma habilidade/manual do Dataverse.
delete_skill Elimina uma habilidade/playbook do Dataverse por nome.
init_file_upload Gera um URL SAS para o upload do ficheiro.
commit_file_upload Confirma o carregamento de um ficheiro.
file_download Gera um URL SAS para download de ficheiros.

Importante

A superfície da ferramenta de servidor MCP do Dataverse foi alterada. As seguintes ferramentas foram removidas e a sua funcionalidade substituída pelas ferramentas da tabela anterior: describe_table, , e list_tables (substituídas por fetch); e a ferramenta anterior describe que pesquisava dados do Dataverse (renomeada para searchsearch_data). A ferramenta atual search pesquisa metadados. Se mantiver listas de permitir ou recusar no seu cliente MCP por nome de ferramenta, reveja a sua configuração para que os novos nomes de ferramentas reflitam as permissões pretendidas. Mais informações: Ligue-se ao Dataverse com FAQ sobre o protocolo de contexto do modelo

Observação

A partir de 15 de dezembro de 2025, as ferramentas MCP da Dataverse passam a ser cobradas quando acedidas por agentes de IA criados fora do Microsoft Copilot Studio. Se você tiver licenças do Dynamics 365 Premium (como Dynamics 365 Sales Premium, Finance Premium, Supply Chain Premium e Customer Service Premium) ou uma USL (Licença de Usuário do Microsoft 365 Copilot), não será cobrado pelo acesso aos dados do Dynamics 365, mesmo quando esses dados forem acessados de fora do Microsoft Copilot Studio.

A ferramenta search_data é faturada à mesma taxa de Créditos do Copilot que a ancoragem no grafo do tenant. Todas as outras ferramentas, incluindo a ferramenta de metadados search, seguem a taxa das ferramentas de texto e IA generativa (básica) de 10 créditos Copilot por resposta. Para obter informações sobre o faturamento do Copilot, vá para Taxas e gerenciamento de faturamento.

Próximos passos

Configurar o servidor Dataverse MCP para um ambiente