Nawiązywanie połączenia z usługą Dataverse przy użyciu protokołu kontekstu modelu w klientach innych niż Microsoft

Możesz nawiązać połączenie z platformą Microsoft Dataverse przy użyciu klienta innego niż Microsoft Protokołu kontekstu modelu (MCP), takiego jak Claude Desktop lub Claude Code. Istnieją dwa podejścia do łączenia klientów innych niż Microsoft z serwerem MCP usługi Dataverse:

  • Lokalny serwer proxy: użyj @microsoft/dataverse pakietu npm, aby uruchomić lokalny serwer proxy, który łączy się z serwerem MCP usługi Dataverse w Twoim imieniu.
  • Zdalny punkt końcowy: Połącz się bezpośrednio ze zdalnym punktem końcowym serwera usługi Dataverse MCP (/api/mcp), rejestrując niestandardową aplikację Microsoft Entra.

Wymagania wstępne

Nawiązywanie połączenia przy użyciu lokalnego serwera proxy

Pakiet @microsoft/dataverse npm udostępnia lokalny serwer proxy obsługujący uwierzytelnianie i komunikację z serwerem MCP usługi Dataverse. To podejście jest zalecane w przypadku większości klientów mcp innych niż Microsoft, którzy mogą uruchamiać lokalne serwery MCP.

Administrator dzierżawy musi udzielić zgody administracyjnej na aplikację interfejsu wiersza polecenia Dataverse, zanim użytkownicy będą mogli się uwierzytelnić. Przejdź do następującego adresu URL w przeglądarce, zastępując ciąg {your-tenant-id} identyfikatorem dzierżawy Microsoft Entra.

https://login.microsoftonline.com/{your-tenant-id}/adminconsent?client_id=0c412cc3-0dd6-449b-987f-05b053db9457

Zaloguj się przy użyciu konta administratora dzierżawy i zaakceptuj monit o uprawnienia. Ten krok należy wykonać tylko raz na najemcę.

Włącz klienta CLI Dataverse w centrum administracyjnym Power Platform

Aby można było nawiązać połączenie przy użyciu lokalnego serwera proxy, klient interfejsu wiersza polecenia usługi Dataverse musi być włączony jako dozwolony klient MCP w danym środowisku.

  1. Przejdź do centrum administracyjnego platformy Power Platform. Wybierz pozycję Zarządzaj>środowiskami.
  2. Wybierz środowisko, w którym chcesz włączyć klienta, a następnie wybierz pozycję Ustawienia.
  3. W obszarze Ustawienia wybierz pozycjęFunkcje>. Przewiń w dół, aby zlokalizować protokół kontekstu modelu usługi Dataverse i wybierz pozycję Ustawienia zaawansowane.
  4. Znajdź klienta interfejsu wiersza polecenia usługi Dataverse (identyfikator 0c412cc3-0dd6-449b-987f-05b053db9457aplikacji) i ustaw wartość Włączone na Wartość Tak.
  5. Wybierz opcję Zapisz i zamknij.

Uwaga / Notatka

Jeśli wpis Dataverse CLI nie jest wyświetlany na liście dostępnych klientów, możesz dodać go ręcznie. Utwórz nowy wpis klienta o dowolnej nazwie i określ identyfikator 0c412cc3-0dd6-449b-987f-05b053db9457aplikacji , a następnie włącz go.

Instalowanie lokalnego serwera proxy

Pakiet można zainstalować @microsoft/dataverse globalnie lub uruchomić go bezpośrednio za pomocą npx.

Aby zainstalować globalnie, uruchom następujące polecenie w terminalu:

npm install -g @microsoft/dataverse

Alternatywnie możesz użyć npx polecenia , aby uruchomić serwer proxy bez konieczności instalowania go globalnie:

npx @microsoft/dataverse mcp https://yourorg.crm.dynamics.com

Wskazówka

Aby nawiązać połączenie z punktem końcowym wersji demonstracyjnej (/api/mcp_preview) zamiast ogólnie dostępnego punktu końcowego (/api/mcp), dodaj parametr --preview do polecenia. Na przykład: npx @microsoft/dataverse mcp https://yourorg.crm.dynamics.com --preview. Punkt końcowy trybu podglądu musi być włączony w danym środowisku. Więcej informacji: Korzystanie z narzędzi w wersji zapoznawczej i nadchodzących funkcji na serwerze MCP Dataverse

