Guía de configuración

Hay una forma más rápida

Todo lo que hay en esta página se puede hacer por ti. El servidor MCP de Power Portals Pro conoce este marco, lee tu entorno Dataverse y tu suscripción a Azure, y puede crear los registros de la app, el usuario de la aplicación, el servicio de aplicaciones y el propio remitente del correo — preguntándote antes de cada cambio y diciéndote cuánto cuesta. Los pasos manuales están debajo y se mantienen precisos tanto si lo usas como si no. Durante todo el recorrido — desde una carpeta vacía hasta una página segura con tus propios datos — sigue el AI Quickstart.

Deja que un agente de IA haga la configuración

La configuración es la parte de este marco en la que ninguna documentación de componentes ayuda: abarca dotnet newdos registros de aplicaciones de Entra, un usuario de aplicación Dataverse, una solución gestionada, un remitente de correo electrónico y un servicio de aplicaciones, y cada uno de ellos produce un valor que debe caer en la clave de configuración correcta. El servidor MCP existe porque esa secuencia es conocible, y es el tipo de cosa que un agente con las herramientas adecuadas hace bien.

1. Instálalo

Instálala en el ámbito de usuario, para que esté disponible en cualquier carpeta — incluida una vacía en la que vayas a poner un proyecto en andamios, que es exactamente donde puede indicarte qué plantilla usar y qué significan las opciones:

Visual Studio y Cursor leen los suyos propios .mcp.json; la página del servidor MCP tiene el bloque para cada uno. Los proyectos creados a partir de las plantillas ya están cableados, con la versión fijada a los paquetes que usa el proyecto. dnx viene con el SDK .NET 10, que ya tienes.

2. Inicia sesión, en la carpeta de tu proyecto

Dos inicios de sesión, porque son dos cosas diferentes: una para el entorno Dataverse y otra para la suscripción de Azure. Ejecuta ambas en la carpeta donde se encuentra tu proyecto: cada enlace pertenece únicamente a esa carpeta, así que un consultor con varios clientes abiertos tiene cada uno apuntando a su propio entorno y suscripción al mismo tiempo:

Ambos usan un código de dispositivo por defecto, así que funcionan por SSH, en un contenedor y en WSL, y puedes terminarlos desde tu teléfono. Nada cambia a nivel de máquina — el servidor nunca lee ni altera en qué o pac en qué az están conectados, lo que permite que dos proyectos se dirijan a dos clientes sin que uno pisotee al otro. El inicio de sesión en Azure solo es necesario para las herramientas de despliegue; sáltalo si solo configuras localmente.

3. Pídele que empiece

No existe una orden única que lo haga todo, deliberadamente — consulta la nota más abajo. Apunta a tu agente hacia el plan y lo llevará a cabo contigo:

get_setup_plan es la lista ordenada de lo que debe existir y lo que produce cada paso; check_setup informa de lo que aún falta esta carpeta; get_setup_script escribe un script revisable para los pasos que prefieres ejecutar tú mismo. Para desplegar, get_deployment_plan y check_deployment hacer el mismo trabajo para Azure — consulta la página de despliegue de Azure .

Nota

Por qué no existe un único comando de "hacer todo". Cada herramienta que crea algo te pregunta primero y indica el coste, y esa aprobación por paso es la razón por la que estas herramientas pueden crear registros de apps y Servicios de Aplicaciones. Un comando que lo hiciera lo pediría diez veces, lo cual es peor que un agente guiándote, o una vez — lo que significaría aprobar objetos de directorio a nivel de inquilino, una factura mensual y Dataverse escribiría en un solo sí. La secuencia es conocible y el agente puede leerla; las aprobaciones son tuyas.

Montándolo a mano

La misma secuencia, hecha tú mismo. Vale la pena leer incluso si usas el agente: es lo que hacen las herramientas, y saberlo es la diferencia entre diagnosticar una configuración fallida y adivinar una.

1. Instalar las plantillas

Las plantillas estructuran un portal completo — conectividad Dataverse, autenticación, gestores de seguridad, localización y las páginas de identidad — y funcionan desde Visual Studio 2022 y 2026 o desde la línea de comandos. Instala el paquete una vez:

2. Crear el proyecto

El pack instala dos plantillas, y el conjunto de funciones de Power Portals Pro es idéntico en ambas: las grids, editores, seguridad, localización y las páginas de identidad se comportan igual de cualquier manera. Elige el frontend en el que tu equipo quiera trabajar:

• Power Portals Pro React Web App (powerportalspro-react) — un host ASP.NET Core combinado con una aplicación de página única React + Vite + TypeScript construida sobre Fluent UI React. Recomendado para nuevos portales, por las herramientas modernas de front-end y el rápido bucle de recarga en caliente.
• Power Portals Pro Web App (powerportalspro) — una aplicación web Blazor construida sobre Fluent UI Blazor, toda en C# de principio a fin. La elección adecuada para un equipo que prefiere no asumir una cadena de herramientas JavaScript, y la única de las dos que toma una --interactivity opción (Server, WebAssembly o Auto) para elegir su modo de renderizado.

En Visual Studio, ambos aparecen en el diálogo de nuevo proyecto:

Cualquiera de las dos puede crearse desde la línea de comandos, que es también como se programaría. La página de Plantillas de Proyecto cubre todas las opciones y su predeterminada:

3. Configurar la conexión Dataverse

Program.cs Lee los detalles de la conexión desde la configuración:

Ponga los valores en secretos de usuario en lugar de appsettings.json, para que un secreto cliente nunca llegue al control de versiones. Haz clic derecho en el proyecto y elige Gestionar secretos de usuario:

Sustituye los marcadores de posición por los tuyos propios. ClientId y ClientSecret proviene de un registro de una app de Entra emparejado con un usuario de la aplicación Dataverse — solo el registro autentica y luego es rechazado por cada llamada, por lo que se necesitan ambas mitades. La página de Conexión Dataverse explica cómo crearlas:

{
  "D365":
  {
    "Url": "https://yoururl.crm.dynamics.com",
    "ClientId": "",
    "ClientSecret": ""
  }
}

4. Instalar la solución gestionada

Descarga la última solución gestionada desde la página de Versiones e impórtala a tu entorno. Proporciona las propias tablas del framework y la acción de verificación de licencias: hasta que se instala, se rechazan todos los endpoints de datos, sin que nada en el síntoma apunte a la causa.

Abre la app Power Portals Pro en tu entorno:

En Portal web, crea un registro para tu sitio e introduce tu clave de licencia.

Nota

¿Aún no hay llave? Solicita una prueba. La página de Licencias cubre cómo obtener y registrar uno completo.

5. Inicio de sesión de Microsoft (opcional)

El inicio de sesión con Microsoft está estructurado pero se ha comentado fuera. Elimina comentarios en este bloque en Program.cs:

Necesita su propio registro en la app de Entra, separado del del paso 3, para que rotar un secreto no pueda eliminar tanto el inicio de sesión como el acceso a datos. La página de Inicio de sesión de Entra ID cubre el registro y todas las propiedades que necesita.

6. Hazlo

Pulsa F5. Lo que empieza es un portal funcional en lugar de una shell vacía: ejemplos de páginas de Cuentas y Contactos, las páginas de identidad y gestión de cuentas, navegación, y configuración de temas y sitios — todo eso es tuyo para editar.

La solución también incluye un <YourProject>.Tests.Integration proyecto con bases para pruebas de endpoint, permisos y de nivel de servicio. Véase Pruebas de Integración.