Rejestrowanie hostowanych serwerów Power BI MCP przy użyciu zewnętrznych klientów MCP (wersja zapoznawcza)

Hostowane serwery Power BI MCP współpracują z klientami MCP dostarczanymi ze wstępnie zarejestrowaną aplikacją Microsoft Entra, takimi jak Visual Studio Code i CLI usługi GitHub Copilot. Inni klienci MCP, tacy jak Claude Desktop i ChatGPT, wymagają identyfikatora klienta OAuth. Microsoft Entra ID nie obsługuje obecnie dynamicznej rejestracji klienta, więc ci klienci nie mogą uzyskać własnego identyfikatora klienta.

Aby obejść to ograniczenie, samodzielnie zarejestruj aplikację Microsoft Entra i przekaż jej identyfikator aplikacji (klienta) do klienta MCP jako identyfikator klienta OAuth.

W poniższej tabeli przedstawiono dwa hostowane serwery i ich punkty końcowe:

W tym artykule pokazano, jak wykonać następujące działania:

• Utwórz i skonfiguruj rejestrację aplikacji Microsoft Entra dla zewnętrznego klienta MCP.
• Zarejestruj hostowany serwer Power BI MCP na kliencie zewnętrznym przy użyciu identyfikatora aplikacji Microsoft Entra.

Wymagania wstępne

• Zatwierdzenie przez administratora. Twój administrator usługi Power BI musi włączyć ustawienie dzierżawy Użytkownicy mogą używać punktu końcowego serwera protokołu Power BI Model Context Protocol (wersja zapoznawcza).
• Uprawnienia do rejestrowania aplikacji. Możesz zarejestrować aplikacje w dzierżawie usługi Microsoft Entra albo współpracować z administratorem dzierżawy, który może zarejestrować aplikację w Twoim imieniu.

Krok 1. Tworzenie rejestracji aplikacji Microsoft Entra

Utwórz nową rejestrację aplikacji w tym samym dzierżawcy Microsoft Entra, w którym znajduje się środowisko Power BI.

1. Zaloguj się do centrum administracyjne Microsoft Entra jako użytkownik, który może rejestrować aplikacje.
2. Przejdź do Rejestracje aplikacji, a następnie wybierz pozycję Nowa rejestracja.
3. Wprowadź zrozumiałą nazwę, na przykład Power BI MCP - Claude Desktop.
4. W obszarze Obsługiwane typy kont wybierz pozycję Konta tylko w tym katalogu organizacyjnym (pojedyncza dzierżawa).
5. Na razie pozostaw pole URI przekierowania puste. Skonfigurujesz go w następnym kroku.
6. Wybierz pozycję Zarejestruj.
7. Na stronie Przegląd aplikacji skopiuj identyfikator aplikacji (klienta). Będzie on używany później podczas konfigurowania klienta MCP.

Krok 2: Skonfiguruj identyfikator URI przekierowania

Zewnętrzni klienci MCP działają jako klienci publiczni, dlatego należy dodać identyfikator URI przekierowania typu Klient publiczny/natywny (mobilny i klasyczny).

1. W ustawieniach rejestracji aplikacji wybierz pozycje Uwierzytelnianie>Dodaj identyfikator URI przekierowania>Aplikacje mobilne i klasyczne.

2. Dodaj URI przekierowania udostępniony przez klienta MCP. Przykład:

   Klient MCP	URI przekierowania
   Claude Desktop	https://claude.ai/api/mcp/auth_callback
   ChatGPT	https://chatgpt.com/connector/oauth/<random_chars>
   Inni klienci	Użyj adresu URL wywołania zwrotnego OAuth, który dokumentuje klient

3. Wybierz pozycję Konfiguruj , aby zapisać konfigurację platformy.

4. Na stronie Uwierzytelnianie w obszarze Ustawienia zaawansowane upewnij się, że ustawienie Zezwalaj na przepływy klientów publicznych ma wartość Nie , chyba że dokumentacja klienta jawnie tego wymaga.

5. Wybierz opcję Zapisz.

Krok 3. Dodawanie delegowanych uprawnień interfejs API usługi Power BI

Hostowane serwery MCP usługi Power BI wywołują interfejsy API REST usługi Power BI w imieniu zalogowanego użytkownika. Udziel delegowanych uprawnień, których potrzebuje twój scenariusz w interfejsie API usługi Power BI.

1. W rejestracji aplikacji wybierz pozycję Uprawnienia interfejsu API>Dodaj uprawnienie.

2. Wybierz pozycję Power BI Service w sekcji Microsoft APIs.

