Perk MCP (Vorschau)

Planen Sie Geschäftsreisen und verwalten Sie Reisen, Ausgaben und Genehmigungen mit Perk MCP.

Dieser Connector ist in den folgenden Produkten und Regionen verfügbar:

Service Class Regions
Copilot Studio Premium Alle Power Automate Regionen mit Ausnahme der folgenden:
     - US Government (GCC)
     - US Government (GCC High)
     - China Cloud betrieben von 21Vianet
     - US Department of Defense (DoD)
Logic Apps Standard Alle Logik-Apps-Regionen mit Ausnahme der folgenden Bereiche:
     - Azure Government Regionen
     - Azure China-Regionen
     - US Department of Defense (DoD)
Power Apps Premium Alle Power Apps Regionen mit Ausnahme der folgenden:
     - US Government (GCC)
     - US Government (GCC High)
     - China Cloud betrieben von 21Vianet
     - US Department of Defense (DoD)
Power Automate Premium Alle Power Automate Regionen mit Ausnahme der folgenden:
     - US Government (GCC)
     - US Government (GCC High)
     - China Cloud betrieben von 21Vianet
     - US Department of Defense (DoD)
Kontakt
Name Perk S.L.
URL https://www.perk.com/
Email agent@perk.com
Connectormetadaten
Herausgeber Perk S.L.
Website https://www.perk.com/
Datenschutzrichtlinie https://www.perk.com/legal/privacy-policy/
Categories Künstliche Intelligenz; Daten

Perk MCP

Perk MCP verbindet Microsoft 365 Copilot mit dem Perk-Konto eines Benutzers. Es ist für Perk-Kunden, die Geschäftsreisen suchen und planen möchten, Reisen verwalten, mit Ausgaben und Rechnungen arbeiten, Berichte ausführen, Reiserichtlinien und Genehmigungen überprüfen und Unternehmensereignisse aus einer Copilot Unterhaltung verwalten möchten.

Perk MCP fungiert im Namen des angemeldeten Benutzers und gibt nur Daten und Aktionen zurück, auf die der Benutzer in Perk zugreifen darf.

Tools

Die folgenden Tools sind die Tools, die der Perk MCP-Server verfügbar macht. Die Liste wird vom Server generiert. Informationen zum Aktualisieren finden Sie im Paket README.

Genehmigungen

Tool Summe
approvals_get_trip_approval_links Rufen Sie einen Link ab, den der Benutzer öffnen kann, um eine bestimmte Reise zu genehmigen oder abzulehnen.

autos

Tool Summe
cars_build_car_deeplink Generieren Sie einen Deep-Link "Perk" zur Seite "Konfigurieren" für ein ausgewähltes Autoangebot, mit diesem Angebot, damit der Benutzer die Buchung abschließen kann.
cars_get_car_search_results Holen Sie verfügbare Mietwagenangebote für eine Suche.
cars_list_car_delivery_addresses Auflisten der Autozustellungs- und Sammeladressen des Kontos – Standorte, an denen ein Mietwagen an- und abholen kann, anstelle eines Mietbüros.
cars_search_car_places Suchen Sie nach Flughäfen, Städten und Adressen anhand des Namens, um die von den parametern pick_up_location/drop_off_location start_car_search benötigten Ortsobjekte aufzulösen.
cars_start_car_search Beginnen Sie eine Mietwagensuche.

events

Tool Summe
events_create_event Erstellen Sie ein neues Perk-Ereignis.
events_list_event_attendance Teilnehmer für ein bestimmtes Perk-Ereignis auflisten.
events_list_events Auflisten von Perk-Ereignissen für den authentifizierten Benutzer.

Kosten

Tool Summe
expenses_approve_expense Genehmigen Sie eine einzelne Spesenabrechnung, die auf die Genehmigung des authentifizierten Benutzers wartet.
expenses_create_expense Erstellen Sie eine neue Spesenabrechnung ohne Beleg (manuell/in der Tasche), indem Sie den gleichen Vertrag für den Spesendienst erstellen wie die Ausgabenbenutzeroberfläche.
expenses_get_expense_form_options Laden Sie auswählbare Optionen zum Bearbeiten einer Spesenabrechnung, wobei die gleichen Formularoptionen-APIs wie die Ausgaben-Benutzeroberfläche verwendet werden.
expenses_query_expenses Fragen Sie Ausgaben von "Ausgaben" für den authentifizierten Benutzer ab.
expenses_receipt_upload Fügen Sie eine Bestätigung (Bild oder PDF) zu einer Spesenabrechnung in Perk hinzu.
expenses_receipt_upload_fallback Alternativer Belegupload, der die Datei über den MCP-Server sendet.
expenses_send_back_expense Senden Sie eine einzelne Spesenabrechnung, die auf die Genehmigung des authentifizierten Benutzers zur Überarbeitung zurück an den Übermittlungsteilnehmer wartet.
expenses_submit_expense Übermitteln Sie eine der Ausgaben des authentifizierten Benutzers zur Genehmigung, indem Sie dieselbe Spesendienst-Übermittlungsaktion wie die Ausgaben-Benutzeroberfläche verwenden.
expenses_update_expense Teilweise aktualisieren Sie eine der bearbeitbaren Ausgaben des authentifizierten Benutzers (Entwurf/ Bedarf Überarbeitung / ähnlich), wobei der gleiche Patch-Vertrag für spesendienst wie die Ausgaben-Benutzeroberfläche verwendet wird.

