mcp-dataverse
Servidor MCP de Microsoft Dataverse: 54 herramientas para CRUD, FetchXML, metadatos, auditoría, lotes, soluciones y más.
Documentación
MCP Dataverse
El servidor MCP más completo para Microsoft Dataverse.
79 herramientas · 4 recursos · 10 flujos guiados · Tres modos de autenticación
¿Por qué MCP Dataverse?
Los agentes de IA alucinan esquemas, adivinan nombres de columnas y construyen consultas OData rotas. Este servidor les da acceso en tiempo real a tu entorno de Dataverse — esquema, registros, metadatos, soluciones — a través del Model Context Protocol.
- Tres modos de autenticación — código de dispositivo (local), credenciales de cliente (CI/CD), identidad administrada (alojado en Azure)
- Funciona con cualquier cliente MCP — VS Code, Claude, Cursor, Windsurf, Gemini, Codex CLI
- Herramientas atómicas — cada herramienta hace bien una sola cosa; la IA elige la correcta
- Salidas estructuradas — cada respuesta devuelve
{summary, data, suggestions} - Protecciones — las operaciones destructivas requieren confirmación explícita
- Tokens cifrados — credenciales en caché AES-256-GCM, nunca registradas
Instalación
npx mcp-dataverse install
El asistente interactivo configura tu entorno, registra el servidor en VS Code y autentica tu cuenta de Microsoft en menos de 2 minutos.
Requiere Node.js 20+. Para otros clientes (Claude, Cursor, Windsurf…) consulta Configuración multi-cliente.
Actualización
npx mcp-dataverse update
No requiere reconfiguración — solo verifica tu configuración existente y muestra qué cambió. npx obtiene automáticamente la última versión en cada ejecución, así que simplemente reiniciar tu cliente MCP es suficiente para obtener las nuevas herramientas.
Autenticación
Tres modos — elige según dónde se ejecute el servidor:
| Modo | Cuándo usarlo |
|---|---|
| Código de dispositivo (predeterminado) | Desarrollo local — inicio de sesión interactivo de Microsoft, token en caché en disco |
| Credenciales de cliente | Sin supervisión: CI/CD, Docker, servicios de Azure — authMethod: "client-credentials" + Registro de aplicación |
| Identidad administrada | Alojado en Azure (App Service, Container Apps) — cero secretos, authMethod: "managed-identity" |
Inicio rápido con código de dispositivo: la autenticación se activa en la primera llamada a una herramienta.
- Abre
View → Output → MCP— aparece un código de inicio de sesión - Ve a
https://microsoft.com/devicelogin, introduce el código e inicia sesión con tu cuenta de trabajo - El token se guarda en caché cifrado — todos los inicios futuros son silenciosos
Para la configuración de credenciales de cliente e identidad administrada, consulta Documentación de autenticación.
Capacidades
| Categoría | Cantidad | Descripción |
|---|---|---|
| Metadatos | 9 | Tablas, esquema, relaciones, conjuntos de opciones, claves de entidad |
| Consulta | 3 | OData, FetchXML, recuperación paginada |
| CRUD | 6 | Obtener, crear, actualizar, eliminar, upsert, asignar |
| Relaciones | 4 | Asociar, asociar en lote, desasociar, consultar asociaciones |
| Acciones y funciones | 6 | Acciones y funciones de Dataverse enlazadas y no enlazadas |
| Lote | 1 | Hasta 1000 operaciones atómicamente |
| Soluciones | 2 | Publicar personalizaciones, crear mapa del sitio |
| Búsqueda | 1 | Búsqueda de relevancia de texto completo |
| Usuarios y equipos | 4 | Usuarios, roles, equipos, asignación de roles |
| RBAC | 7 | Privilegios de rol: listar, asignar, eliminar, agregar, reemplazar, obtener, equipo |
| Archivos | 2 | Subir/descargar columnas de archivos e imágenes |
| Auditoría y seguimiento | 3 | Registro de auditoría, registros de seguimiento de plugins, registros de seguimiento de flujos de trabajo |
| Anotaciones | 2 | Notas y adjuntos de archivos |
| Personalización | 4 | Acciones personalizadas, plugins, variables de entorno, referencias de conexión |
| Atributos | 4 | Crear, actualizar, eliminar columnas; tipo de columna de búsqueda |
| Esquema (escritura) | 2 | Crear tablas y relaciones personalizadas |
| Acceso a registros | 4 | Verificar, conceder, revocar uso compartido de registros; fusionar registros |
| Asistencia | 2 | Enrutador de herramientas, etiquetas de herramientas |
| + más | … | Sincronización delta, suplantación, vistas, unidades de negocio, detección de duplicados |
→ Referencia completa de capacidades
Transporte HTTP
Ejecuta como servidor HTTP para uso multi-cliente:
MCP_TRANSPORT=http MCP_HTTP_PORT=3000 MCP_HTTP_SECRET=mysecret node dist/server.js
Conéctate usando VS Code / Copilot con:
{
"servers": {
"dataverse": {
"type": "http",
"url": "http://localhost:3000/mcp",
"headers": {
"Authorization": "Bearer mysecret"
}
}
}
}
Solución de problemas
| Síntoma | Solución |
|---|---|
| No aparece el aviso de inicio de sesión | Abre Ver → Salida → MCP — el código de dispositivo se muestra allí |
No MSAL accounts found | Ejecuta npx mcp-dataverse-auth y luego reinicia el servidor |
Authentication timed out | Reinicia el servidor MCP — se genera un código nuevo automáticamente |
| El servidor no aparece en el modo Agente | Ejecuta npx mcp-dataverse install o npx mcp-dataverse doctor |
| Errores HTTP | Ejecuta npx mcp-dataverse doctor para diagnosticar configuración y conectividad |
Consejo de rendimiento
MCP Dataverse está diseñado para ser completo, pero la mayoría de los modelos de IA funcionan mejor con menos herramientas en contexto. Deselecciona las herramientas que no necesitas en el selector de herramientas de tu cliente (por ejemplo, el panel de chat de VS Code) para mantener al agente enfocado y receptivo.
Hoja de ruta
| Versión | Característica | Estado |
|---|---|---|
| v0.4 | Transporte HTTP + gestión de atributos + consistencia de esquema | ✅ Publicado |
| v0.5 | Autenticación empresarial (Credenciales de cliente, Identidad administrada, Entra JWT) | ✅ Publicado |
| v0.6 | MCP Prompts (5 plantillas) + MCP Resources (4) | ✅ Publicado |
| v0.7 | Escritura de esquema (crear tabla/relación) + Acceso a registros (compartir, fusionar) | ✅ Publicado (v0.7.5) |