3. Wybierz pozycję Delegowane uprawnienia, a następnie dodaj uprawnienia dla zarejestrowanego serwera.

   Identyfikator URI zasobu: https://analysis.windows.net/powerbi/api

   Scope	Description	Wymagane do
   Dataset.Read.All	Odczyt wszystkich modeli semantycznych, do których masz dostęp.	Serwer zużycia
   MLModel.Execute.All	Wykonywanie modeli uczenia maszynowego.	Serwer zużycia
   Workspace.Read.All	Wyświetlaj obszary robocze, do których masz dostęp.	Serwer tworzenia i korzystania
   SemanticModel.ReadWrite.All	Odczytywanie i zapisywanie wszystkich modeli semantycznych, do których można uzyskać dostęp.	Serwer autorski

4. Wybierz opcję Dodaj uprawnienia.

5. Jeśli dzierżawca wymaga zgody administratora na te uprawnienia, wybierz pozycję Udziel zgody administratora. W przeciwnym razie klient MCP monituje o wyrażenie zgody przy pierwszym logowaniu.

Krok 4. Rejestrowanie serwera w kliencie MCP

Użyj identyfikatora aplikacji (klienta) z kroku 1 jako identyfikatora klienta OAuth podczas dodawania hostowanego serwera Power BI MCP do klienta i użyj punktu końcowego dla żądanego serwera. Dokładne kroki konfiguracji zależą od klienta.

Jeśli logowanie nie powiedzie się, sprawdź, czy:

• Identyfikator URI przekierowania w aplikacji Microsoft Entra dokładnie odpowiada temu, którego oczekuje klient.
• Wymagane delegowane uprawnienia Power BI zostały przyznane i, jeśli wymaga tego dzierżawa, objęte zgodą administratora.
• Ustawienie dzierżawy Użytkownicy mogą używać punktu końcowego serwera protokołu kontekstu modelu Power BI (wersja zapoznawcza) jest włączone.

Rejestrowanie serwera Power BI MCP w Claude Desktop

1. Otwórz program Claude Desktop, a następnie przejdź do pozycjiŁączniki>ustawień>Dodaj łącznik niestandardowy.

2. Wprowadź następujące wartości:

   • Nazwa: Power BI
   • Zdalny adres URL serwera MCP: punkt końcowy serwera, który chcesz zarejestrować.
   • Identyfikator klienta OAuth: identyfikator aplikacji (klienta) z kroku 1.

3. Zapisz konektor. Claude Desktop otwiera okno przeglądarki, aby można było zalogować się przy użyciu konta Microsoft Entra i wyrazić zgodę na żądane uprawnienia Power BI.

Rejestrowanie serwera Power BI MCP w chatGPT

1. W module ChatGPT przejdź do pozycji Ustawienia>Aplikacje>utwórz aplikację.

2. Wypełnij okno dialogowe Nowa aplikacja :

   • Nazwa: Power BI
   • Adres URL serwera MCP: punkt końcowy serwera, który chcesz zarejestrować.
   • Uwierzytelnianie: wybierz pozycję OAuth.

3. Rozwiń pozycję Ustawienia zaawansowane , aby przejrzeć odnalezione ustawienia protokołu OAuth, a następnie skonfiguruj:

   • Metoda rejestracji: Wybierz Klient OAuth zdefiniowany przez użytkownika.
   • Identyfikator klienta OAuth: wprowadź identyfikator aplikacji (klienta) z kroku 1.

4. Wybierz Utwórz. ChatGPT monituje o zalogowanie się przy użyciu konta Microsoft Entra i zgodę na żądane uprawnienia Power BI.

Rejestrowanie serwera Power BI MCP na innych klientach MCP

W przypadku innych klientów MCP postępuj zgodnie z dokumentacją klienta, aby dodać zdalny serwer MCP.

Przetestuj połączenie z serwerem MCP usługi Power BI

Po zarejestrowaniu serwera na kliencie zweryfikuj konfigurację:

1. Rozpocznij nową konwersację na kliencie MCP.
2. Zadaj pytanie, które wymaga serwera. W przypadku serwera Consumption spróbuj What tables are in semantic model [ID of the semantic model]?. W przypadku serwera autorskiego spróbuj użyć Connect to semantic model '[Semantic Model Name]' in Fabric Workspace '[Workspace Name]'.
3. Upewnij się, że klient zwraca wyniki z Power BI.

Treści powiązane

• Serwery MCP dla Power BI
• Serwer MCP do tworzenia w Power BI
• Rozpocznij pracę z serwerem MCP Power BI Consumption
• Rejestrowanie aplikacji za pomocą platformy tożsamości firmy Microsoft
• Specyfikacja protokołu kontekstowego modelu