Wtyczka Zendesk MCP (wersja zapoznawcza)

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

Wtyczka Zendesk MCP

Wtyczka Zendesk MCP łączy Microsoft Copilot środowiska z przepływami pracy obsługi systemu Zendesk. Umożliwia autoryzowanego użytkownika zendesk znajdowanie i przeglądanie biletów pomocy technicznej, inspekcję konwersacji i historii, pobieranie artykułu Przewodnika po systemie Zendesk i wykonywanie obsługiwanych akcji biletów. Serwer udostępnia 17 operacji Zendesk oraz dwa narzędzia wykonawcze i narzędzia schematu. Wyniki i dostępne akcje są zgodne z uprawnieniami konta Zendesk używanego do autoryzowania połączenia.

Prerequisites

• Konto Zendesk z dostępem do odpowiednich biletów i, w przypadku akcji zapisu, uprawnienia do wprowadzania żądanych zmian. Niektóre operacje, w tym wyszukiwanie w usłudze Zendesk i dodawanie tagów biletów, wymagają konta agenta.
• Środowisko Microsoft, które obsługuje certyfikowane serwery MCP i umożliwia organizacji włączenie wtyczki Zendesk MCP.
• Autoryzacja połączenia Zendesk po wyświetleniu monitu przez środowisko Microsoft. Administrator może wymagać włączenia wtyczki w ramach zasad organizacji.

Konfiguracja połączenia i autoryzacja protokołu OAuth

Wtyczka używa przepływu kodu autoryzacji OAuth 2.0. Żąda read zakresu pobierania danych zendesk dostępnych dla autoryzowanego użytkownika oraz write zakresu tworzenia lub aktualizowania rekordów zendesk, które użytkownik może zmienić.

1. Poproś administratora Microsoft 365 lub administratora Copilot o włączenie wtyczki Zendesk MCP, jeśli organizacja wymaga zatwierdzenia przez administratora.
2. Dodaj wtyczkę w obsługiwanym środowisku Microsoft i wybierz opcję, aby nawiązać połączenie lub autoryzować.
3. Po przekierowaniu do aplikacji Zendesk zaloguj się przy użyciu konta Zendesk, którego chcesz użyć, i przejrzyj żądany dostęp przed jego zatwierdzeniem.
4. Po powrocie do środowiska Microsoft sprawdź połączenie z żądaniem tylko do odczytu, takie jak pobieranie bieżącego użytkownika lub wyświetlanie biletów. Połączenie nie może uzyskać dostępu do większej liczby danych ani akcji usługi Zendesk niż autoryzowane konto zezwala.

Punkt końcowy autoryzacji OAuth to https://mcp.zendesk.com/integrations/mcp/oauth/authorize, a punkt końcowy tokenu to https://mcp.zendesk.com/integrations/mcp/oauth/token. Publisher i administratorzy certyfikacji muszą skonfigurować zarejestrowaną wielodostępną aplikację OAuth i udostępnić Microsoft przy użyciu poświadczeń konta testowego i instrukcji konfiguracji za pośrednictwem procesu bezpiecznego przesyłania. Wpisy tajne klienta OAuth, poświadczenia konta testowego i tokeny dostępu lub odświeżania nie mogą być dodawane do tego pakietu ani do publicznej dokumentacji.

Obsługiwane operacje

Możesz na przykład zapytać: "Znajdź otwarte bilety dotyczące nieudanego logowania", "Pokaż komentarze i historię inspekcji biletu 12345", "Jakie są metryki biletu 12345?", lub "Wersja robocza odpowiedzi publicznej dla biletu 12345". Tworzenie, aktualizowanie, komentowanie, zmiana tagu lub akcja zbiorcza zmienia dane systemu Zendesk; przed potwierdzeniem zawartości w środowisku Microsoft przejrzyj docelową i proponowaną zawartość.

Operacją łącznika InvokeMCP jest transport HTTP możliwy do przesyłania strumieniowego używany przez Microsoft Copilot Studio na potrzeby negocjacji protokołu MCP, dynamiczne odnajdywanie narzędzi i wykonywanie narzędzi. Jest ona oznaczona jako zaawansowana operacja transportu, a nie akcja biznesowa skierowana do klienta. Testowanie certyfikacji powinno zweryfikować żądanie inicjowania MCP w okienku testowym łącznika niestandardowego, a następnie dodać łącznik do agenta Copilot Studio i wykonać dynamicznie odnalezione narzędzia Zendesk przy użyciu bezpiecznie dostarczonego konta testowego. Ogólne okienko Test może zgłaszać nieprzetworzone odpowiedzi SSE jako ciąg względem niejawnego kontraktu obiektu; 200 odpowiedź z Content-Type: text/event-stream prawidłowym wynikiem inicjowania MCP potwierdza transport, podczas gdy kompleksowe odnajdywanie narzędzi powinno zostać zweryfikowane w Copilot Studio.

Znane problemy i ograniczenia

• Dostęp jest ograniczony do uprawnień zendesk autoryzowanego konta. Bilet lub artykuł, do którego konto nie może uzyskać dostępu, może nie zostać zwrócone.
• Wyszukiwanie w aplikacji Zendesk Support wymaga składni wyszukiwania Zendesk i używa stronicowania przesunięcia. Na przykład type:ticket status:open znajduje otwarte bilety. Duże zestawy wyników mogą wymagać stronicowania lub węższego zapytania.
• Ten pakiet pobiera artykuł podręcznika zendesk według identyfikatora. Nie uwidacznia oddzielnego wyszukiwania artykułów przewodnika ani narzędzi konspektu.
• Zbiorcze operacje tworzenia i aktualizowania akceptują co najwyżej 100 biletów na żądanie i są uruchamiane jako zadania w tle. Przed założeniem, że wszystkie zmiany zakończyły się pomyślnie, sprawdź ich stan ukończenia.
• Aktualizacje biletów mogą wyzwalać reguły biznesowe i powiadomienia systemu Zendesk. Publiczny komentarz może być widoczny dla żądającego. Dodawanie tagów obsługuje opcję bezpiecznej aktualizacji: użyj najnowszej updated_at wartości biletu do safe_update: true wykrywania współbieżnych zmian; nieaktualna wartość zwraca konflikt.
• Przesyłane strumieniowo operacje transportu MCP są przeznaczone dla agentów sztucznej inteligencji i nie są widoczne jako zwykłe akcje w tradycyjnym projektancie przepływów Power Automate.
• Ten zestaw ukierunkowanych narzędzi nie uwidacznia operacji konfiguracji administracyjnej systemu Zendesk.

Pomoc techniczna i prawna

Aby uzyskać pomoc, skontaktuj się z pomocą techniczną Zendesk lub odwiedź witrynę Zendesk. Zobacz Informacje o ochronie prywatności w systemie Zendesk i warunki użytkowania.

Akcje

Korzystanie z narzędzi Zendesk