Zum Inhalt springen
PeakPrivacyDocs
AnwendenVerwaltenEinführenSicherheit & DatenschutzEntwickler

Eigenes System über MCP anbinden

Ein CRM, ein Ticketsystem oder eine Datenbank mit MCP-Endpunkt selbst an Peaki anbinden, Werkzeuge freigeben und mit einer Gruppe teilen.

VoraussetzungModeratorFunktion fehlt?
Als Markdown anzeigen

Hat ein System Ihrer Organisation einen MCP-Endpunkt, etwa Ihr CRM, Ihr Ticketsystem oder eine interne Datenbank, binden Sie es selbst an Peaki an. Eine Anfrage bei PeakPrivacy brauchen Sie dafür nicht. Sie brauchen die Adresse des Servers und, je nach Server, ein Zugangstoken oder eine Anmeldung über OAuth. Das erledigt Ihre Administration, also Personen mit der Rolle Moderator.

MCP (Model Context Protocol) ist ein offener Standard, über den ein System Peaki Werkzeuge bereitstellt. Sie legen fest, welche Werkzeuge Peaki nutzen darf, welche davon etwas ändern und welche Gruppe den Server nutzt.

Was Sie vorher klären

  • Adresse: Der Endpunkt ist eine öffentliche https://-Adresse auf dem Standardport, ohne Benutzername oder Passwort darin. Adressen in einem privaten oder lokalen Netz nimmt PeakPrivacy nicht an.
  • Betreiber: Wer betreibt das System hinter dem Endpunkt, und hat Ihre Organisation mit ihm einen Vertrag?
  • Werkzeuge: Welche Werkzeuge braucht der Anwendungsfall, und welche davon legen etwas an, ändern, senden oder löschen?
  • Verbindung: Meldet sich jede Person mit dem eigenen Konto an, oder nutzen alle ein gemeinsames Konto der Organisation? Wer ist für das gemeinsame Konto verantwortlich?
  • Gruppe: Wer soll den Server nutzen? Diese Personen brauchen ausserdem Peaki (Peaki freigeben).

So geht's

Öffnen. Öffnen Sie Arbeit › Tools › MCP-Server und klicken Sie auf Neuer MCP-Server.

Server anlegen. Geben Sie unter Name einen Namen ein, den Ihre Mitarbeitenden wiedererkennen, etwa «CRM». Tragen Sie unter Endpunkt die Adresse ein. Fügen Sie unter Zugriff die Gruppe hinzu, die den Server nutzen soll, und klicken Sie auf MCP-Server erstellen.

Werkzeuge ermitteln. Öffnen Sie den neuen Server und klicken Sie auf Tools ermitteln. PeakPrivacy zeigt alle Werkzeuge, die der Server anbietet. Freigegeben ist damit noch keines.

Werkzeuge einstufen. Wählen Sie für jedes Werkzeug, das der Anwendungsfall braucht, unter Tool-Aktionsklasse Lesen oder Schreiben — Freigabe erforderlich. Ein Werkzeug, das etwas anlegt, ändert, sendet oder löscht, stufen Sie als Schreiben ein, und im Zweifel ebenfalls. Klicken Sie auf Freigegebene Tools speichern.

Verbindung einrichten. Verlangt der Server eine Anmeldung, wählen Sie einen von zwei Wegen. Mit Organisation verbinden hinterlegen Sie ein gemeinsames Konto. Peaki nutzt es für alle, die keine eigene Verbindung haben. Ohne gemeinsames Konto verbindet sich jede Person unter Persönliche Verbindung selbst, mit einem Bearer-Token oder über Mit OAuth verbinden (so geht es für Mitarbeitende).

Testen. Öffnen Sie einen Chat mit Peaki und wählen Sie unter Plus (Dateien und mehr hinzufügen) › Verbundene Apps den Server aus. Geben Sie zuerst einen lesenden Auftrag, etwa «Zeige mir die offenen Tickets der Buchhaltung». Bei einem ändernden Auftrag prüfen Sie die Karte Bestätigung nötig und klicken auf Ablehnen, damit im anderen System nichts entsteht.

