Conecte-se ao Dataverse com o Protocolo de Contexto de Modelo

O PROTOCOLO MCP (Model Context Protocol) é um protocolo aberto que permite uma integração perfeita entre aplicativos LLM (modelo de linguagem grande) e fontes de dados e ferramentas externas. O Microsoft Dataverse pode atuar como um servidor MCP, fornecendo acesso inteligente a tabelas e registros para vários clientes MCP, como agentes do Copilot Studio, GitHub Copilot no Visual Studio Code, GitHub Copilot CLI, Claude desktop, Claude Code e muitos outros. Essa integração padroniza e simplifica a interação entre modelos de IA e dados do Dataverse, tornando mais eficiente e eficaz para os desenvolvedores aplicarem os recursos avançados de dados do Dataverse em seus aplicativos baseados em IA.

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

URL do servidor MCP do Dataverse

A URL do servidor remoto Dataverse MCP segue este formato:

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

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

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

Conectar-se a um servidor MCP do Dataverse

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

Lista de ferramentas

Depois de conectado ao Servidor MCP do Dataverse, você pode escolher entre as seguintes ferramentas no ambiente do Power Platform.

Tool Description
search_data Pesquisar dados estruturados e não estruturados.
search Pesquisar esquemas de tabela e habilidades de negócios por palavra-chave.
create_record Insere uma nova linha em uma tabela do Dataverse e retorna o GUID.
update_record Atualiza uma linha existente em uma tabela do Dataverse.
delete_record Exclua uma linha somente após a aprovação explícita do usuário.
create_table Cria uma nova tabela com um esquema especificado.
update_table Modifica o esquema ou os metadados de uma tabela existente.
delete_table Exclui uma tabela do Dataverse, somente após a aprovação explícita do usuário.
read_query Execute consultas SQL SELECT do Dataverse com suporte.
describe Obtenha detalhes dos resultados da pesquisa para tabelas, registros, esquemas, habilidades e aplicativos.
upsert_skill Adicione ou atualize uma habilidade/guia estratégico do Dataverse.
delete_skill Exclua uma habilidade/guia estratégico do Dataverse por nome.
init_file_upload Gere uma URL SAS para upload de arquivo.
commit_file_upload Confirmar um upload de arquivo.
file_download Gere uma URL SAS para download de arquivo.

Importante

A interface de ferramentas do servidor MCP do Dataverse foi alterada. As seguintes ferramentas foram removidas e suas funcionalidades foram substituídas pelas ferramentas na tabela anterior: , e (substituído por describe_table); e a ferramenta anterior list_tables que pesquisou dados do Dataverse (renomeado para fetch).describesearchsearch_data A ferramenta atual search pesquisa metadados. Se você mantiver listas de permissões ou negações em seu cliente MCP pelo nome da ferramenta, examine sua configuração para que os novos nomes de ferramenta reflitam suas permissões pretendidas. Mais informações: Conectar-se ao Dataverse com perguntas frequentes sobre o protocolo de contexto do modelo

Note

A partir de 15 de dezembro de 2025, as ferramentas do DATAverse MCP são cobradas quando acessadas 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 Assinatura de Usuário do Microsoft 365 Copilot), você não será cobrado por acessar dados do Dynamics 365, mesmo quando esses dados forem acessados de fora do Microsoft Copilot Studio.

A ferramenta search_data é cobrada à mesma taxa de Créditos do Copilot que a fundamentação de Graph do locatário. Todas as outras ferramentas, incluindo a ferramenta de metadados search, seguem a taxa de 10 créditos do Copilot por resposta aplicável às ferramentas de Texto e IA generativa (básicas). Para obter informações sobre a cobrança do Copilot, acesse as taxas de cobrança e o gerenciamento.

Próximas etapas

Configurar o servidor MCP do Dataverse para um ambiente