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/
Email 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

  1. Otwórz Centrum administracyjne platformy Microsoft 365 i przejdź do strony zarządzania agentami i aplikacjami.
  2. 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.
  3. Następnie użytkownicy znajdą narzędzie Perk MCP w magazynie agentów lub w Copilot Studio i dodają je do Copilot.
  4. 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:read zakresó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ów report:write i raportów podróży), (raporty my-travel-policy:read dotyczące analiz zespołu), team-insights-report:write (zasady podróży), trip-approval-links:read (linki do zatwierdzenia podróży) i events: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ść

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.