D365 CX MCP Server (wersja zapoznawcza)

Dynamics 365 CX MCP Server, umożliwiając użytkownikom interakcję z narzędziami Dynamics 365 Customer Engagement MCP za pośrednictwem bramy agenta.

Ten łącznik jest dostępny w następujących produktach i regionach:

Dynamics 365 CX MCP Server

Serwer Dynamics 365 CX MCP zapewnia obsługiwane Microsoft środowiska z dostępem do Dynamics 365 Customer Engagement możliwości za pośrednictwem bramy agenta.

Wydawca: Microsoft

Wymagania wstępne

• Konto Microsoft Entra ID
• Dostęp do wymaganego środowiska i danych Dynamics 365
• Wszystkie zasady dzierżawy wymagane przez środowisko korzystania z tego łącznika

Obsługiwane operacje

Dynamics 365 CX MCP Server

Udostępnia dostępne narzędzia Dynamics 365 Customer Engagement MCP.

Uzyskiwanie poświadczeń

Zaloguj się przy użyciu konta Microsoft Entra ID i zgody po wyświetleniu monitu. Nie jest wymagany żaden klucz interfejsu API ani ręcznie utworzony wpis tajny.

Wprowadzenie

Użyj łącznika z obsługiwanego środowiska Microsoft i zaloguj się po wyświetleniu monitu.

Użyj narzędzi wyboru środowiska MCP, aby wybrać środowisko Dynamics 365 po wyświetleniu monitu. Kolejne wywołania narzędzia używają wybranego środowiska usługi MCP dla użytkownika i dzierżawy, a nie środowiska platformy Power Platform, które hostuje połączenie łącznika. Adres URL punktu końcowego MCP nie zmienia się podczas przełączania środowisk.

Kontekst aplikacji wywołującej

Łącznik przekazuje identyfikator aplikacji uwierzytelniojącego obiektu wywołującego do bramy agenta w programie x-ms-clientAppIdprzed zastąpieniem tokenu autoryzacji. Preferuje on identyfikator aplikacji obliczonej przez zasady platformy Power Platform. W przeciwnym razie usuwa appid oświadczenie lub azp z oryginalnej autoryzacji obiektu wywołującego zachowanego przez serwer. Używa on bieżącego tokenu elementu nośnego przychodzącego tylko wtedy, gdy zapisany kontekst jest nieobecny; niezdatny do użycia zapisany kontekst nigdy nie wraca do możliwego tokenu zaplecza. Nigdy nie ufa podanemu x-ms-clientAppId nagłówkowi. Jeśli nie jest dostępny identyfikator aplikacji do użycia, usuwa ten nagłówek i rejestruje brakujące przypisanie bez niepowodzenia żądania MCP. Identyfikuje obiekt wywołujący, który dociera do platformy Power Platform, co może być pośrednikiem; nie może odróżnić powierzchni, które udostępniają rejestrację aplikacji, taką jak Word, Excel i PowerPoint. Brama agenta wymaga oddzielnej obsługi, aby przekazać ten kontekst do mcp. Ta zmiana nie zmienia autoryzacji ani rozliczeń.

Łącznik przekazuje również kontekst żądania sztucznej inteligencji w pliku x-ms-ai-billing-service-id (inicjowanie obciążenia rozliczeniowego), x-ms-ai-tenant-id (dzierżawa klienta), x-ms-ai-user-id (opcjonalny przypisany użytkownik) i x-ms-ai-correlation-id (klucz sprzężenia między usługami). Każdy musi zawierać jeden identyfikator UUID; akceptowane wartości są znormalizowane bez zmieniania ich tożsamości. Brakujące lub puste wartości są pomijane, podobnie jak identyfikator UUID użytkownika bez zera. Źle sformułowane lub powtarzające się wartości są usuwane z diagnostyką, która nie zawiera ich wartości; żądanie narzędzia jest kontynuowane. Prawidłowe pola są przekazywane niezależnie, bez wyprowadzania brakujących wartości z oświadczeń protokołu OAuth lub generowania identyfikatorów.

Są to kontekst dostarczony przez obiekt wywołujący, a nie uwierzytelnione tożsamości rozliczeń lub autoryzacji. Przypisany użytkownik nie musi być podmiotem tokenu delegowanego. Brama agenta musi oddzielnie obsługiwać przekazywanie tych nagłówków do mcp; ta zmiana łącznika nie włącza pomiarów ani nie zmienia decyzji dotyczących rozliczeń.

Znane problemy i ograniczenia

• Ten łącznik jest w wersji zapoznawczej, a jego możliwości mogą ulec zmianie przed ogólną dostępnością.
• Dostępność i możliwości zależą od konfiguracji dzierżawy i uprawnień zalogowanych użytkowników.
• Łącznik nie udziela dostępu do danych ani możliwości, których zalogowany użytkownik nie ma jeszcze autoryzacji do użycia.
• Wybór środowiska jest współużytkowany dla użytkownika i dzierżawy w obsługiwanych środowiskach; nie jest izolowana na konwersację.
• Pamiętanie wyboru między wystąpieniami usługi zależy od pomyślnego zapisania go przez usługę MCP. Jeśli brakuje wybranego środowiska lub jest ono nieoczekiwane, sprawdź lub ponownie wybierz je przed wywołaniem narzędzi do obsługi danych.

Instrukcje dotyczące wdrażania

Ten łącznik Microsoft firmy first-party jest wdrażany i zarządzany przez Microsoft.

Support

Odwiedź pomoc techniczna firmy Microsoft, aby uzyskać pomoc.

Tworzenie połączenia

Łącznik obsługuje następujące typy uwierzytelniania:

Logowanie przy użyciu Microsoft Entra ID

Identyfikator uwierzytelniania: certOauth

Dotyczy: wszystkie regiony

Podaj poświadczenia Microsoft Entra ID przy użyciu certyfikatu PFX i hasła

Jest to możliwe do udostępnienia połączenie. Jeśli aplikacja power jest udostępniana innemu użytkownikowi, połączenie jest również udostępniane. Aby uzyskać więcej informacji, zobacz Omówienie łączników dla aplikacji kanwy — Power Apps | Microsoft Docs

Domyślne [PRZESTARZAŁE]

Dotyczy: wszystkie regiony

Ta opcja dotyczy tylko starszych połączeń bez jawnego typu uwierzytelniania i jest dostępna tylko w celu zapewnienia zgodności z poprzednimi wersjami.

Nie jest to możliwe do udostępnienia połączenie. Jeśli aplikacja power zostanie udostępniona innemu użytkownikowi, zostanie wyświetlony monit o jawne utworzenie nowego połączenia.

Akcje

Dynamics 365 CX MCP Server