Guia de Configuração

Existe um caminho mais rápido
Tudo nesta página pode ser feito por você. O servidor Power Portals Pro MCP conhece esse framework, lê seu ambiente Dataverse e sua assinatura do Azure, e pode criar os registros do app, o usuário do aplicativo, o App Service e o próprio remetente do e-mail — perguntando antes de cada alteração e informando o custo. Os passos manuais estão abaixo e permanecem precisos independentemente de você usar ou não. Para toda a jornada — de uma pasta vazia a uma página segura com seus próprios dados — siga o AI Quickstart.

Deixe um agente de IA fazer a configuração

A configuração é a parte desse framework que nenhuma documentação de componentes ajuda: ela abrange dotnet newdois registros de aplicativos Entra, um usuário de aplicação Dataverse, uma solução gerenciada, um remetente de e-mail e um App Service, e cada um deles produz um valor que precisa cair na chave de configuração correta. O servidor MCP existe porque essa sequência é conhecível, e é o tipo de coisa que um agente com as ferramentas certas faz bem.

1. Instale-o

Instale-o no escopo do usuário, para que ele esteja disponível em qualquer pasta — incluindo uma vazia que você está prestes a escalfar um projeto, que é exatamente onde ele pode te dizer qual modelo usar e o que as opções significam:

Visual Studio e Cursor leem seus próprios .mcp.jsondados; a página do MCP Server tem o bloco de cada um. Projetos criados a partir dos templates já estão conectados com cabos, com a versão fixada nos pacotes que o projeto usa. dnx vem com o SDK .NET 10, que você já tem.

Dois logins, porque são duas coisas diferentes: um para o ambiente Dataverse e outro para a assinatura Azure. Execute ambos na pasta onde seu projeto está — cada binding pertence apenas a essa pasta, então um consultor com vários clientes abertos tem cada um apontado para seu próprio ambiente e assinatura ao mesmo tempo:

Ambos usam código de dispositivo por padrão, então funcionam via SSH, em um container e em WSL, e você pode finalizá-los no seu celular. Nada muda em toda a máquina — o servidor nunca lê ou altera o que az ou pac está logado, o que permite que dois projetos mirem dois clientes sem que um pise no outro. O login do Azure é necessário apenas para as ferramentas de implantação; pule se você estiver configurando apenas localmente.

3. Peça para começar

Não existe um comando único que faça tudo, deliberadamente — veja a nota abaixo. Aponte seu agente para o plano, e ele trabalhará com você nele:

get_setup_plan é a lista ordenada do que precisa existir e o que cada etapa produz; check_setup informa o que essa pasta ainda está faltando; get_setup_script escreve um script revisável para as etapas que você prefere executar você mesmo. Para implantação, get_deployment_plan e check_deployment faça o mesmo trabalho para Azure — veja a página de implantação Azure .

Nota
Por que não existe um comando único de "faça tudo". Cada ferramenta que cria algo pergunta primeiro e declara o custo, e essa aprovação por passo é o motivo pelo qual essas ferramentas podem criar cadastros de aplicativos e Serviços de Aplicativos. Um comando que fizesse tudo perguntaria dez vezes, o que é pior do que um agente te guiando, ou perguntaria uma vez — o que significaria aprovar objetos do diretório para todo o locatário, uma conta mensal e o Dataverse escreve com um único sim. A sequência é conhecível e o agente pode lê-la; as aprovações são suas.

Montando à mão

A mesma sequência, feita você mesmo. Vale a pena ler mesmo que você use o agente: é o que as ferramentas estão fazendo, e saber disso é a diferença entre diagnosticar uma configuração falhada e chutar uma.

1. Instalar os templates

Os templates estruturam um portal completo — conectividade Dataverse, autenticação, handlers de segurança, localização e as páginas de identidade — e funcionam a partir do Visual Studio 2022 e 2026 ou da linha de comando. Instale o pacote uma vez:

2. Criar o projeto

O pacote instala dois modelos, e o conjunto de recursos do Power Portals Pro é idêntico em ambos — grades, editores, segurança, localização e as páginas de identidade se comportam da mesma forma de qualquer forma. Escolha o front-end em que sua equipe quer trabalhar:

Power Portals Pro React Web App (powerportalspro-react) — um host ASP.NET Core combinado com um aplicativo de página única React + Vite + TypeScript construído no Fluent UI React. Recomendado para novos portais, pelas ferramentas modernas de front-end e pelo rápido ciclo de desenvolvimento de recarga a quente.
Power Portals Pro Web App (powerportalspro) — um aplicativo web Blazor construído sobre o Fluent UI Blazor, todo em C# de ponta a ponta. A escolha certa para uma equipe que prefere não assumir uma cadeia de ferramentas JavaScript, e a única das duas que aceita uma --interactivity opção (Server, WebAssembly ou Auto) para escolher seu modo de renderização.

No Visual Studio, ambos aparecem na caixa de diálogo do novo projeto:

O diálogo de novo projeto do Visual Studio com um template do Power Portals Pro selecionado.

Qualquer um pode ser criado pela linha de comando, que também é como você faria o script. A página de Modelos de Projeto cobre todas as opções e seu padrão:

3. Configurar a conexão Dataverse

Program.cs Lê os detalhes da conexão da configuração:

O código Program.cs mostra onde as configurações de conexão do Dataverse são lidas a partir da configuração.

Coloque os valores em segredos de usuário em vez de appsettings.json, para que um segredo cliente nunca alcance o controle de versão. Clique com o botão direito no projeto e escolha Gerenciar Segredos de Usuário:

O menu de contexto do projeto Visual Studio com a opção Gerenciar Segredos do Usuário destacado.

Substitua os marcadores de lugar pelos seus. ClientId e ClientSecret venha de um registro de um aplicativo Entra combinado com um usuário de um aplicativo Dataverse — o registro sozinho autentica e é recusado por todas as chamadas, então ambas as metades são necessárias. A página de Conexão Dataverse guia como criá-las:

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

4. Instalar a solução gerenciada

Baixe a solução gerenciada mais recente da página de Releases e importe-a para o seu ambiente. Ela fornece as próprias tabelas do framework e a ação de verificação de licença — até que seja instalado, todos os endpoints de dados são recusados, sem que nenhum sintoma aponte a causa.

Abra o aplicativo Power Portals Pro no seu ambiente:

O aplicativo orientado a modelos Power Portals Pro é aberto no ambiente Dataverse.

No site do portal, crie um registro para o seu site e insira a chave da sua licença.

O formulário de registro do site do portal onde a chave de licença é inserida.

Nota
Ainda não tem chave? Solicite um teste. A página de Licenciamento cobre como obter e registrar um integral.

O login com a Microsoft é estruturado, mas foi comentado. Remova este bloco em Program.cs:

O código Program.cs com a seção de autenticação da Microsoft não foi comentado.

Ele precisa de seu próprio registro no aplicativo Entra — separado do do passo 3, para que rotacionar um segredo não possa desativar tanto o login quanto o acesso aos dados. A página de Login do ID do Entra cobre o registro e todos os imóveis necessários.

6. Execute

Pressione F5. O que começa é um portal funcionando, não um shell vazio: páginas de exemplo de Contas e Contatos, as páginas de identidade e gerenciamento de contas, navegação, e configurações de tema e site — tudo isso cabe a você editar.

A solução também inclui um <YourProject>.Tests.Integration projeto com bases para testes de endpoint, permissão e camada de serviço. Veja Testes de Integração.