Rückmeldung

Tool Summe
feedback_get_feedback_link Ruft den Link zum Feedbackformular von Perk ab, damit der Benutzer ein Problem, ein fehlendes Feature oder Lob melden kann.

Flüge

Tool Summe
flights_build_flight_deeplink Generieren Sie einen Deep-Link zum Perk-Auschecken für eine ausgewählte Flugroute.
flights_check_visa_requirements Überprüfen Sie Visa- und Einreiseanforderungen für eine Flugroute.
flights_get_flight_leg_options Abrufen verfügbarer Flugangebote für den aktuellen Teil einer Suche.
flights_get_flight_upsell_options Rufen Sie die für ein Angebot gefundenen Upgradeoptionen mithilfe der transaction_id ab, und offer_id von start_flight_upsell zurückgegeben.
flights_search_flight_places Suchen Sie nach Flughäfen und Städten anhand des Namens oder des IATA-Codes, um die von den Zielen start_flight_search (Ursprung/Ziel) erforderlichen Ortsobjekte aufzulösen.
flights_start_flight_search Starten Sie eine Test-Flight-Suche.
flights_start_flight_upsell Suchen Sie nach höheren Kabinen- oder Tarifalternativen für ONE, die der Benutzer bereits in get_flight_leg_options gesehen hat - z. B. "Was würde business class cost on that flight?". oder "Gibt es einen Tarif, der mich ändern kann?".

Hotels

Tool Summe
hotels_get_hotel_rates Holen Sie die Zimmer und Preise für ein Hotel ab.
hotels_get_hotels Rufen Sie die Hotels ab, die einer Suche entsprechen.
hotels_select_hotel_rate Legen Sie die Rate fest, die der Benutzer auf seiner Reise ausgewählt hat.
hotels_start_hotel_rates Beginnen Sie mit dem Abrufen der Zimmer und Preise für ein Hotel.
hotels_start_hotel_search Beginnen Sie eine Hotelsuche.

identity

Tool Summe
identity_get_current_user Rufen Sie das Profil und die Identität des aktuell authentifizierten Benutzers ab.
identity_search_users Suchen und filtern Sie Benutzer in Ihrem Perk-Konto.

invoices

Tool Summe
invoices_get_invoice Rufen Sie eine einzelne Rechnung anhand der Seriennummer ab.
invoices_list_invoice_lines Auflisten einzelner Positionen auf Rechnungen.
invoices_list_invoice_profiles Listen Sie die Rechnungsprofile (Zahlungsprofile) auf, die Mit Ihrem Unternehmen verknüpft sind.
invoices_list_invoices Listen Sie Rechnungen für Ihr Unternehmen auf.

Richtlinien

Tool Summe
policies_get_travel_policy Rufen Sie die Reiserichtlinie des authentifizierten Benutzers für eine einzelne Vertikale ab: Flüge, Hotels, Autos oder Züge.

Berichterstellung

Tool Summe
reporting_create_spend_report Beginnen Sie mit dem Generieren eines organisationsweiten Ausgabenberichts, der aus Yokoy exportiert wurde.
reporting_create_team_insights_report Beginnen Sie mit dem Generieren eines Team Insights-Berichts für den authentifizierten Benutzer.
reporting_create_travel_report Beginnen Sie mit dem Generieren eines Reiseberichts für Ihr Perk-Konto.
reporting_get_spend_report Überprüfen Sie den Status eines Ausgabenberichts, der mit reporting_create_spend_report.
reporting_get_team_insights_report_data Abrufen strukturierter JSON-Zeilen aus einem Team Insights-Bericht, der mit reporting_create_team_insights_report.
reporting_get_travel_report Überprüfen Sie den Status eines Berichts, der mit reporting_create_travel_report.
reporting_get_travel_report_data Abrufen strukturierter JSON-Zeilen aus einem Bericht, der mit reporting_create_travel_report.

