Conectar-se ao Dataverse com o protocolo de contexto de modelo em clientes que não são da Microsoft

Conecte-se ao Microsoft Dataverse usando um cliente MCP (model context protocol) que não seja da Microsoft. Este exemplo descreve como se conectar usando Claude.

Pré-requisitos

Estes são os pré-requisitos para usar um servidor Dataverse MCP com Claude.

• Habilite o servidor Dataverse MCP para o ambiente por meio das configurações do PPAC. Para obter mais informações: Configurar e gerenciar o servidor Dataverse MCP para um ambiente
• Uma conexão Dataverse para a configuração MCP.
• Instale o proxy local do servidor Dataverse MCP.
• O ID do inquilino do seu ambiente do Dataverse.

Criar uma ligação do Dataverse para a configuração MCP

1. Vá para Power Automate. Se necessário, altere para o ambiente correto selecionando-o no canto superior direito.

2. Selecione Ligações no painel de navegação esquerdo e, em seguida, selecione +Nova ligação na barra de comando.

3. Digite Dataverse na caixa de pesquisa e selecione o conector Microsoft Dataverse .

4. Siga as instruções no ecrã.

   Anote o nome de usuário na conexão Name, este deve ser o mesmo nome que você usou para criar o ambiente anteriormente.

5. Selecione a conexão para abri-la. Cole este URL quando lhe for pedido. https://make.preprod.powerautomate.com/environments/fb6637eb-601d-e9d2-b7f0-1613fca29e7e/connections?apiName=shared_commondataserviceforapps&connectionName=64244f45b6f045299463becb30bcd9b8

Instalar o proxy local do servidor MCP do Dataverse

Estes passos instalam o proxy local do servidor MCP do Dataverse usado pelo cliente MCP, como o Claude desktop ou o VS Code GitHub Copilot.

1. Instale o .NET SDK 8.0 a partir do download ou com este comando do PowerShell.

   winget install Microsoft.DotNet.SDK.8

2. Em uma janela de terminal do Windows, execute este comando para instalar o proxy local da Microsoft PowerPlatform.Dataverse.MCP .

   dotnet tool install --global --add-source https://api.nuget.org/v3/index.json Microsoft.PowerPlatform.Dataverse.MCP

Obter o ID do inquilino do seu ambiente do Dataverse

Ao configurar o servidor MCP do Dataverse para o Claude Desktop ou o VS Code GitHub, precisa de fornecer o valor TenantID.

Eis uma forma de obter os detalhes do ID do inquilino:

1. Aceder ao Power Apps
2. Selecione Definições (ícone de engrenagem) no canto superior direito e, em seguida, selecione Detalhes da sessão.
3. Copie o valor do ID do Inquilino a partir dos detalhes da sessão do Power Apps para a área de transferência do Windows. Anote este GUID porque será usado posteriormente nos passos de configuração.

Configurar e utilizar o servidor MCP do Dataverse no Claude

O Claude AI é um grande modelo de linguagem (LLM) e chatbot desenvolvido pela Anthropic. Destaca-se no processamento de linguagem natural e é multimodal, o que significa que pode processar entradas de texto, áudio e de elementos visuais. Claude pode responder a perguntas, resumir documentos, gerar texto e até mesmo criar diagramas, animações e código.

Transferir o Claude desktop

Se ainda não o fez, transfira e instale o Claude desktop.

Depois de ter o Claude desktop instalado, você pode encontrar e iniciar o Claude a partir do seu desktop.

Configurar o servidor MCP do Dataverse no Claude desktop

1. Abra o Claude desktop e aceda a Ficheiro>Definições.

2. Se não configurou anteriormente nenhum servidor MCP para o Claude desktop, observará uma caixa de diálogo Definições. Selecione Editar Configuração.

3. Os arquivos da área de trabalho Claude são exibidos. Abra o claude_desktop_config.json arquivo com seu editor JSON favorito.

4. Substitua <a URL> de conexão e <a ID> do locatário pela URL de conexão e pela ID do locatário e cole o trecho JSON na seção apropriada do arquivo. Mais informações: Criar uma ligação do Dataverse para a configuração do MCP e Obter o ID do inquilino do seu ambiente do Dataverse

   Use um <nome amigável> para o seu servidor MCP do Dataverse de que possa lembrar-se facilmente, por exemplo: MeuServidorMCPDataverse.

{
     "mcpServers": {
    "<friendly name>": {
      "command": "Microsoft.PowerPlatform.Dataverse.MCP",
      "args": [
        "--ConnectionUrl",
        "<URL for Dataverse connection>",
        "--MCPServerName",
        "DataverseMCPServer",
        "--TenantId",
        "<Tenant Id GUID>",
        "--EnableHttpLogging",
        "true",
        "--EnableMsalLogging",
        "false",
        "--Debug",
        "false",
        "--BackendProtocol",
        "HTTP"
         ]
       }
     }
   }

5. Guarde este ficheiro e regresse ao Claude desktop.

Verificar e interagir com a conexão na área de trabalho do Claude

1. Reinicie a área de trabalho Claude e certifique-se de que as alterações entrem em vigor. Selecione Ficheiro>Sair.
2. Abra o Claude desktop agora que a configuração do servidor MCP do Dataverse foi concluída no passo anterior. Precisa de utilizar as suas credenciais para iniciar sessão no seu ambiente do Dataverse.
3. Verifique se pode ver o servidor MCP do Dataverse e as ferramentas ao selecionar Pesquisa e ferramentas. Você deve ser capaz de observar o nome amigável do seu servidor Dataverse MCP, por exemplo, MyDataverseMCPServer.
4. Selecionar o servidor MCP (MyDataverseMCPServer) permite visualizar a lista de ferramentas suportadas por esse servidor MCP.

Interagir com o servidor MCP do Dataverse no Claude desktop

Se você tiver dados no ambiente Dataverse, poderá começar a testar sua configuração perguntando tabelas de lista no Dataverse, descrever a conta da tabela ou quantas contas eu tenho, e assim por diante. Mais informações: Adicionar e remover dados de amostra

Artigos relacionados

Conectar-se ao Dataverse com o Model Context Protocol