Observação
O acesso a essa página exige autorização. Você pode tentar entrar ou alterar diretórios.
O acesso a essa página exige autorização. Você pode tentar alterar os diretórios.
Este artigo fornece respostas para perguntas frequentes sobre como usar o Microsoft Dataverse com um servidor MCP (protocolo de contexto de modelo).
Não consigo me autenticar. Qual é o problema?
Verifique se a URL do ambiente do Dataverse na configuração do cliente MCP está correta. Vá para o Power Apps, selecione o ambiente correto e selecione Configurações (ícone de engrenagem) >Detalhes da sessão para confirmar a URL da instância.
Verifique também se o cliente MCP que você está usando está habilitado no centro de administração do Power Platform. Mais informações: Configurar e gerenciar o servidor MCP do Dataverse para um ambiente
Quais ferramentas mcp estão disponíveis e o que elas fazem?
O servidor MCP do Dataverse fornece ferramentas para operações de dados comuns, como consultar registros, criar e atualizar linhas, descrever esquemas de tabela e listar tabelas. Para obter a lista completa de ferramentas e descrições, acesse Conectar-se ao Dataverse com o Protocolo de Contexto de Modelo.
Posso restringir quais tabelas ou registros são acessíveis por meio do servidor MCP?
Sim. O servidor MCP do Dataverse respeita as funções de segurança do Dataverse e a segurança em nível de linha. Os usuários só podem acessar tabelas e registros que sua função de segurança permite. Nenhum controle de acesso específico do MCP adicional é necessário além da configuração de segurança padrão do Dataverse.
Há custos associados ao uso do servidor MCP do Dataverse?
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 qualificadas 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. Para obter informações sobre taxas de cobrança, acesse Conectar-se ao Dataverse com o Protocolo de Contexto de Modelo.
Posso usar o servidor MCP do Dataverse com vários ambientes?
Sim. Cada ambiente do Dataverse pode ter sua própria configuração de servidor MCP. Você pode se conectar a vários ambientes configurando entradas de servidor MCP separadas em seu cliente, cada uma apontando para uma URL de ambiente diferente.
Dica
Se você usar o Microsoft Copilot Studio, poderá usar o assistente de integração do MCP para conectar seu agente a servidores MCP do Dataverse em vários ambientes. O assistente orienta você por meio da configuração do servidor e da configuração de autenticação. Mais informações: conectar seu agente a um servidor MCP existente
O que devo fazer se uma ferramenta MCP do Dataverse retornar um erro?
Se uma ferramenta retornar um erro, tente reformular o prompt e enviá-lo novamente. Use um idioma mais específico para descrever o que você deseja realizar. Se o erro persistir, verifique se você tem as permissões apropriadas do Dataverse para a operação que está tentando.
Por que não vejo a ferramenta Pesquisar no servidor MCP do Dataverse?
A ferramenta Pesquisa só estará disponível quando a pesquisa do Dataverse estiver habilitada para seu ambiente. Se a pesquisa do Dataverse não estiver ativada, a ferramenta Pesquisar não aparecerá na lista de ferramentas MCP disponíveis. Para habilitar a pesquisa do Dataverse, vá para Configurar a pesquisa do Dataverse para seu ambiente.
Por que vejo ferramentas diferentes nos endereços de API /api/mcp e /api/mcp_preview?
O ponto de extremidade /api/mcp fornece o conjunto de ferramentas MCP do Dataverse disponíveis em geral, enquanto o ponto de extremidade /api/mcp_preview inclui ferramentas de visualização adicionais que estão sendo avaliadas antes da disponibilidade geral. As ferramentas de visualização podem ser alteradas ou removidas sem aviso prévio. Para acessar as ferramentas de visualização, um administrador deve habilitar a configuração de recursos de visualização no Centro de administração do Power Platform. Mais informações: Usar ferramentas de visualização e recursos futuros no servidor MCP do Dataverse
Como ativar o registro de log de depuração para o proxy local?
Se você tiver problemas com o proxy local (@microsoft/dataverse), pode habilitar o log de depuração para capturar uma saída detalhada e facilitar a solução de problemas. Adicione os argumentos --log-level e --log-file ao comando proxy.
npx @microsoft/dataverse mcp https://yourorg.crm.dynamics.com --log-level Debug --log-file
O arquivo de log é gravado no diretório temporário do sistema. O local padrão depende do sistema operacional:
| Sistema operacional | Local do arquivo de log |
|---|---|
| Windows | C:\Users\<username>\AppData\Local\Temp\ |
| Linux | /tmp/ |
| macOS | O diretório especificado pela variável de $TMPDIR ambiente, normalmente /var/folders/.../T/. Execute echo $TMPDIR em um terminal para localizar o caminho exato. |
Você pode compartilhar o arquivo de log de saída com a Microsoft ao abrir um incidente de suporte para ajudar a diagnosticar o problema.