Züge

Tool Summe
trains_build_train_deeplink Generieren Sie einen Deep-Link zum Perk-Auschecken für eine ausgewählte Zugroute.
trains_get_train_search_inbound_results Abrufen verfügbarer Eingehender (Rückgabe)-Zugangebote für eine Suche.
trains_get_train_search_results Abrufen verfügbarer Ausgehender Zugangebote für eine Suche.
trains_search_train_places Suchen Sie nach Bahnhöfen und Städten anhand des Namens, um die Ortsobjekte aufzulösen, die von den Ursprungs-/Zielparametern start_train_search benötigt werden.
trains_start_train_search Starten Sie eine Zugsuche.
trains_start_train_search_inbound Starten Sie den hin- und rücksenden Teil einer Hin- und Rückfahrt mit dem Zug.

Transaktionen

Tool Summe
transactions_list_available_cards Listen Sie die eigenen Firmenkarten des authentifizierten Benutzers sowie alle Lodgekarten in ihrem Unternehmen auf , d. h. die Karten, gegen die sie Ausgaben einreichen können.
transactions_list_pending Auflisten der ausstehenden Kartentransaktionen des authentifizierten Benutzers – nicht übereinstimmende, offene Transaktionen auf Karten, die sie besitzen, die immer noch mit einer Spesenübereinstimmung übereinstimmen müssen.

Trips

Tool Summe
trips_get_trip Erhalten Sie das vollständige Bild von einer Ihrer Perk-Reisen: der Reisende, was gebucht ist, wann sie gehen, und wie viel es kostet.
trips_get_trip_itinerary_pdf Rufen Sie die PDF-Download-URL der Reiseroute für eine Reise perk ab.
trips_list_trips Listentrips für den authentifizierten Benutzer auf.

Einrichten für Kundenadministratoren

  1. Öffnen Sie die Microsoft 365 Admin Center, und wechseln Sie zur Verwaltungsseite für Agents und Apps.
  2. Suchen Sie perk MCP in der Liste der verfügbaren Agents und Apps, und aktivieren Sie ihn für die Benutzer oder Gruppen, die Zugriff haben sollen.
  3. Benutzer finden dann Perk MCP im Agent Store oder in Copilot Studio und fügen sie zu ihren Copilot hinzu.
  4. Wenn ein Benutzer zum ersten Mal ein Perk-Tool verwendet, startet Copilot die Perk OAuth-Anmeldung. Der Benutzer meldet sich mit dem Perk-Konto an und genehmigt den angeforderten Zugriff.

Anmeldevoraussetzungen

  • Jeder Benutzer benötigt ein aktives Perk-Konto. Perk MCP verwendet OAuth, und es werden keine Perk-Anmeldeinformationen für Copilot freigegeben.
  • Für die Anmeldung sind immer die user:read Bereiche und trip:read Bereiche erforderlich.
  • Weitere Bereiche werden für tools angefordert, die sie benötigen: trips:write (Reisesuche nach Flügen, Hotels, Züge und Autos), expenses:read (Rechnungen), spend:expenses:write (Erstellen und Verwalten von Ausgaben), report:write (Ausgaben- und Reiseberichte), (Teameinblicke), team-insights-report:write (Reiserichtlinie), my-travel-policy:readtrip-approval-links:read (Reisegenehmigungslinks) und events:write (Veranstaltungen).

Bekannte Probleme und Einschränkungen

  • Die Sichtbarkeit des Tools hängt von den Bereichen ab, die dem angemeldeten Benutzer gewährt werden. Ein Benutzer ohne einen bestimmten Bereich sieht die benötigten Tools nicht, sodass sich die verfügbare Toolliste zwischen Benutzern unterscheiden kann.
  • Deep-Links, die von den Reisesuchtools zurückgegeben werden, sind keine Buchungen. Der Benutzer muss den Link in Perk öffnen, um die Buchung abzuschließen, und es erfolgt keine Zahlung im Chat.
  • Flug-, Hotel-, Zug- und Autosuchen werden asynchron ausgeführt. Die Ergebnistools müssen für dieselbe Suche abgefragt werden, bis sie abgeschlossen ist.
  • Toolergebnisse werden als nicht vertrauenswürdige Daten behandelt. Text in Ergebnissen, die von anderen Benutzern geschrieben werden können, wird nie als Anweisung befolgt.

Support und Datenschutz

Aktionen

Perk MCP

Planen Sie Geschäftsreisen und verwalten Sie Reisen, Ausgaben und Genehmigungen mit Perk MCP.

Perk MCP

Planen Sie Geschäftsreisen und verwalten Sie Reisen, Ausgaben und Genehmigungen mit Perk MCP.