mcp-dataverse
Servidor MCP do Microsoft Dataverse: 54 ferramentas para CRUD, FetchXML, metadados, auditoria, lote, soluções e mais.
Documentação
MCP Dataverse
O servidor MCP mais completo para Microsoft Dataverse.
79 ferramentas · 4 recursos · 10 fluxos de trabalho guiados · Três modos de autenticação
Por que MCP Dataverse?
Agentes de IA alucinam esquemas, adivinham nomes de colunas e criam consultas OData quebradas. Este servidor dá a eles acesso em tempo real ao seu ambiente Dataverse — esquema, registros, metadados, soluções — por meio do Model Context Protocol.
- Três modos de autenticação — código de dispositivo (local), credenciais de cliente (CI/CD), identidade gerenciada (hospedado no Azure)
- Funciona com qualquer cliente MCP — VS Code, Claude, Cursor, Windsurf, Gemini, Codex CLI
- Ferramentas atômicas — cada ferramenta faz bem uma coisa; a IA escolhe a certa
- Saídas estruturadas — cada resposta retorna
{summary, data, suggestions} - Proteções — operações destrutivas exigem confirmação explícita
- Tokens criptografados — credenciais em cache com AES-256-GCM, nunca registradas em log
Instalação
npx mcp-dataverse install
O assistente interativo configura seu ambiente, registra o servidor no VS Code e autentica sua conta Microsoft em menos de 2 minutos.
Requer Node.js 20+. Para outros clientes (Claude, Cursor, Windsurf…) consulte Configuração Multi-Cliente.
Atualização
npx mcp-dataverse update
Sem necessidade de reconfiguração — apenas verifica sua configuração existente e mostra o que mudou. npx busca automaticamente a versão mais recente a cada execução, então basta reiniciar seu cliente MCP para obter as novas ferramentas.
Autenticação
Três modos — escolha com base em onde o servidor é executado:
| Modo | Quando usar |
|---|---|
| Código de Dispositivo (padrão) | Desenvolvimento local — login interativo da Microsoft, token armazenado em cache no disco |
| Credenciais de Cliente | Sem supervisão: CI/CD, Docker, serviços Azure — authMethod: "client-credentials" + Registro de Aplicativo |
| Identidade Gerenciada | Hospedado no Azure (App Service, Container Apps) — zero segredos, authMethod: "managed-identity" |
Início rápido com código de dispositivo: a autenticação é acionada na primeira chamada de ferramenta.
- Abra
View → Output → MCP— um código de login aparece - Vá para
https://microsoft.com/devicelogin, insira o código e entre com sua conta de trabalho - O token é armazenado em cache criptografado — todas as inicializações futuras são silenciosas
Para configuração de credenciais de cliente e identidade gerenciada, consulte Documentação de autenticação.
Recursos
| Categoria | Quantidade | Descrição |
|---|---|---|
| Metadados | 9 | Tabelas, esquema, relacionamentos, conjuntos de opções, chaves de entidade |
| Consulta | 3 | OData, FetchXML, recuperação paginada |
| CRUD | 6 | Obter, criar, atualizar, excluir, upsert, atribuir |
| Relacionamentos | 4 | Associar, associar em lote, desassociar, consultar associações |
| Ações e Funções | 6 | Ações e funções Dataverse vinculadas e não vinculadas |
| Lote | 1 | Até 1000 operações atomicamente |
| Soluções | 2 | Publicar personalizações, criar sitemap |
| Pesquisa | 1 | Pesquisa de Relevância em texto completo |
| Usuários e Equipes | 4 | Usuários, funções, equipes, atribuição de funções |
| RBAC | 7 | Privilégios de função: listar, atribuir, remover, adicionar, substituir, obter, equipe |
| Arquivos | 2 | Upload/download de colunas de arquivo e imagem |
| Auditoria e Rastreamento | 3 | Log de auditoria, logs de rastreamento de plug-in, logs de rastreamento de fluxo de trabalho |
| Anotações | 2 | Notas e anexos de arquivo |
| Personalização | 4 | Ações personalizadas, plug-ins, variáveis de ambiente, referências de conexão |
| Atributos | 4 | Criar, atualizar, excluir colunas; tipo de coluna de pesquisa |
| Esquema (gravação) | 2 | Criar tabelas e relacionamentos personalizados |
| Acesso a Registros | 4 | Verificar, conceder, revogar compartilhamento de registros; mesclar registros |
| Assistência | 2 | Roteador de ferramentas, tags de ferramentas |
| + mais | … | Sincronização delta, representação, exibições, unidades de negócios, detecção de duplicatas |
→ Referência Completa de Recursos
Transporte HTTP
Execute como um servidor HTTP para uso multi-cliente:
MCP_TRANSPORT=http MCP_HTTP_PORT=3000 MCP_HTTP_SECRET=mysecret node dist/server.js
Conecte-se usando VS Code / Copilot com:
{
"servers": {
"dataverse": {
"type": "http",
"url": "http://localhost:3000/mcp",
"headers": {
"Authorization": "Bearer mysecret"
}
}
}
}
Solução de Problemas
| Sintoma | Correção |
|---|---|
| Nenhum prompt de login | Abra Exibir → Saída → MCP — o código de dispositivo é exibido lá |
No MSAL accounts found | Execute npx mcp-dataverse-auth e reinicie o servidor |
Authentication timed out | Reinicie o servidor MCP — um novo código é gerado automaticamente |
| Servidor não aparece no modo Agente | Execute npx mcp-dataverse install ou npx mcp-dataverse doctor |
| Erros HTTP | Execute npx mcp-dataverse doctor para diagnosticar configuração e conectividade |
Dica de Desempenho
O MCP Dataverse foi projetado para ser abrangente, mas a maioria dos modelos de IA funciona melhor com menos ferramentas no contexto. Desmarque as ferramentas que você não precisa no seletor de ferramentas do seu cliente (por exemplo, painel de chat do VS Code) para manter o agente focado e responsivo.
Roteiro
| Versão | Recurso | Status |
|---|---|---|
| v0.4 | Transporte HTTP + gerenciamento de atributos + consistência de esquema | ✅ Lançado |
| v0.5 | Autenticação empresarial (Credenciais de Cliente, Identidade Gerenciada, Entra JWT) | ✅ Lançado |
| v0.6 | Prompts MCP (5 modelos) + Recursos MCP (4) | ✅ Lançado |
| v0.7 | Gravação de esquema (criar tabela/relacionamento) + Acesso a Registros (compartilhar, mesclar) | ✅ Lançado (v0.7.5) |