MCP Dataverse

El servidor MCP más completo para Microsoft Dataverse.

79 herramientas · 4 recursos · 10 flujos de trabajo guiados · Tres modos de autenticación

npm npm downloads Node 20+ TypeScript License: MIT

¿Por qué MCP Dataverse?

Los agentes de IA alucinan con el esquema, adivinan nombres de columnas y crean consultas OData rotas. Este servidor les proporciona acceso en tiempo real a su 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 una cosa bien; la IA elige la correcta
Salidas estructuradas — cada respuesta devuelve {summary, data, suggestions}
Guardrails — las operaciones destructivas requieren confirmación explícita
Tokens cifrados — credenciales en caché con AES-256-GCM, nunca registradas en logs

Instalación

npx mcp-dataverse install

El asistente interactivo configura su entorno, registra el servidor en VS Code y autentica su cuenta de Microsoft en menos de 2 minutos.

Requiere Node.js 20+. Para otros clientes (Claude, Cursor, Windsurf…) consulte Configuración multi-cliente.

Autenticación

Tres modos — elija según dónde se ejecute el servidor:

Modo	Cuándo usar
Código de dispositivo (predeterminado)	Desarrollo local — inicio de sesión interactivo de Microsoft, token en caché en disco
Credenciales de cliente	Desatendido: CI/CD, Docker, servicios de Azure — `authMethod: "client-credentials"` + Registro de aplicación
Identidad administrada	Alojado en Azure (App Service, Container Apps) — sin secretos, `authMethod: "managed-identity"`

Inicio rápido con código de dispositivo: la autenticación se activa en la primera llamada a una herramienta.

Abra View → Output → MCP — aparecerá un código de inicio de sesión
Vaya a https://microsoft.com/devicelogin, introduzca el código e inicie sesión con su cuenta de trabajo
El token se almacena cifrado — todos los inicios futuros son silenciosos

Para la configuración de credenciales de cliente e identidad administrada, consulte la 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 masa, desasociar, consultar asociaciones
Acciones y funciones	6	Acciones y funciones de Dataverse vinculadas/no vinculadas
Lotes	1	Hasta 1000 operaciones de forma atómica
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, añadir, reemplazar, obtener, equipo
Archivos	2	Cargar/descargar columnas de archivo e imagen
Auditoría y traza	3	Registro de auditoría, registros de traza de plugins, registros de traza de flujos de trabajo
Anotaciones	2	Notas y archivos adjuntos
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	Comprobar, conceder, revocar uso compartido de registros; combinar 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

Ejecutar como servidor HTTP para uso multi-cliente:

MCP_TRANSPORT=http MCP_HTTP_PORT=3000 MCP_HTTP_SECRET=mysecret node dist/server.js

Conectar 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	Abra View → Output → MCP — el código de dispositivo se muestra allí
`No MSAL accounts found`	Ejecute `npx mcp-dataverse-auth` y luego reinicie el servidor
`Authentication timed out`	Reinicie el servidor MCP — se genera un código nuevo automáticamente
El servidor no aparece en modo Agente	Ejecute `npx mcp-dataverse install` o `npx mcp-dataverse doctor`
Errores HTTP	Ejecute `npx mcp-dataverse doctor` para diagnosticar la configuración y conectividad

Consejo de rendimiento

MCP Dataverse está diseñado para ser integral, pero la mayoría de los modelos de IA funcionan mejor con menos herramientas en contexto. Deseleccione las herramientas que no necesite en el selector de herramientas de su cliente (p. ej., 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	Prompts de MCP (5 plantillas) + Recursos de MCP (4)	✅ Publicado
v0.7	Escritura de esquema (crear tabla/relación) + Acceso a registros (compartir, combinar)	✅ Publicado (v0.7.5)

→ Hoja de ruta completa

MCP Dataverse

MCP Dataverse

¿Por qué MCP Dataverse?

Instalación

Autenticación

Capacidades

Transporte HTTP

Solución de problemas

Consejo de rendimiento

Hoja de ruta

Licencia

Resources

Latest Blog Posts

MCP directory API