Konfigurowanie lokalnego serwera proxy na pulpicie Claude'a

W tej sekcji opisano sposób konfigurowania lokalnego serwera proxy MCP usługi Dataverse na pulpicie Claude'a. Jeśli jeszcze tego nie zrobiono, pobierz i zainstaluj aplikację Claude Desktop.

  1. Otwórz Claude i przejdź do Plik>, Ustawienia>, Deweloper.

  2. Wybierz pozycję Edytuj konfiguracjęclaude_desktop_config.json, aby otworzyć plik.

  3. Dodaj następujący fragment kodu JSON do pliku. Zastąp <friendly name> ciąg nazwą, którą można łatwo zapamiętać (na przykład MyDataverseMCPServer), i zastąp <your org URL> ciąg adresem URL środowiska Dataverse (na przykład https://contoso.crm.dynamics.com).

    {
  "mcpServers": {
    "<friendly name>": {
      "command": "npx",
      "args": [
        "-y",
        "@microsoft/dataverse",
        "mcp",
        "<your org URL>"
      ]
    }
  }
}

  4. Zapisz plik.

Weryfikowanie połączenia w programie Claude Desktop

  1. Zamknij pulpit Claude'a, wybierając pozycję Plik>Zakończ, a następnie ponownie otwórz go, aby zastosować zmiany.
  2. Zaloguj się przy użyciu swoich poświadczeń, gdy zostaniesz o to poproszony, aby uwierzytelnić się w środowisku Dataverse.
  3. Wybierz pozycję Wyszukaj i narzędzia, aby sprawdzić, czy serwer MCP Dataverse i jego narzędzia są dostępne. Powinna zostać wyświetlona przyjazna nazwa skonfigurowana (na przykład MyDataverseMCPServer).
  4. Wybierz nazwę serwera MCP, aby wyświetlić listę narzędzi obsługiwanych przez serwer.

Wskazówka

Można włączać i wyłączać poszczególne narzędzia dla każdego serwera MCP zarejestrowanego w programie Claude Desktop. Dzięki temu możesz kontrolować, które narzędzia są dostępne do użycia.

Konfigurowanie lokalnego serwera proxy w aplikacji Claude Code

W tej sekcji opisano sposób konfigurowania lokalnego serwera proxy MCP usługi Dataverse w programie Claude Code. Jeśli jeszcze tego nie zrobiono, pobierz i zainstaluj program Claude Code.

Uruchom następujące polecenie, aby dodać serwer Dataverse MCP. Zastąp https://yourorg.crm.dynamics.com adresem URL środowiska Dataverse.

claude mcp add dataverse -t stdio -- npx -y @microsoft/dataverse mcp https://yourorg.crm.dynamics.com

Weryfikowanie połączenia i interakcja z nim w aplikacji Claude Code

  1. Uruchom ponownie program Claude Code, aby zastosować zmiany.
  2. Zaloguj się przy użyciu swoich poświadczeń, gdy zostaniesz o to poproszony, aby uwierzytelnić się w środowisku Dataverse.
  3. Sprawdź, czy serwer MCP usługi Dataverse i jego narzędzia są dostępne. Powinna zostać wyświetlona przyjazna nazwa skonfigurowana (na przykład MyDataverseMCPServer).
  4. Wybierz nazwę serwera MCP, aby wyświetlić listę narzędzi obsługiwanych przez serwer.

Jeśli masz dane w środowisku Usługi Dataverse, możesz przetestować konfigurację, pytając o wyświetlenie tabel w usłudze Dataverse, opisanie tabeli kont lub liczbę posiadanych kont. Aby uzyskać więcej informacji, zobacz Dodawanie i usuwanie przykładowych danych

Wskazówka

Jeśli masz inne serwery MCP zarejestrowane w programie Claude Code, dołącz usługę Dataverse w wierszu polecenia, aby określić, który serwer MCP ma być używany.

Nawiązywanie połączenia przy użyciu zdalnego punktu końcowego

Klienci mcP innych firm mogą łączyć się bezpośrednio z zdalnym punktem końcowym serwera MCP usługi Dataverse bez użycia lokalnego serwera proxy. Takie podejście wymaga zarejestrowania aplikacji niestandardowej w usłudze Microsoft Entra ID i dodania identyfikatora klienta do listy dozwolonych klientów w centrum administracyjnym platformy Power Platform.

Rejestrowanie niestandardowej aplikacji Microsoft Entra

Zarejestruj aplikację w usłudze Microsoft Entra ID do użycia do uwierzytelniania podczas nawiązywania połączenia z serwerem MCP usługi Dataverse. Aby uzyskać ogólne informacje na temat rejestracji aplikacji, zobacz Rejestrowanie aplikacji za pomocą platformy tożsamości firmy Microsoft.

Wykonaj następujące kroki, aby zarejestrować aplikację do użycia z serwerem Usługi Dataverse MCP:

  1. Zaloguj się do centrum administracyjnego firmy Microsoft Entra.
  2. Przejdź do pozycji Identity>Applications>, a następnie wybierz pozycję Nowa rejestracja.
  3. Wprowadź nazwę aplikacji (na przykład klienta MCP Platformy Dataverse), skonfiguruj obsługiwane typy kont dla danego scenariusza, a następnie wybierz pozycję Zarejestruj.
  4. Na stronie Przegląd zanotuj identyfikator aplikacji (klienta). Ta wartość jest potrzebna do skonfigurowania dozwolonego klienta w centrum administracyjnym platformy Power Platform i skonfigurowania klienta MCP.

Konfigurowanie uprawnień interfejsu API dla serwera MCP usługi Dataverse

Po zarejestrowaniu aplikacji należy przyznać jej uprawnienia dostępu do serwera MCP Dataverse.

  1. W rejestracji aplikacji wybierz Uprawnienia interfejsu API z lewego panelu nawigacyjnego.
  2. Wybierz opcję Dodaj uprawnienie.
  3. Wybierz pozycję Interfejsy API firmy Microsoft, a następnie wybierz pozycję Dynamics CRM.
  4. Wybierz uprawnienie mcp.tools , a następnie wybierz pozycję Dodaj uprawnienia.

Uwaga / Notatka

Przepływ uwierzytelniania używany przez aplikację Entra zależy od używanego klienta MCP. Zapoznaj się z dokumentacją klienta MCP, aby zapoznać się z obsługiwanymi metodami uwierzytelniania.

Dodawanie aplikacji niestandardowej do listy dozwolonych klientów

Po zarejestrowaniu aplikacji Entra dodaj identyfikator klienta do listy dozwolonych klientów MCP dla danego środowiska.

  1. Przejdź do centrum administracyjnego platformy Power Platform. Wybierz pozycję Zarządzaj>środowiskami.
  2. Wybierz środowisko, w którym chcesz zezwolić klientowi, a następnie wybierz pozycję Ustawienia.
  3. W obszarze Ustawienia wybierz pozycjęFunkcje>. Przewiń w dół, aby zlokalizować protokół kontekstu modelu usługi Dataverse i wybierz pozycję Ustawienia zaawansowane.
  4. Dodaj nowy wpis klienta. Wprowadź nazwę klienta i określ identyfikator aplikacji (klienta) z rejestracji aplikacji Entra.
  5. Ustaw Włączone na Tak.
  6. Wybierz opcję Zapisz i zamknij.

Nawiązywanie połączenia z zdalnym punktem końcowym

Skonfiguruj klienta MCP, aby nawiązać połączenie z serwerem MCP usługi Dataverse pod następującym adresem URL:

https://<your org URL>/api/mcp

Na przykład: https://contoso.crm.dynamics.com/api/mcp

Użyj identyfikatora aplikacji (klienta) z rejestracji aplikacji Entra na potrzeby uwierzytelniania. Zapoznaj się z dokumentacją klienta MCP, aby uzyskać szczegółowe instrukcje konfiguracji.

Nawiązywanie połączenia z usługą Dataverse przy użyciu protokołu kontekstu modelu

  • Ostatnia aktualizacja o