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 (protocolo de contexto de modelo) que não seja da Microsoft. Este exemplo descreve como se conectar usando Claude.

Pré-requisitos

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

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

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

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

2. Selecione Conexões no painel de navegação esquerdo e, em seguida, selecione + Nova conexão na barra de comandos.

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

4. Preencha as instruções em sua tela.

   Anote o nome de usuário no Nome da conexão, esse deve ser o mesmo nome que você usou para criar o ambiente anteriormente.

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

Instalar o proxy do local do servidor MCP do Dataverse

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

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

   winget install Microsoft.DotNet.SDK.8

2. Em uma janela do 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 a ID de locatário do seu ambiente do Dataverse

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

Aqui está uma maneira de obter detalhes da ID do locatário:

1. Vá até Power Apps.
2. Selecione Configurações (ícone de engrenagem) no canto superior direito e selecione Detalhes da sessão.
3. Copie o valor da ID do Locatário nos detalhes da sessão do Power Apps para a área de transferência do Windows. Anote esse GUID porque ele é usado nas etapas de configuração posteriores.

Configurar e usar o servidor MCP do Dataverse no Claude

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

Baixar o Claude desktop

Se você ainda não fez isso, baixe e instale a área de trabalho do Claude.

Após você ter o Claude para desktop instalado, você pode localizar e iniciar o Claude na sua área de trabalho.

Configurar o servidor MCP do Dataverse no Claude desktop

1. Abra o Claude desktop e vá para Arquivo>Configurações.

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

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

4. Substitua <a URL de conexão> e a <ID do Locatário> com a URL de conexão e a ID do locatário e cole o snippet JSON na seção indicada do arquivo. Mais informações: Criar uma conexão do Dataverse para a configuração do MCP e Obter a ID do locatário do ambiente do Dataverse

   Use um <nome amigável> para o servidor MCP do Dataverse do qual você possa se lembrar facilmente, por exemplo: MyDataverseMCPServer.

{
     "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. Salve este arquivo e volte para a área de trabalho do Claude.

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

1. Reinicie a área de trabalho do Claude e verifique se as alterações entrarão em vigor. SelecioneArquivo>Sair.
2. Abra o Claude desktop agora que a configuração do servidor MCP do Dataverse foi concluída a partir da etapa anterior. É necessário usar suas credenciais para entrar no ambiente do Dataverse.
3. Verifique se você pode exibir o servidor MCP do Dataverse e as ferramentas selecionando Pesquisar e ferramentas. Você deve ser capaz de observar o nome amigável do servidor MCP do Dataverse, MyDataverseMCPServer , por exemplo.
4. Selecionar o servidor MCP (MyDataverseMCPServer) permite que você exiba a lista de ferramentas com suporte desse servidor MCP.

Interagir com o servidor MCP do Dataverse no Claude desktop

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

Artigos relacionados

Conecte-se ao Dataverse com o Protocolo de Contexto de Modelo