다음을 통해 공유


비 Microsoft 클라이언트에서 모델 컨텍스트 프로토콜을 사용하여 Dataverse에 연결

MCP(비 Microsoft 모델 컨텍스트 프로토콜) 클라이언트를 사용하여 Microsoft Dataverse에 연결합니다. 이 예제에서는 Claude를 사용하여 연결하는 방법을 설명합니다.

필수 조건

다음은 Claude와 함께 Dataverse MCP 서버를 사용하기 위한 필수 구성 요소입니다.

  • PPAC 설정을 통해 환경에 대해 Dataverse MCP 서버를 사용하도록 설정합니다. 추가 정보: 환경에 대한 Dataverse MCP 서버 구성 및 관리
  • MCP 구성에 대한 Dataverse 연결입니다.
  • Dataverse MCP 서버 로컬 프록시를 설치합니다.
  • Dataverse 환경의 테넌트 ID입니다.

비고

현재는 Claude 데스크톱만 지원됩니다.

MCP 구성을 위한 Dataverse 연결 만들기

  1. Power Automate로 이동합니다. 필요한 경우 오른쪽 상단에서 선택하여 올바른 환경으로 변경합니다.

  2. 왼쪽 탐색 창에서 연결을 선택한 다음, 명령 모음에서 + 새 연결을 선택합니다.

  3. 검색 상자에 Dataverse를 입력한 다음 Microsoft Dataverse 커넥터를 선택합니다.

  4. 화면의 지시를 완료합니다.

    연결 이름에서 사용자 이름을 기록해 둡다. 이 이름은 이전에 환경을 만드는 데 사용한 이름과 같아야 합니다.

  5. 연결을 선택하여 엽니다. 메시지가 표시되면 이 URL을 붙여넣습니다. https://make.preprod.powerautomate.com/environments/fb6637eb-601d-e9d2-b7f0-1613fca29e7e/connections?apiName=shared_commondataserviceforapps&connectionName=64244f45b6f045299463becb30bcd9b8

Dataverse MCP 서버 로컬 프록시 설치

이 단계에서는 Claude 데스크톱이나 VS Code GitHub Copilot과 같이 MCP 클라이언트에서 사용되는 Dataverse MCP 서버 로컬 프록시를 설치합니다.

  1. 다운로드에서 또는 이 PowerShell 명령을 사용하여 .NET SDK 8.0을 설치합니다.

    winget install Microsoft.DotNet.SDK.8

  2. Windows 터미널 창에서 이 명령을 실행하여 Microsoft PowerPlatform.Dataverse.MCP 로컬 프록시를 설치합니다.

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

Dataverse 환경의 테넌트 ID 가져오기

Claude 데스크톱이나 VS Code GitHub에 대해 Dataverse MCP 서버를 구성하는 경우 TenantID 값을 제공해야 합니다.

테넌트 ID 세부 정보를 가져오는 한 가지 방법은 다음과 같습니다.

  1. Power Apps로 이동합니다.
  2. 오른쪽 상단의 설정(기어 아이콘)을 선택한 다음, 세션 세부 정보를 선택합니다.
  3. Power Apps 세션 세부 정보에서 Windows 클립보드로 테넌트 ID 값을 복사합니다. 이 GUID는 나중에 구성 단계에서 사용되므로 기록해 둡니다.

Claude에서 Dataverse MCP 서버 구성 및 사용

Claude AI는 Anthropic에서 개발한 대규모 언어 모델(LLM) 및 챗봇입니다. 자연어 처리에 탁월하고 멀티모달이므로 텍스트, 오디오 및 시각적 입력을 처리할 수 있습니다. Claude는 질문에 답하고, 문서를 요약하고, 텍스트를 생성하고, 다이어그램, 애니메이션 및 코드를 만들 수도 있습니다.

Claude 데스크톱 다운로드

아직 설치하지 않은 경우 Claude 데스크톱을 다운로드하여 설치합니다.

Claude 데스크톱을 설치한 후 데스크톱에서 Claude를 찾아서 시작할 수 있습니다.

Claude 데스크톱에서 Dataverse MCP 서버 구성

  1. Claude 데스크톱을 열고 파일>설정으로 이동합니다.

  2. 이전에 Claude 데스크톱에 대해 MCP 서버를 구성하지 않은 경우, 설정 대화 상자가 표시됩니다. Config 편집을 선택합니다.

  3. Claude 데스크톱 파일이 표시됩니다. claude_desktop_config.json 즐겨 찾는 JSON 편집기를 사용하여 파일을 엽니다.

  4. <연결 URL> 및 <테넌트 ID>를 연결 URL테넌트 ID로 바꾸고 JSON 코드 조각을 파일의 적절한 섹션에 붙여넣습니다. 추가 정보: MCP 구성에 대한 Dataverse 연결 만들기Dataverse 환경의 테넌트 ID 가져오기

    쉽게 기억할 수 있는 Dataverse MCP 서버의 <식별 이름>을 사용합니다. 예를 들어: 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"
         ]
       }
     }
   }
  1. 이 파일을 저장하고 Claude 데스크톱으로 돌아갑니다.

Claude 데스크톱에서 연결을 확인하고, 인터렉션을 통해 상호작용하기

  1. Claude 데스크톱을 다시 시작하고 변경 내용이 적용되는지 확인합니다. 파일>끝내기를 선택하세요.
  2. 이전 단계에서 Dataverse MCP 서버 구성이 완료되었으므로 이제 Claude 데스크톱을 엽니다. Dataverse 환경에 로그인하려면 자격 증명을 사용해야 합니다.
  3. 검색 및 도구를 선택하여 Dataverse MCP 서버 및 도구를 볼 수 있는지 확인합니다. 예를 들어 Dataverse MCP 서버, MyDataverseMCPServer 의 친숙한 이름을 확인할 수 있어야 합니다. Dataverse를 사용하여 Claude 데스크톱 연결 확인
  4. MCP 서버(MyDataverseMCPServer)를 선택하면 해당 MCP 서버에서 지원하는 도구 목록을 볼 수 있습니다.

팁 (조언)

Claude에 등록된 각 MCP 서버에 대해 개별 도구를 활성화 및 비활성화할 수 있습니다. 이렇게 하면 사용할 도구를 제어할 수 있습니다.

Claude 데스크톱에서 Dataverse MCP 서버와 상호 작용

Dataverse 환경에 데이터가 있는 경우 Dataverse의 목록 테이블을 요청하거나, 테이블 계정을 설명하거나, 가지고 있는 계정 수 등을 요청하여 설치 테스트를 시작할 수 있습니다. 추가 정보: 샘플 데이터 추가 및 제거

팁 (조언)

다른 MCP 서버가 Claude에 등록된 경우 사용하려는 MCP 서버에 대해 구체적으로 지정하도록 프롬프트의 Dataverse에 추가하는 것이 가장 좋습니다.

모델 컨텍스트 프로토콜을 사용하여 Dataverse에 연결