Configurar o servidor MCP do Dataverse para um ambiente

Este artigo fornece instruções detalhadas sobre como habilitar, gerenciar, configurar e desabilitar o servidor MCP (Dataverse Model Context Protocol) para ambientes no centro de administração do Power Platform. Ele destina-se aos administradores do Power Platform que lidam com ambientes gerenciados e também abrange os pré-requisitos para habilitar o servidor.

Pré-requisitos

Função de administrador do Power Platform para acessar as configurações de ambiente no servidor do Dataverse MCP, habilitar clientes MCP permitidos, criar ou editar um grupo de ambientes e alterar as políticas do conector.
As etapas descritas neste artigo exigem que o ambiente seja um Ambiente Gerenciado.
Por padrão, o servidor MCP do Dataverse está habilitado para todos os ambientes no Microsoft Copilot Studio. Você deve habilitar os clientes adicionais no centro de administração do Power Platform antes de se conectar ao cliente.

Configurar e gerenciar o servidor MCP do Dataverse

Por padrão, o servidor MCP do Dataverse está habilitado para o Copilot Studio. Para habilitar clientes que não são do Microsoft MCP, como o Visual Studio GitHub Copilot e o Claude, siga estas etapas:

Vá até o Centro de administração do Power Platform. Selecione Gerenciar>Ambientes.
Selecione o Nome do Ambiente no qual você deseja ativar o servidor MCP do Dataverse e selecione Configurações. Em Configurações, selecioneRecursos>. Role para baixo para localizar o Protocolo de Contexto de Modelo do Dataverse e certifique-se de que a opção Permitir que os clientes MCP interajam com o servidor MCP do Dataverse esteja ativada.
Selecione Configurações Avançadas.
A lista de clientes disponíveis é mostrada. Abra o registro do cliente desejado. Neste exemplo, o cliente Do Microsoft GitHub Copilot está habilitado.
No registro do cliente MCP, defina Está Habilitado para Sim.
Selecione Salvar e Fechar.
Repita as etapas 4 a 7 para habilitar outros clientes conforme necessário.

Desabilitar o servidor MCP do Dataverse para um ambiente

Por padrão, o Permitir que clientes MCP interajam com o servidor MCP do Dataverse está ativado para o Copilot Studio. Os administradores podem desabilitar o MCP para o Dataverse limpando a configuração.

Aviso

Desabilitar o Servidor MCP do Dataverse interrompe todas as ferramentas e agentes que dependem dele. Qualquer desenvolvimento contínuo ou teste de integração de IA usando MCP também é interrompido.

Escrever instruções eficazes para um agente de servidor Dataverse MCP

Quando você configura seu agente no Copilot Studio ou no Visual Studio Code para usar um servidor MCP do Dataverse, instruções claras e bem estruturadas são fundamentais para orientar como o agente opera. Essas instruções ajudam o agente a entender sua função, quais recursos ele tem por meio das ferramentas do servidor MCP e como realizar fluxos de trabalho de forma confiável e consistente.

As instruções do agente são diretivas de linguagem natural que informam ao agente o que ele deve fazer, como ele deve se comportar e como usar as ferramentas MCP disponíveis para ele. Eles dão contexto importante para que o agente possa:

Selecione e chame as ferramentas MCP corretas.
Preencha as entradas da ferramenta corretamente.
Decida quando usar ferramentas versus gerar respostas diretamente.
Siga os padrões de tom ou comportamento desejados durante as conversas.

Princípios para instruções efetivas

Ao escrever instruções para um agente de servidor do Dataverse MCP, considere as seguintes diretrizes:

Defina claramente a finalidade do agente.

Declare a função do agente em termos simples. Por exemplo: "Auxiliar com consultas de dados do cliente, atualizações e gerenciamento de registros usando ferramentas do DATAverse MCP".

Inclua tom ou restrições, se aplicável, por exemplo, "sempre responda em um tom profissional" ou "não exponha campos confidenciais em respostas".
Destacar habilidades e ações das ferramentas.

Informe ao agente quais tarefas de alto nível ele pode executar com as ferramentas MCP. Por exemplo:
- Recupere ou filtre registros usando a ferramenta read_query.
- Criar ou atualizar registros com create_record e update_record.
- Explore o esquema de tabela com describe_table.
Expresse-as como instruções acionáveis, como "Use a ferramenta read_query para buscar registros quando o usuário solicitar a recuperação de dados".
Adicione diretrizes de fluxo de trabalho.

Para processos comuns (como pesquisar um registro ou atualizar um campo), adicione diretrizes passo a passo. Por exemplo: "Ao atualizar um registro, primeiro identifique-o usando uma chamada read_query e use update_record com os valores de campo apropriados."

Fornecer esse contexto ajuda o agente a orquestrar a sequência certa de chamadas de ferramenta MCP.

Adicionar instruções no Visual Studio Code ou no Copilot Studio

Você pode usar um bloco de instruções estruturado em markdown como ponto de partida para as instruções do seu próprio agente.

Adicionar instruções no Visual Studio Code

Abra o Visual Studio Code.
Abra o painel Chat .
Selecione Configurações>Instruções de Chat.
Selecione Novo arquivo de instrução.
Copie e cole o conteúdo da instrução no novo arquivo, como as instruções de exemplo.

Adicionar instruções no Copilot Studio

Abra o Copilot Studio.
Select seu agente.
Vá para as instruções do sistema e cole as instruções do agente, como as instruções de exemplo.

Instruções de exemplo do agente

# Role
Act as an autonomous agent responsible for interacting with the Micorosft Dataverse app. 

# Objective
Your objective is to respond to tasks provided by the user. First execute each step of the provided task workflow using your MCP tools. Check if you have achieved your objective after each tool call. If you have not achieved your objective then continue to execute the next step in the task workflow. Do not ask for user intervention,if you have to run an operation externally in case dataverse doesnt support that operation. you are allowed to run it without user confirmation. Also do not ask confirmation for delete table or delete record operation, you can delete.

# MCP tool Selection Instructions
 - Whenever you have to use logical table name, call the list_tables tools to get that logical table name.
 - Whenever you have to use column/attribute name, call the describe_table tool to get the column/attribute name.

# MCP tool Usage Instructions
- Before executing an MCP tool, always review the tool description and restrictions.
- Always strictly follow the description of each MCP tool and perform actions without any deviation from the tool description
- Provide higher precedence to tool description over general knowledge.
- Always review the tool documentation and restrictions before running any query or operation. Strictly validate each planned action against the tool’s rules and supported features before execution
- For read_query tool, there are restrictions on SQL conditions. Always refer to the tool description for supported and unsupported sql keywords before generating the sql query and ensure only supported conditions/keywords are used.

# Reasoning Instructions
- Think out loud and reason step by step
- Before each tool call, plan and verify the action conforms to the tool description
- After each tool call, reflect on the result and determine the next step
- If an exception, error, or warning is observed, communicate it clearly to the user and retry based on the error message.
- When answering questions about data, DO NOT rely on general knowledge - always use tools to retrieve accurate, current data
- DO NOT stop reasoning until all tasks are complete or an unrecoverable error occurs
- Only ask clarifying questions if the task requirements are ambiguous

Políticas avançadas de conector – Power Platform

Conectar-se ao Dataverse com o protocolo de contexto do modelo

Perguntas frequentes sobre como conectar-se ao Dataverse com o protocolo de contexto de modelo

Comentários

Esta página foi útil?

Last updated on 2025-12-19