Sagen Sie danach der Gruppe, wofür der Server gedacht ist. Ihre Mitarbeitenden wählen ihn in einem Chat unter Verbundene Apps aus, und in Automatisierungen steht er ebenfalls zur Verfügung.

Datenschutz: Was Peaki einem Werkzeug übergibt, verlässt PeakPrivacy und geht an das System hinter dem Endpunkt. Binden Sie nur Server an, deren Betreiber Sie kennen. Über ein gemeinsames Konto der Organisation arbeiten alle mit den Rechten dieses einen Kontos. Geben Sie ihm deshalb nur die Rechte, die der Anwendungsfall braucht.

Gut zu wissen

  • Lesen und Schreiben: Lesende Werkzeuge laufen ohne Rückfrage. Schreibende warten im Chat, bis die Person, die den Auftrag gegeben hat, die Karte freigibt. In Automatisierungen entscheidet deren Freigabe-Modus. Ein schreibendes Werkzeug, dessen Name mit delete, remove, cancel oder einem ähnlichen Verb beginnt, führt eine Automatisierung nie aus. Peaki beschreibt die Aktion dann, statt sie auszuführen.
  • Neue Werkzeuge: Peaki sieht nur die Werkzeuge, die Sie gespeichert haben. Bietet der Server später weitere an, nutzt Peaki sie erst, wenn Sie sie ermitteln und einstufen.
  • Teilen: Teilen Sie den Server mit einer Gruppe. Für die ganze Organisation braucht es den Schalter Öffentliche Freigabe von MCP-Servern, auch für Moderatoren (Die Schalter). Einen Server, den eine andere Person angelegt hat, sehen Sie nur, wenn sie ihn mit Ihnen teilt. Das gilt auch für Moderatoren.
  • Stoppen: Schalten Sie unter Server bearbeiten den Schalter Diesen MCP-Server aktivieren aus, entfernen Sie eine Gruppe aus dem Zugriff oder widerrufen Sie eine Verbindung, stehen die Werkzeuge sofort nicht mehr zur Verfügung. Server löschen entfernt den Server mit seinen freigegebenen Werkzeugen und allen gespeicherten Verbindungen.
  • Persönliche Tool-Server: Unter Einstellungen › Tools › Tool-Server verwalten kann jede Person einen eigenen OpenAPI-Server eintragen. Ihn ruft der Browser auf. Er arbeitet deshalb nur, solange PeakPrivacy offen ist, und nie in Automatisierungen. Für ein System, das mehrere Personen nutzen, nehmen Sie einen MCP-Server.

Wenn es nicht klappt

  • Neuer MCP-Server fehlt. Ihr Konto hat nicht die Rolle Moderator, oder PeakPrivacy hat das Anlegen von MCP-Servern in Ihrem Arbeitsbereich der eigenen Rolle vorbehalten. Fragen Sie bei PeakPrivacy nach (Anfrage stellen).
  • Der Server lässt sich nicht speichern. Der Endpunkt ist keine öffentliche https://-Adresse auf dem Standardport, enthält Zugangsdaten oder zeigt in ein privates Netz. Die Meldung nennt die Regel. Fragen Sie den Betreiber nach einer öffentlichen Adresse.
  • Der Server fehlt unter Verbundene Apps. Prüfen Sie, ob der Server aktiviert ist, ob die Person zur Gruppe unter Zugriff gehört und ob sie Peaki hat.
  • Peaki nutzt ein Werkzeug nicht. Das Werkzeug ist nicht freigegeben. Öffnen Sie den Server, klicken Sie auf Tools ermitteln, stufen Sie das Werkzeug ein und speichern Sie.

Siehe auch

Auf dieser Seite