Perk MCP (wersja zapoznawcza)
Planowanie podróży biznesowych i zarządzanie podróżami, wydatkami i zatwierdzeniami za pomocą umowy MCP na platformie Perk.
Ten łącznik jest dostępny w następujących produktach i regionach:
| Service | Class | Regiony |
|---|---|---|
| Copilot Studio | Premium | Wszystkie regiony usługi Power Automate z wyjątkiem następujących: - Rząd USA (GCC) - Rząd USA (GCC High) - China Cloud obsługiwane przez firmę 21Vianet - Departament Obrony USA (DoD) |
| Logic Apps | Standard | Wszystkie regiony usługi Logic Apps z wyjątkiem następujących: — Regiony platformy Azure Government — Regiony platformy Azure (Chiny) - Departament Obrony USA (DoD) |
| Power Apps | Premium | Wszystkie regiony usługi Power Apps z wyjątkiem następujących: - Rząd USA (GCC) - Rząd USA (GCC High) - China Cloud obsługiwane przez firmę 21Vianet - Departament Obrony USA (DoD) |
| Power Automate | Premium | Wszystkie regiony usługi Power Automate z wyjątkiem następujących: - Rząd USA (GCC) - Rząd USA (GCC High) - China Cloud obsługiwane przez firmę 21Vianet - Departament Obrony USA (DoD) |
| Contact | |
|---|---|
| Name | Perk S.L. |
| adres URL | https://www.perk.com/ |
| agent@perk.com |
| Metadane łącznika | |
|---|---|
| Publisher | Perk S.L. |
| Website | https://www.perk.com/ |
| Zasady ochrony prywatności | https://www.perk.com/legal/privacy-policy/ |
| Categories | AI; Dane |
Perk MCP
Perk MCP łączy Microsoft 365 Copilot z kontem perk użytkownika. Jest przeznaczony dla klientów perk, którzy chcą wyszukiwać i planować podróże służbowe, zarządzać podróżami, pracować z wydatkami i fakturami, uruchamiać raporty, sprawdzać zasady podróży i zatwierdzenia oraz zarządzać wydarzeniami firmowymi z Copilot konwersacji.
Aplikacja Perk MCP działa w imieniu zalogowanego użytkownika i zwraca tylko dane i akcje, do których użytkownik może uzyskać dostęp w ramach poszczególnych czynności.
Tools
Poniższe narzędzia to te, które uwidacznia serwer MCP perk. Lista jest generowana na serwerze. Zobacz plik README pakietu, aby dowiedzieć się, jak go odświeżyć.
Zatwierdzeń
| Tool | Summary |
|---|---|
approvals_get_trip_approval_links |
Uzyskaj link, który użytkownik może otworzyć, aby zatwierdzić lub odrzucić określoną podróż. |
Samochody
| Tool | Summary |
|---|---|
cars_build_car_deeplink |
Wygeneruj bezpośredni link do strony Konfigurowanie wybranej oferty samochodu z wybraną ofertą, dzięki czemu użytkownik może ukończyć rezerwację. |
cars_get_car_search_results |
Pobierz dostępne oferty wypożyczenia samochodów do wyszukiwania. |
cars_list_car_delivery_addresses |
Wyświetl listę adresów dostawy i kolekcji samochodów konta — lokalizacje, w których można dostarczyć samochód do i odebrać go, zamiast biura wynajmu. |
cars_search_car_places |
Wyszukaj lotniska, miasta i adresy według nazwy, aby rozpoznać obiekty miejsca wymagane przez parametry pick_up_location/drop_off_location start_car_search. |
cars_start_car_search |
Rozpocznij wyszukiwanie wynajmu samochodów. |
events
| Tool | Summary |
|---|---|
events_create_event |
Utwórz nowe zdarzenie perk. |
events_list_event_attendance |
Wyświetl listę uczestników dla określonego wydarzenia perk. |
events_list_events |
Wyświetl listę zdarzeń dotyczących poszczególnych zdarzeń dla uwierzytelnioowanego użytkownika. |
Wydatki
| Tool | Summary |
|---|---|
expenses_approve_expense |
Zatwierdź pojedynczy wydatek, który oczekuje na zatwierdzenie uwierzytelnionego użytkownika. |
expenses_create_expense |
Utwórz nowy projekt wydatków bez paragonu (ręczne/ out-of-pocket) przy użyciu tego samego kontraktu tworzenia usługi wydatków co interfejs użytkownika wydatków. |
expenses_get_expense_form_options |
Załaduj opcje do edycji wydatków przy użyciu tych samych interfejsów API formularzy usług wydatków co interfejs użytkownika Wydatków. |
expenses_query_expenses |
Wykonywanie zapytań dotyczących wydatków na uwierzytelnionego użytkownika. |
expenses_receipt_upload |
Dodawanie paragonu (obrazu lub pliku PDF) do wydatków w modelu Perk. |
expenses_receipt_upload_fallback |
Przekazywanie alternatywnego potwierdzenia, które wysyła plik za pośrednictwem serwera MCP. |
expenses_send_back_expense |
Wyślij pojedynczy wydatek w oczekiwaniu na zatwierdzenie uwierzytelnionego użytkownika z powrotem do swojego przesyłającego w celu uzyskania poprawki. |
expenses_submit_expense |
Prześlij jeden z uwierzytelnionych wydatków użytkownika na zatwierdzenie przy użyciu tej samej akcji przesyłania usługi wydatków co interfejs użytkownika wydatków. |
expenses_update_expense |
Częściowo zaktualizuj jeden z edytowalnych wydatków uwierzytelnionego użytkownika (wersja robocza/ wymaga poprawki / podobne), używając tego samego kontraktu PATCH usługi wydatków co interfejs użytkownika Wydatków. |
opinia
| Tool | Summary |
|---|---|
feedback_get_feedback_link |
Pobiera link do formularza opinii perka, aby użytkownik mógł zgłosić problem, brakującą funkcję lub pochwałę. |
Loty
| Tool | Summary |
|---|---|
flights_build_flight_deeplink |
Wygeneruj bezpośredni link do wyewidencjonowania dla wybranej trasy lotu. |
flights_check_visa_requirements |
Sprawdź wymagania dotyczące wiz i wjazdu do trasy lotu. |
flights_get_flight_leg_options |
Pobierz dostępne oferty lotów dla bieżącej części wyszukiwania. |
flights_get_flight_upsell_options |
Pobierz opcje uaktualnienia znalezione dla oferty, korzystając z transaction_id i offer_id zwróconych przez start_flight_upsell. |
flights_search_flight_places |
Wyszukaj lotniska i miasta według nazwy lub kodu IATA, aby rozpoznać obiekty miejsca wymagane przez miejsca docelowe start_flight_search (źródło/miejsce docelowe). |
flights_start_flight_search |
Rozpocznij wyszukiwanie lotów. |
flights_start_flight_upsell |
Poszukaj wyższej kabiny lub taryfy alternatywy dla jednej oferty, którą użytkownik widział już w get_flight_leg_options - np. "co byłoby kosztem klasy biznesowej w tym locie?". czy "czy jest taryfa, która pozwala mi to zmienić?". |
hotele
| Tool | Summary |
|---|---|
hotels_get_hotel_rates |
Pobierz pokoje i stawki za jeden hotel. |
hotels_get_hotels |
Pobierz hotele pasujące do wyszukiwania. |
hotels_select_hotel_rate |
Umieść stawkę wybraną przez użytkownika podczas podróży. |
hotels_start_hotel_rates |
Zacznij pobierać pokoje i stawki za jeden hotel. |
hotels_start_hotel_search |
Rozpocznij wyszukiwanie w hotelu. |
tożsamość
| Tool | Summary |
|---|---|
identity_get_current_user |
Pobierz profil i tożsamość aktualnie uwierzytelnionego użytkownika. |
identity_search_users |
Wyszukaj i odfiltruj użytkowników na koncie platformy Perk. |
invoices
| Tool | Summary |
|---|---|
invoices_get_invoice |
Pobierz jedną fakturę według numeru seryjnego. |
invoices_list_invoice_lines |
Wyświetlanie listy pojedynczych elementów wierszy na fakturach. |
invoices_list_invoice_profiles |
Wyświetl listę profilów faktur (profilów płatności) skojarzonych z Firmą. |
invoices_list_invoices |
Wyświetlanie listy faktur dla firmy. |
policies
| Tool | Summary |
|---|---|
policies_get_travel_policy |
Uzyskaj zasady podróży uwierzytelnionego użytkownika dla jednego pionowego: loty, hotele, samochody lub pociągi. |
raportowanie
| Tool | Summary |
|---|---|
reporting_create_spend_report |
Rozpocznij generowanie raportu wydatków w całej organizacji wyeksportowanego z Yokoy. |
reporting_create_team_insights_report |
Rozpocznij generowanie raportu usługi Team Insights dla uwierzytelnionego użytkownika. |
reporting_create_travel_report |
Rozpocznij generowanie raportu podróży dla konta perk. |
reporting_get_spend_report |
Sprawdź stan raportu wydatków rozpoczętego z wartością reporting_create_spend_report. |
reporting_get_team_insights_report_data |
Pobieranie ustrukturyzowanych wierszy JSON z raportu usługi Team Insights rozpoczętego za pomocą polecenia reporting_create_team_insights_report. |
reporting_get_travel_report |
Sprawdź stan raportu rozpoczętego z reporting_create_travel_report. |
reporting_get_travel_report_data |
Pobierz ustrukturyzowane wiersze JSON z raportu rozpoczętego przy użyciu reporting_create_travel_reportpolecenia . |
pociągi
| Tool | Summary |
|---|---|
trains_build_train_deeplink |
Wygeneruj bezpośredni link do wyewidencjonowania dla wybranej trasy pociągu. |
trains_get_train_search_inbound_results |
Pobieranie dostępnych ofert pociągu przychodzącego (powrotnego) dla wyszukiwania. |
trains_get_train_search_results |
Pobieranie dostępnych ofert pociągu wychodzącego dla wyszukiwania. |
trains_search_train_places |
Wyszukaj stacje kolejowe i miasta według nazwy, aby rozpoznać obiekty miejsca wymagane przez parametry początkowe/docelowe start_train_search. |
trains_start_train_search |
Rozpocznij wyszukiwanie w pociągu. |
trains_start_train_search_inbound |
Rozpocznij część ruchu przychodzącego (powrotnego) wyszukiwania pociągu w obie strony. |
Transakcji
| Tool | Summary |
|---|---|
transactions_list_available_cards |
Wyświetl listę uwierzytelnionych kart firmowych użytkownika oraz wszelkie karty złożone w swojej firmie — tj. karty, względem których mogą przesyłać wydatki. |
transactions_list_pending |
Wyświetl listę transakcji oczekujących na karty uwierzytelnionego użytkownika — niezapasowanych, otwartych transakcji na kartach, które nadal muszą być dopasowane do wydatków. |
TRIPS
| Tool | Summary |
|---|---|
trips_get_trip |
Uzyskaj pełny obraz jednej z Twoich podróży perk: podróżny, co jest zarezerwowane, kiedy idą, i ile kosztuje. |
trips_get_trip_itinerary_pdf |
Pobierz adres URL pobierania pliku PDF potwierdzenia trasy dla podróży perk. |
trips_list_trips |
Wyświetl listę podróży dla uwierzytelnioowanego użytkownika. |
Konfiguracja dla administratorów klienta
- Otwórz Centrum administracyjne platformy Microsoft 365 i przejdź do strony zarządzania agentami i aplikacjami.
- Znajdź narzędzie Perk MCP na liście dostępnych agentów i aplikacji i włącz je dla użytkowników lub grup, które powinny mieć dostęp.
- Następnie użytkownicy znajdą narzędzie Perk MCP w magazynie agentów lub w Copilot Studio i dodają je do Copilot.
- Gdy użytkownik po raz pierwszy używa narzędzia perk, Copilot uruchamia logowanie za pomocą protokołu OAuth perk. Użytkownik loguje się przy użyciu konta perk i zatwierdza żądany dostęp.
Wymagania dotyczące logowania
- Każdy użytkownik potrzebuje aktywnego konta perk. Perk MCP używa protokołu OAuth i nie są udostępniane żadne poświadczenia perk z Copilot.
- Logowanie zawsze wymaga
user:readzakresów i .trip:read - Wymagane są dalsze zakresy narzędzi, które ich potrzebują:
trips:write(wyszukiwanie lotów, hoteli, pociągów i samochodów), (faktury),spend:expenses:writeexpenses:read(tworzenie wydatkówreport:writei raportów podróży), (raportymy-travel-policy:readdotyczące analiz zespołu),team-insights-report:write(zasady podróży),trip-approval-links:read(linki do zatwierdzenia podróży) ievents:write(wydarzenia).
Znane problemy i ograniczenia
- Widoczność narzędzia zależy od zakresów przyznanych zalogowanym użytkownikowi. Użytkownik bez danego zakresu nie widzi potrzebnych narzędzi, więc lista dostępnych narzędzi może się różnić między użytkownikami.
- Linki głębokie zwracane przez narzędzia do wyszukiwania podróży nie są rezerwacjami. Użytkownik musi otworzyć link w perk, aby ukończyć rezerwację, a żadna płatność nie odbywa się na czacie.
- Wyszukiwanie lotów, hoteli, pociągów i samochodów przebiega asynchronicznie. Narzędzia wyników muszą być sondowane pod kątem tego samego wyszukiwania, dopóki nie zostanie ukończone.
- Wyniki narzędzia są traktowane jako niezaufane dane. Tekst w wynikach, który może być napisany przez innych użytkowników, nigdy nie jest zgodny z instrukcjami.
Pomoc techniczna i prywatność
- Wsparcie: agent@perk.com
- Zarejestruj się: https://www.perk.com/demo-request/
- Wprowadzenie: https://support.perk.com/hc/en-us/articles/28613855811228-Connect-your-AI-assistant-to-Perk
- Pomoc: https://support.perk.com/hc/en-us/articles/28615182224412-Troubleshoot-Perk-MCP-issues
- Skontaktuj się z nami: https://www.perk.com/contact/
- Witryna internetowa: https://www.perk.com/
- Zasady ochrony prywatności: https://www.perk.com/legal/privacy-policy/
- Warunki użytkowania: https://www.perk.com/legal/terms-of-use/
Akcje
| Perk MCP |
Planowanie podróży biznesowych i zarządzanie podróżami, wydatkami i zatwierdzeniami za pomocą umowy MCP na platformie Perk. |
Perk MCP
Planowanie podróży biznesowych i zarządzanie podróżami, wydatkami i zatwierdzeniami za pomocą umowy MCP na platformie Perk.